使用build:gradle:3.0.1遇AAPT2错误，如何无需禁用AAPT2解决？

首先得明确：禁用AAPT2只是临时规避问题的手段，官方已经废弃这个选项，而且AAPT2带来了更好的资源编译性能和更严格的错误检查，所以我们应该从根源上解决它的报错问题。下面是具体的排查和解决步骤：

1. 先拿到具体的错误日志 #

默认的"AAPT2 error: check logs for details"太笼统，必须定位到具体问题：

• 在Android Studio的Build面板里，点击右上角的Toggle View切换到文本模式，找到带有Aapt2Exception的日志条目，里面会明确指出是哪个资源文件（比如layout/home.xml、drawable/icon_vector.xml）出了问题，比如标签未闭合、属性拼写错误、引用了不存在的资源等。
• 或者在终端执行构建命令时加上详细日志参数：./gradlew assembleDebug --info，输出的日志里会有完整的错误堆栈，帮你精准定位问题。

2. 排查资源文件的语法/格式问题 #

AAPT2对资源文件的语法检查比旧版AAPT严格得多，常见坑点包括：

• XML文件：标签未正确闭合、属性值缺失引号、自定义属性拼写错误、引用了不存在的资源（比如@drawable/xxx但文件已被删除）。
• 矢量图（VectorDrawable）：路径语法错误、颜色值格式不对（比如少了#符号）、 viewBox参数设置异常。
• 字符串资源：包含未转义的特殊字符（比如&需要写成&）。

3. 更新Android Gradle Plugin到兼容稳定版 #

你当前使用的3.0.1版本的AGP（Android Gradle Plugin），AAPT2模块存在一些已知bug，建议升级到同大版本的补丁版（比如3.0.2），或者更高的兼容稳定版（比如3.2.1，注意AGP版本要和Gradle版本匹配：AGP 3.2.x对应Gradle 4.6+）。修改项目根目录下的build.gradle文件：

buildscript {
    dependencies {
        classpath 'com.android.tools.build:gradle:3.2.1' // 替换为合适的稳定版本
    }
}

4. 清理缓存并重建项目 #

缓存文件损坏也可能导致AAPT2报错，执行以下操作：

• 在Android Studio中点击File > Invalidate Caches... > Invalidate and Restart，彻底清理缓存并重启IDE。
• 或者在终端执行：./gradlew clean，然后重新执行构建命令。

5. 检查第三方依赖的兼容性 #

部分老旧的第三方依赖库可能包含不符合AAPT2规范的资源文件，引发冲突：

• 检查依赖库版本，升级到最新的稳定版。
• 使用./gradlew app:dependencies命令查看依赖树，排查是否有重复或冲突的依赖，必要时用exclude语句排除冲突模块。

6. 匹配兼容的SDK Build Tools版本 #

确保你的SDK Build Tools版本和AGP版本兼容，比如AGP 3.0.x对应Build Tools 26.0.2+。可以在SDK Manager中更新到兼容的最新版本，然后在模块的build.gradle中指定：

android {
    buildToolsVersion "28.0.3" // 替换为与AGP兼容的版本
}

内容的提问来源于stack exchange，提问作者M N Dhanani