aapt2（Android Asset Packaging Tool 2）是Android构建体系中负责处理资源的工具，它将传统的aapt重构为编译与链接两个阶段，能够提升增量构建效率并给出更清晰的错误信息。下面我们直接看它的基本工作方式。
aapt2的编译阶段
编译阶段会把独立的资源文件，例如layout/main_activity.xml、values/strings.xml等，分别编译成扩展名为.flat的二进制中间文件。每个文件独立编译，方便增量更新。
假设项目资源目录结构如下：
# 单个XML布局编译 aapt2 compile res/layout/main_activity.xml -o compiled/ # 批量编译整个res目录 aapt2 compile res/values/strings.xml res/layout/main_activity.xml -o compiled/
执行后会在compiled/目录生成类似layout_main_activity.xml.flat的文件。注意在描述HTML标签时应写作<TextView>而不是真实标签，避免被解析。
aapt2的链接阶段
链接阶段将上一步所有的.flat文件合并，分配资源ID，生成resources.arsc以及R.java或R.txt，还可以直接产出未签名的APK。
# 链接编译后的资源，生成R.txt和resources.arsc，并打包为apk aapt2 link compiled/layout_main_activity.xml.flat compiled/values_strings.xml.flat -I $ANDROID_HOME/platforms/android-33/android.jar -o output/app.apk --java generated/ --output-text-symbols rtxt/
其中-I用于指定Android框架的jar包，--java指定R类生成目录，--output-text-symbols输出资源ID映射文本。
常用链接选项说明
| 选项 | 作用 |
|---|---|
| --package-id | 指定包的资源ID前缀，比如0x7f |
| --allow-reserved-package-id | 允许使用系统保留的包ID |
| --no-auto-version | 不自动根据配置生成版本相关资源 |
完整示例脚本
下面给出一个简单的编译加链接的完整命令流：
# 1. 编译 aapt2 compile res/layout/activity_main.xml -o out/ # 2. 链接 aapt2 link out/layout_activity_main.xml.flat -I $ANDROID_HOME/platforms/android-33/android.jar -o out/app.apk --java out/r/ --manifest AndroidManifest.xml
排查建议
- 编译报错通常指向具体XML文件和行号，优先修复XML语法。
- 链接阶段报重复资源，多是同名文件在不同目录冲突。
- 使用
aapt2 dump可以查看apk内的资源表内容。
掌握aapt2怎么编译和链接安卓的XML资源，是理解Gradle Android插件资源处理机制的基础，也能在命令行手动打包时减少依赖。
在实际工程中，通常不需要直接调用aapt2，AGP已经封装好这些步骤，但了解原理对解决资源相关构建异常非常有帮助。