android-gradle-build-logic

Android Gradle 构建逻辑

适用场景

• 当请求涉及以下内容时使用此技能：Android Gradle 插件配置、修复 Android 模块的构建逻辑、Android 仓库的版本目录。
• 主要目标：使用 Gradle、版本目录、插件、约定模式和工具链兼容性，规划 Android 构建逻辑。
• 范围扩大时交接给以下技能：
• android-modernization-upgrade
• android-ci-cd-release-playstore

工作流

1. 将请求对应到当前 Android 技术栈、模块边界和最低受支持 API 级别。
2. 检查现有实现中的隐含假设、重复辅助程序和过时模式。
3. 采用能提升正确性、可读性和长期可维护性的最小改动。
4. 根据相关示例应用路径和仓库基准验证结果。
5. 只有在核心基础稳定后，才将相邻工作交接给下一个专门技能。

防护措施

• 当官方 Android 和 Kotlin 指南与自定义本地约定冲突时，优先遵循官方指南。
• 保持公共 API 简洁明确；避免使用会掩盖 Android 生命周期开销的巧妙抽象。
• 除非请求明确要求同时处理，否则不要将架构清理与产品行为变更混在一起。
• 记录会影响旧模块或生成代码的任何兼容性限制。

反模式

• 在各模块中随意散布辅助程序，却没有明确的归属边界。
• 在纯领域层或数据层中引入特定框架的代码。
• 只需修改一项契约，却重构所有相邻文件。
• 暗示迁移说明，而不是明确写出。

示例

正常路径

• 场景：从干净检出状态使用版本目录构建 Compose 示例。
• 命令：cd examples/orbittasks-compose && ./gradlew :app:assembleDebug

边缘情况

• 场景：在 XML fixture 中验证共享仓库和插件管理。
• 命令：cd examples/orbittasks-xml && ./gradlew :app:assembleDebug

故障恢复

• 场景：根据现代化和 CI 技能基准测试构建逻辑触发的准确性。
• 命令：python3 scripts/eval_triggers.py --skill android-gradle-build-logic

完成检查清单

• 实现路径明确且精简，并对应正确的 Android 范围。
• 已运行或更新相关示例命令和基准提示词。
• 当请求跨越技能边界时，已记录与相邻技能的交接事项。
• 官方参考资料涵盖所选模式以及主要迁移或故障排除路径。

官方参考资料

• https://developer.android.com/build
• https://developer.android.com/build/releases/gradle-plugin
• https://developer.android.com/build/migrate-to-built-in-kotlin
• https://docs.gradle.org/current/userguide/userguide.html