升级Android Gradle Plugin 7.0的适配改动检测及Android Studio工具咨询
AGP 7.0 升级前适配改动预检测方案
完全可以在正式升级前扫描所有需要适配的改动,Android Studio也提供了官方工具支持检测:
1. 官方AGP升级助手(最推荐方案)
Android Studio Arctic Fox | 2020.3.1 及更高版本自带AGP升级助手,无需实际执行升级即可预览所有适配改动:
- 打开路径:顶部菜单栏
Tools > AGP Upgrade Assistant - 在工具面板中选择目标升级版本为7.0,工具会自动全量扫描当前项目的构建配置、自定义Gradle插件、业务代码中依赖AGP废弃API的部分,逐条例出需要修改的适配点
- 绝大多数通用适配项支持一键自动修改,你也可以只预览改动不应用,提前评估升级工作量
2. 手动预检测方案
如果暂时不想用升级助手,也可以通过以下方式提前排查适配点:
- 开启废弃API警告:在项目根目录的
gradle.properties中添加配置android.debug.obsoleteApi=true,执行./gradlew assembleDebug构建,所有调用了AGP 7.0废弃API的逻辑都会以警告形式输出,这些就是升级后会报错的内容 - 提前验证核心强制要求:
- 升级本地JDK到11及以上,AGP 7.0强制要求JDK 11作为编译环境
- 检查所有构建脚本中废弃的配置写法,比如旧版
compile依赖配置、applicationIdSuffix之外的废弃variant配置 - 排查自定义Transform逻辑,AGP 7.0开始废弃旧Transform API,所有用到该能力的自定义插件都需要适配新的Transform API
- 提前升级三方依赖到适配AGP 7.0的稳定版本,避免出现类找不到、配置冲突的问题
- 可以拉取独立的测试分支,仅修改AGP版本号到7.0执行Gradle同步,IDE会直接标出所有配置文件的错误项,不会影响主分支代码
内容的提问来源于stack exchange,提问作者amodkanthe
相关产品推荐
相关产品推荐

