新版Android Studio导入旧项目报错:找不到com.android.tools.build:aapt2:3.3.0-5013011
解决Android Studio找不到com.android.tools.build:aapt2:3.3.0-5013011的问题
这个问题我之前帮同事排查过,核心原因是AAPT2的依赖仓库配置缺失或者版本兼容问题,给你几个按优先级排序的解决办法,一步步试:
1. 确保项目根目录的build.gradle配置了Google Maven仓库
AAPT2从Android Gradle Plugin 3.2.0开始,就迁移到Google Maven仓库托管了,旧项目可能没配置这个仓库,导致找不到依赖。
打开项目根目录的build.gradle文件,修改buildscript和allprojects里的仓库配置,把google()放在最前面:
buildscript { repositories { google() // 必须放在jcenter()之前,优先从Google仓库拉取 jcenter() } dependencies { // 确保gradle插件版本和AAPT2版本匹配,3.3.0的插件对应这个AAPT2版本 classpath 'com.android.tools.build:gradle:3.3.0' } } allprojects { repositories { google() jcenter() } }
修改后点击Sync Now,重新同步项目。
2. 通过SDK管理器安装对应版本的Build Tools
AAPT2是包含在Android Build Tools里的,如果你本地没有对应版本的Build Tools,也会出现这个错误:
- 打开Android Studio的SDK Manager(Tools -> SDK Manager)
- 切换到SDK Tools标签,勾选右上角的「Show Package Details」
- 找到「Android Build Tools」,展开后选择和gradle插件匹配的版本(gradle 3.3.0对应Build Tools 28.0.3)
- 点击「Apply」安装,完成后重启项目重新构建
3. 手动下载AAPT2文件到指定目录
如果仓库访问有问题(比如网络限制),可以手动下载对应文件放到报错的路径里:
- 你需要下载两个文件:
aapt2-3.3.0-5013011.pom和aapt2-3.3.0-5013011-windows.jar - 在你的SDK目录下创建路径:
extras/google/m2repository/com/android/tools/build/aapt2/3.3.0-5013011/ - 把下载好的两个文件放到这个文件夹里,然后重新同步项目
4. 升级Android Gradle Plugin版本(推荐长期解决方案)
旧项目的gradle插件版本和新版Android Studio兼容性可能不好,升级到更稳定的新版本可以避免这类依赖问题:
- 修改根目录
build.gradle里的classpath为更高版本,比如:classpath 'com.android.tools.build:gradle:4.2.2' - 同时修改
gradle/wrapper/gradle-wrapper.properties里的distributionUrl为对应版本的gradle,比如:distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-all.zip - 同步项目后,新版插件会自动处理AAPT2的依赖,同时兼容新版Android Studio
5. 清理Android Studio缓存
有时候缓存损坏也会导致依赖识别异常:
- 点击Android Studio顶部菜单的File -> Invalidate Caches / Restart
- 选择「Invalidate and Restart」,等待IDE重启后重新构建项目
内容的提问来源于stack exchange,提问作者Dimitri
相关产品推荐
相关产品推荐

