Skip to content

应用资源管理 (App Assets)

Flu CLI 提供了强大的应用资源管理功能,帮助开发者在创建项目时快速配置应用图标 (App Icon) 和启动图 (Splash Screen)。该功能集成了业内成熟的 flutter_launcher_iconsflutter_native_splash 方案,通过可视化的向导操作,自动完成繁琐的配置和生成工作。

✨ 核心特性

  • 一站式配置:在创建项目流程中直接完成,无需后续手动修改配置。
  • 自动生成:自动修改 pubspec.yaml 添加依赖,自动运行生成命令。
  • 图标生成:支持从单张高清图片(推荐 1024x1024)自动生成 iOS、Android、Web 等全平台图标。
  • 启动图定制
    • 纯色模式:Logo + 自定义背景色。
    • 图片模式:Logo + 自定义背景图。
    • 暗黑模式:默认支持暗黑模式适配(自动使用相应配置)。
  • 进度反馈:提供清晰的进度条,实时展示资源生成状态。

🚀 如何使用

1. 启动创建流程

使用 Flu: Create New Project 命令或右键菜单启动创建向导。

2. 进入资源配置

在完成了模板选择、项目命名等基础步骤后,向导会询问:

"是否自定义应用外观?"

  • 选择 $(paintcan) 自定义外观 进入配置流程。
  • 选择 快速创建 则跳过此步骤,使用 Flutter 默认图标。

3. 配置应用图标 (App Icon)

向导提示:"是否设置应用图标?"

  1. 选择 $(file-media) 选择图标图片
  2. 在文件选择器中选中您的图标文件(建议使用 .png 格式,尺寸 1024x1024)。

注意:CLI 会自动将该图片复制到项目的 assets/icon/ 目录下,并配置到 pubspec.yaml 中。

4. 配置启动图 (Splash Screen)

向导提示:"是否设置启动图?"

  1. 选择 $(rocket) 设置启动图
  2. 选择模式
    • $(symbol-color) 纯色背景 + Logo:简洁现代风格。
    • $(file-media) 背景图片 + Logo:更具品牌个性。
  3. 上传 Logo:选择一张透明背景的 Logo 图片(.png)。
  4. 设置背景
    • 如果选择了纯色模式:输入 16 进制颜色代码(如 #FFFFFF, #121212)。
    • 如果选择了图片模式:选择一张背景图片(建议适配手机屏幕比例)。

5. 自动生成

完成所有配置后,CLI 将会自动执行以下操作:

  1. 创建项目骨架。
  2. 修改 pubspec.yaml,添加 flutter_launcher_iconsflutter_native_splash 依赖。
  3. 将选中的资源文件复制到 assets/ 目录。
  4. 执行 flutter pub get
  5. 执行 dart run flutter_launcher_icons 生成图标。
  6. 执行 dart run flutter_native_splash:create 生成启动图。

您只需等待右下角的进度条完成即可!

📂 生成结果预览

项目创建完成后,您可以查看:

  • pubspec.yaml

    yaml
    dev_dependencies:
      flutter_launcher_icons: ^0.13.1
      flutter_native_splash: ^2.3.10
    
    flutter_launcher_icons:
      android: true
      ios: true
      image_path: "assets/icon/app_icon.png"
      # ...
    
    flutter_native_splash:
      color: "#FFFFFF"
      image: "assets/splash/logo.png"
      # ...
  • assets/ 目录

    assets/
    ├── icon/
    │   └── app_icon.png
    └── splash/
        ├── logo.png
        └── background.png (如果选择了图片模式)

❓ 常见问题

Q: 我可以在项目创建后再次运行此功能吗? A: 目前该功能仅集成在 "创建新项目" 的向导中。对于已有项目,建议直接使用 flu-cli 命令行工具或手动配置。

Q: 生成过程卡住了怎么办? A: 资源生成依赖于 flutter pub get,请确保您的网络环境可以正常访问 pub.dev。

Q: 支持哪些图片格式? A: 推荐使用 .png 格式,以确保透明通道和最佳兼容性。

Released under the MIT License.