| name | fkit-native |
| description | 管理 FlutterKit 多端运行时资源、应用图标、原生启动页、Android/iOS/Web/桌面端配置和发布构建。用户要求生成图标、启动页、FlutterGen 资源、同步原生底座、排查原生缓存或执行多端打包时使用。 |
FKit Native
必读资料
先阅读 AGENTS.md、docs/flutter-kit/扩展/assets.md、根目录 README.md 的构建章节,以及当前任务对应的 YAML 和原生平台文件。涉及生成器行为时查阅当前依赖版本的官方文档,不凭记忆填写配置。
资源边界
assets/image/、assets/icon/、assets/json/ 是运行时资源,由 FlutterGen 生成类型安全访问器。
assets/dev/ 只保存图标和启动页生成源图,不注册为运行时资源。
flutter_launcher_icons.yaml 管理多端桌面图标。
flutter_native_splash.yaml 管理 Android、iOS 与 Web 原生启动页。
工作流
- 明确目标平台和目标效果,检查源图尺寸、画布、Alpha、透明边距及安全区。
- 修改源图或 YAML,不直接编辑将被生成器覆盖的输出文件。
- 只运行任务需要的生成命令,并审查各平台生成差异。
- Android 12 启动图遵守中心安全区;iOS 图标使用独立安全边距源图并移除 Alpha。
- 区分原生 LaunchScreen 与 Flutter 首帧,避免 Dart 页面重复展示第二个启动 Logo。
- 原生效果未更新时先诊断 App、Simulator/Xcode/Gradle 缓存,不反复改变正确配置。
- 按目标平台运行构建或最小启动验证,保留混淆符号文件和发布配置。
常用命令
- 资源代码:
dart run build_runner build --delete-conflicting-outputs
- 图标:
dart run flutter_launcher_icons
- 启动页:
dart run flutter_native_splash:create
- 质量检查:
flutter analyze、flutter test、git diff --check
验证
检查配置解析、源图尺寸、生成文件、Git 差异和目标平台实际显示。生成器产生无关格式变化时单独识别,不覆盖用户的原生工程修改。