去年接手了一个 2019 年停更的组件化 Android 项目,AGP 3.4,十几个 module,依赖树里还残留着 jcenter 时代的坐标。新 Android Studio 打开直接无法同步。我花了将近两周,靠 Trae 配合 Android Studio 把它从 AGP 3.4 拉到了 8.x,过程中踩的坑足够写一篇避雷指南。
这篇文章不聊“Trae 有多强”,只聊一件事:用 AI 工具处理 Android 老项目时,哪些边界必须守住,哪些顺序不能颠倒,哪些“让 AI 自动改”的冲动必须压住。
一、先认清一个事实:Trae 跑不了 Android 项目,至少现在跑不了
这是所有后续讨论的前提。Trae 目前无法直接编译、安装、运行一个原生 Android 项目,它没有 Android Studio 那套 SDK 管理、Gradle 图形化同步和调试器集成。你最终仍然需要 Android Studio(或至少命令行 Gradle + adb)来完成构建和验证。
所以正确的角色定位是:
- Android Studio:负责运行、调试、验证、处理轻微问题。
- Trae:负责读构建日志、批量改文件、跨模块修改、生成 diff、理解工程语义。
Trae 的价值不在于“替代 AS”,而在于它能在你被 140KB 的构建日志淹没时,帮你定位到那 22 个 failure 之间的因果链。但验证的最后一公里必须交给真正的 Android 工具链,这一点如果搞反了,后面全是无用功。
二、环境先于代码:Java 版本和 Maven 镜像必须在让 AI 动手之前解决
老项目最常见的死亡开局是:你打开 Trae,贴进一段代码,让它“帮我升级到 AGP 8”,然后它改了一堆 build.gradle,你发现连 gradlew 都跑不起来——因为 Java 版本不对。
新版 AGP 要求 JRE 17,但很多老开发机本地默认还是 Java 8。Trae 本身在 Java 8 环境下运行就会报 Java 相关问题。解决办法是在 gradle.properties 里显式指定 Java home:
properties
org.gradle.java.home=/path/to/Android Studio/jbr
另一个几乎绕不开的是 Maven 仓库。老项目里 jcenter() 早已停服,google() 和 mavenCentral() 在国内网络环境下经常超时。在让 Trae 开始“改代码”之前,先把 buildscript.repositories 和 allprojects.repositories 换成阿里云镜像,保留官方仓库作为备选。这一步不做,Trae 会反复在依赖解析上打转,而你误以为是它“能力不行”。
原则:构建环境不通,不让 AI 碰代码。 先手动把 ./gradlew help 跑通,再进入 AI 协作阶段。
三、Rules 是 Trae 处理老项目的“安全绳”,不是可选项
Trae 的项目规则放在项目根目录的 .trae/rules/ 下,任何 Markdown 文件都会被读取。对于 Android 老项目,这几乎是唯一能让 AI 不“自由发挥”的机制。
一个最低限度的 project_rules.md 应该把下面这些老项目最容易踩的约束写死:
markdown
---
alwaysApply: true
---
## 项目约束
- 这是多模块 Android 项目,module 之间通过 api/implementation 区分暴露边界。修改依赖前先确认当前 module 的依赖声明方式。
- 不要将 compile 替换为 implementation,老 module 可能存在 AAR 传递依赖,替换会导致编译期找不到符号。
- AndroidX 迁移期间,禁止混用 support 库和 androidx 库。
- 修改 build.gradle 前先输出 diff,经我确认后再写入文件。
- targetSdk 升级到 31+ 时,所有带 intent-filter 的组件必须检查 android:exported。
alwaysApply: true 让规则在所有对话中生效,不需要每次手动 @。更细粒度的规则可以用 globs 限定到 **/build.gradle 或 AndroidManifest.xml,在 AI 触达这些高危文件时自动收紧行为。
还有一条实操建议:在 Trae 的模型配置里把 agent.autoApplyPatch 设为 false。老项目排障要的是可回滚、可复现,让 AI 先给 diff 再决定是否落盘,比它一口气改十几个文件然后你找不到回滚点要安全得多。
四、构建错误要“分层拆”,不能让 AI 一次性吞下所有报错
老项目的构建失败从来不是单一问题,而是错误之间互相“咬”:Facebook SDK 用 latest.release 拉到了新版本,把 Kotlin stdlib 顶上去,然后 Manifest 合并、资源链接、native so 重复全跟着炸。
如果你把一整段 140KB 的日志丢给 Trae 说“帮我修到能编译”,大概率得到的是面多了加水、水多了加面的循环。正确的做法是按错误类型分层,一层一层交给 AI:
第一层:依赖冲突 / Duplicate class。 先让 Trae 分析依赖树(./gradlew :app:dependencies 的输出),定位重复来源。常见手段是 exclude 和 resolutionStrategy.force,多模块项目在根 build.gradle 统一收口。
第二层:AGP / Gradle 版本迁移。 这一层 Trae 的 Builder 模式有优势——它会解析 build.gradle.kts 的 Kotlin DSL AST,而不是做字符串替换。但前提是你已经在 Rules 里声明了目标 AGP 版本和 Gradle wrapper 版本,否则它可能选一个“能编译但过时”的组合。
第三层:Manifest 与 targetSdk 行为变更。 Android 12+ 强制要求带 intent-filter 的组件显式声明 android:exported。这一层适合让 Trae 扫描整个 AndroidManifest.xml(包括合并后的 manifest)批量补属性,但批量修改后必须在 Android Studio 里跑一次 lint,因为 AI 可能把内部组件的 exported 误设为 true。
第四层:R8 / ProGuard。 好消息是 R8 的配置语言与 ProGuard 兼容,绝大多数老规则不需要改文件。但 AGP 8 默认开启 full mode,优化更激进,可能需要补 keep 规则。让 Trae 对照崩溃堆栈补 proguard-rules.pro 是合理的用法,但最终的 release 包必须在真机上做一轮冒烟,不能只看编译通过。
五、AndroidX 迁移:AI 能改 import,但改不了“混用”带来的隐性冲突
老项目从 support 库迁 AndroidX,Trae 能高效完成的一件事是批量替换 import 和 build.gradle 中的依赖坐标。但有一个坑它不会自动帮你识别:如果项目里某个第三方 AAR 仍然依赖旧的 support 库,而你的主工程已经迁到 AndroidX,两者会在运行时或编译期产生 clash。
处理这类问题的顺序应该是:先用 Trae 扫描所有 module 和 AAR 依赖,列出仍然引用 com.android.support 的坐标;然后逐个确认是否有 AndroidX 替代版本;对无法替换的 AAR,用 jetifier 或 exclude 做过渡。不要让 Trae 在“迁移 AndroidX”的口号下无差别替换所有 android.support 字符串,它可能把某个不可迁移的第三方库的内部引用也改掉。
六、多模块老项目的终极纪律:AI 改结构,你守边界
组件化老项目最脆弱的地方是 module 之间的依赖边界。Trae 的 Builder 模式会把整个工程当作一棵可遍历、可修改的 AST,这意味着它有权限改到任何一个 module 的 build.gradle。
我的建议是:在 Rules 里把 module 的暴露规则写死,然后每次让 Trae 做跨模块修改时,要求它输出一份“变更影响范围清单” ——改了哪些文件、涉及哪些 module、有没有改动 api 暴露的符号。这份清单不是形式主义,它是你在 AI 高速修改中保持对工程结构控制感的唯一手段。
另一个实用的做法来自客户端团队的工程化经验:把 Trae 的 Agent 模式接入命令行和 CI 的校验闸门。./gradlew assembleDebug 的输出可以直接作为 Agent 工作循环的反馈,但 pre-commit 和 CI 里的 lint / 单测 / 编译检查不能被跳过。AI 产出变更,工具链产出证据,两者缺一不可。
七、一张我总结的“安全协作顺序”清单
把上面所有点收束成一个可执行的顺序:
- 环境层:Java home → Maven 镜像 →
./gradlew help通过。 - 规则层:
.trae/rules/project_rules.md写好 module 边界、依赖声明方式、高危文件 diff 要求;autoApplyPatch: false。 - 依赖层:让 Trae 读依赖树,逐个化解 Duplicate class,不做“一次性全修”。
- 构建层:AGP / Gradle 版本迁移交给 Builder 模式,但目标版本在 Rules 里锁死。
- 行为层:targetSdk 升级时,Trae 批量补
exported,Android Studio 跑 lint 复核。 - 产物层:release 构建和真机冒烟必须回到 Android 工具链,Trae 的“编译通过”不能替代实际运行。
Trae 在处理 Android 老项目时的真正价值,是把你从“读不懂的构建日志”和“跨十几个 module 的重复修改”里解放出来,让你把精力集中在判断“哪些能自动改、哪些必须人工守”上。它不是自动驾驶,它是一个读得懂工程语义的副驾驶。 把边界守住了,它是老项目迁移里效率最高的工具;边界丢了,它也能以同样的速度把技术债务埋得更深。