---
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 原生启动页。

## 工作流

1. 明确目标平台和目标效果，检查源图尺寸、画布、Alpha、透明边距及安全区。
2. 修改源图或 YAML，不直接编辑将被生成器覆盖的输出文件。
3. 只运行任务需要的生成命令，并审查各平台生成差异。
4. Android 12 启动图遵守中心安全区；iOS 图标使用独立安全边距源图并移除 Alpha。
5. 区分原生 LaunchScreen 与 Flutter 首帧，避免 Dart 页面重复展示第二个启动 Logo。
6. 原生效果未更新时先诊断 App、Simulator/Xcode/Gradle 缓存，不反复改变正确配置。
7. 按目标平台运行构建或最小启动验证，保留混淆符号文件和发布配置。

## 常用命令

- 资源代码：`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 差异和目标平台实际显示。生成器产生无关格式变化时单独识别，不覆盖用户的原生工程修改。