用途:指导 Android 原生应用开发与 UI 设计,涵盖 Material Design 3、Kotlin/Compose 开发、项目配置、无障碍与构建排错。
主要能力:
- 项目场景评估:区分空目录、含 Gradle Wrapper、Android Studio 项目、不完整项目,并给出对应初始化或补全方式;强调写业务逻辑前先确保 ./gradlew assembleDebug 成功,缺少 gradle.properties 时先创建并配置 AndroidX。
- 项目配置:gradle.properties 需 android.useAndroidX=true、android.enableJetifier=true,可开启并行构建与官方 Kotlin 代码风格,按项目规模调整 JVM 内存;依赖用 Compose BOM 统一版本,并声明 activity-compose、lifecycle-viewmodel-compose 等。
- 构建变体与产品风味:通过 flavorDimensions 与 productFlavors 定义 dev/staging/prod,配置 applicationIdSuffix、versionNameSuffix、buildConfigField、resValue;buildTypes 区分 debug/release;变体命名如 devDebug、prodRelease;常用命令包括 ./gradlew assembleDevDebug、./gradlew installProdRelease 等。AGP 8.0 起需显式开启 buildConfig。
- Kotlin 规范:命名约定、空安全(避免 !!,用安全调用与默认值)、异常处理(用 Result 包装并在 ViewModel 统一处理)、协程线程选择(UI 用 Main、网络与文件 IO 用 IO、计算密集用 Default)、可见性、lateinit 与 lambda return 陷阱、服务端响应字段应可空、生命周期观察者成对增删、日志分级。
- Jetpack Compose:@Composable 上下文规则、LaunchedEffect 处理挂起、remember/mutableStateOf/derivedStateOf 状态管理、避免在 Composable 中直接创建 ViewModel。
- 资源与图标:多分辨率 mipmap 尺寸、自适应图标、资源命名前缀,避免使用 Android 保留名(如 background、icon、view 等),否则可能构建报错或资源冲突。
- 构建错误诊断:常见错误关键字与修复方向,建议先读完整错误、检查最近改动、执行 ./gradlew clean assembleDebug、用 :app:dependencies 排查冲突、必要时 --refresh-dependencies。
- Material Design 3:审查 Android UI 文件是否符合 M3 指南与最佳实践。
使用方式:按资料中的目录结构、配置片段与 Gradle 命令执行;命令保持原样。
适用场景:Android 原生项目初始化、Gradle 与变体配置、Kotlin/Compose 编码规范落地、资源命名与构建排错。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;部分章节(如 M3 核心原则)在资料中未完整展开。