应用资源管理 (App Assets)
Flu CLI 提供了强大的应用资源管理功能,帮助开发者在创建项目时快速配置应用图标 (App Icon) 和启动图 (Splash Screen)。该功能集成了业内成熟的 flutter_launcher_icons 和 flutter_native_splash 方案,通过可视化的向导操作,自动完成繁琐的配置和生成工作。
✨ 核心特性
- 一站式配置:在创建项目流程中直接完成,无需后续手动修改配置。
- 自动生成:自动修改
pubspec.yaml添加依赖,自动运行生成命令。 - 图标生成:支持从单张高清图片(推荐 1024x1024)自动生成 iOS、Android、Web 等全平台图标。
- 启动图定制:
- 纯色模式:Logo + 自定义背景色。
- 图片模式:Logo + 自定义背景图。
- 暗黑模式:默认支持暗黑模式适配(自动使用相应配置)。
- 进度反馈:提供清晰的进度条,实时展示资源生成状态。
🚀 如何使用
1. 启动创建流程
使用 Flu: Create New Project 命令或右键菜单启动创建向导。
2. 进入资源配置
在完成了模板选择、项目命名等基础步骤后,向导会询问:
"是否自定义应用外观?"
- 选择
$(paintcan) 自定义外观进入配置流程。 - 选择
快速创建则跳过此步骤,使用 Flutter 默认图标。
3. 配置应用图标 (App Icon)
向导提示:"是否设置应用图标?"
- 选择
$(file-media) 选择图标图片。 - 在文件选择器中选中您的图标文件(建议使用
.png格式,尺寸 1024x1024)。
注意:CLI 会自动将该图片复制到项目的
assets/icon/目录下,并配置到pubspec.yaml中。
4. 配置启动图 (Splash Screen)
向导提示:"是否设置启动图?"
- 选择
$(rocket) 设置启动图。 - 选择模式:
$(symbol-color) 纯色背景 + Logo:简洁现代风格。$(file-media) 背景图片 + Logo:更具品牌个性。
- 上传 Logo:选择一张透明背景的 Logo 图片(
.png)。 - 设置背景:
- 如果选择了纯色模式:输入 16 进制颜色代码(如
#FFFFFF,#121212)。 - 如果选择了图片模式:选择一张背景图片(建议适配手机屏幕比例)。
- 如果选择了纯色模式:输入 16 进制颜色代码(如
5. 自动生成
完成所有配置后,CLI 将会自动执行以下操作:
- 创建项目骨架。
- 修改
pubspec.yaml,添加flutter_launcher_icons和flutter_native_splash依赖。 - 将选中的资源文件复制到
assets/目录。 - 执行
flutter pub get。 - 执行
dart run flutter_launcher_icons生成图标。 - 执行
dart run flutter_native_splash:create生成启动图。
您只需等待右下角的进度条完成即可!
📂 生成结果预览
项目创建完成后,您可以查看:
pubspec.yaml:yamldev_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 格式,以确保透明通道和最佳兼容性。