Android 开发套件

写 Android 代码时反复踩的坑

一个中型 Android 项目的技术债通常集中在几个具体位置：XML 布局和 Compose 混用，迁移卡在中间态，没人敢一次性改完；Retrofit 回调和 RxJava 链式调用散落在各仓库，并发控制靠 review 时的口头约定，换成协程时没人说得清哪个模块还在用阻塞式写法；Gradle 的构建逻辑改一次坏一次，build.gradle 里的逻辑没人敢动；测试只覆盖了 Activity 启动，真正容易回归的 UI 状态和网络失败分支反而没有覆盖。

这套技能集针对的就是这些可定位、可拆解的问题，而不是泛泛的"提升效率"。

技能如何工作

技能按主题分成七组，每组对应一个相对独立的工作面：

• UI 开发：Compose 导航与组件搭建、Coil 图片加载、无障碍访问检查。
• 并发与网络：Kotlin 协程用法、Retrofit 请求组织、并发场景下的阻塞与死锁排查。
• 构建工具：Gradle 构建逻辑梳理与配置调整。
• 架构设计：数据层结构、Android 架构模式选型、ViewModel 边界划分。
• 测试与自动化：Android 测试编写、模拟器自动化操作。
• 性能优化：Compose 重组与性能审计、Gradle 构建性能问题定位。
• 代码迁移：XML 转 Compose 的逐屏迁移、RxJava 转协程的流式改写。

使用时按任务挑技能，而不是整套拉进来。做 UI 迁移就调用 Compose 相关技能，构建变慢就调用 Gradle 性能相关技能，每个技能处理自己那一层的代码结构和约束。

适用边界

迁移类技能依赖项目里已经存在的可读代码，如果源码本身结构混乱，它会给出方向但不会替你做架构决策。性能审计类技能针对的是已有实现的可测量问题，不会凭空推断瓶颈，需要配合 Profiler 输出一起看。架构设计相关技能给出的是模式选择和边界划分建议，最终取舍仍由你判断。

另外，这套技能集面向的是 Kotlin 为主的现代 Android 项目，Java 老项目、未启用 Compose 的纯 View 项目在使用时需要先评估改造成本。