Build Android App 技能面向原生 Android 应用的构建、扩展与修复任务,要求交付满足需求的最小功能实现,优先沿用现有项目模式而非新建结构,优先使用平台 API 而非额外依赖,优先真实集成而非伪造占位。
用途:在 Codex 等环境中处理 Kotlin、Jetpack Compose、Android SDK、Material 3、Room、网络、权限和 Gradle 相关开发工作。
主要能力与工作流程:
- 编辑前先阅读仓库说明并检查 Android 结构,包括 settings.gradle*、根 build.gradle*、gradle/libs.versions.toml、app/build.gradle*、AndroidManifest.xml、MainActivity,以及已有的 ui/、theme/、network/、data/、repository/、viewmodel/、service/、test 包。项目形态不清晰时运行 scripts/inspect_android_project.py。
- 保持范围紧凑:简单工具应用通常一个屏幕;仅当状态有行为时才用一个 ViewModel;除非需求涉及多个目的地,否则不引入导航图。
- 采用单向数据流:状态存于 ViewModel 或仓库支撑的存储,以只读 StateFlow 暴露,用 collectAsStateWithLifecycle() 收集,状态向下传递、事件以 lambda 向上传递。
- 构建真实平台行为:涉及 GPS、相机、蓝牙、通知、传感器、Spotify、Fitbit、SQLite 或远程 API 时,须实现实际的 SDK/API 路径,或明确报告缺失的前置条件,不得模拟遥测或凭据。
- 用覆盖改动代码的最小命令验证,优先使用仓库文档中的命令(在 android/ 目录运行),典型回退命令包括 ./gradlew testDebugUnitTest(运行 Robolectric 单元测试与 Roborazzi 对比检查)、./gradlew recordRoborazziDebug(录制新的截图基线)、./gradlew assembleDebug、./gradlew :app:compileDebugKotlin。
参考资料路由:Compose UI、主题、edge-to-edge、无障碍与应用元数据参考 references/compose-material3.md;ViewModel、仓库、Flow 与 UDF 模式参考 references/state-architecture.md;本地持久化参考 references/room.md;HTTP 客户端、API 密钥、危险权限、硬件或后台平台集成参考 references/network-permissions.md;添加测试或报告验证前参考 references/testing-validation.md。
默认约定:除非现有项目基于 XML/View,否则使用 Kotlin 2.x+ 与 Jetpack Compose;使用 Compose Gradle 插件(Kotlin 2.0.0+ 为 org.jetbrains.kotlin.plugin.compose)配置 Compose 编译器,而非已弃用的 composeOptions;使用 MaterialTheme 中的 Material 3 令牌,将项目颜色、排版和形状放入主题文件;新应用在 MainActivity 中启用 edge-to-edge(Android 15/API 35 起默认强制,Android 16/API 36 起无法退出),并用 WindowInsets.safeDrawing 或等效安全区内边距处理系统栏;保持命名空间与现有包一致,新应用使用唯一 applicationId,未经要求不更改包目录;已有版本目录时使用 Gradle 版本目录,在 Kotlin DSL 中将别名从 kebab case 转为点表示法;仅当平台 API 或现有依赖不足时添加依赖,并保持锁文件/目录一致;绝不硬编码密钥、API 密钥、私有 URL、密钥库或本机值。
适用场景:需要在现有或新建 Android 工程中实现界面、状态管理、本地持久化、网络请求、权限处理、硬件集成与测试验证的开发任务。
限制:资料未提供具体收费、价格、平台支持范围与效果数据;实际使用需依赖 Android 工程环境、Gradle 与相关 SDK,功能实现受项目现有结构与权限/硬件前置条件约束。