AAPT2

AAPT2（Android Asset Packaging Tool）是一个构建工具，Android Studio 和 Android Gradle 插件使用它来编译和打包应用的 资源。AAPT2 会解析、索引和编译资源，并将它们转换为针对 Android 平台优化的二进制格式。

Android Gradle 插件 3.0.0 及更高版本默认启用 AAPT2。通常您无需自行调用 aapt2。但是，如果您更喜欢使用终端和自己的构建系统而不是 Android Studio，则可以从命令行使用 AAPT2。您还可以从命令行调试与 AAPT2 相关的构建错误。为此，请在 Android SDK Build Tools 26.0.2 及更高版本中找到 AAPT2 作为独立工具。

要从命令行下载 Android SDK Build Tools，请使用 sdkmanager 并运行以下命令

sdkmanager "build-tools;build-tools-version"

下载 SDK Build Tools 后，在 android_sdk/build-tools/version/ 中找到 AAPT2。

由于 Android SDK Build Tools 的修订版本不会经常发布，因此 SDK Build Tools 中包含的 AAPT2 版本可能不是最新版本。要获取最新版本的 AAPT2，请 从 Google Maven 下载 AAPT2。

要在 Linux 或 Mac 上从命令行使用 AAPT2，请运行 aapt2 命令。在 Windows 上，请运行 aapt2.exe 命令。

AAPT2 通过启用增量编译来支持更快的资源编译。要实现增量编译，资源处理分为两个步骤

• 编译：将资源文件编译成二进制格式。
• 链接：合并所有已编译的文件并将它们打包到单个包中。

这种分离有助于提高增量构建的性能。例如，如果单个文件发生更改，则只需要重新编译该文件。

从 Google Maven 下载 AAPT2

要获取构建工具中未捆绑的最新版本的 AAPT2，请按照以下步骤从 Google 的 Maven 存储库下载 AAPT2

1. 在 存储库索引 中，导航到 com.android.tools.build > aapt2。
2. 复制最新版本 AAPT2 的名称。

3. 将您复制的版本名称插入以下 URL 并指定您的目标操作系统：https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/ aapt2-version/aapt2-aapt2-version- [windows | linux | osx].jar

   例如，要下载适用于 Windows 的 3.2.0-alpha18-4804415 版本，请使用：https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/ 3.2.0-alpha18-4804415/aapt2-3.2.0-alpha18-4804415-windows.jar

4. 在浏览器中导航到该 URL。AAPT2 将很快开始下载。

5. 解压缩您刚刚下载的 JAR 文件。

   JAR 文件应包含一个 aapt2 可执行文件和一些可执行文件依赖的库。

编译

AAPT2 支持编译所有 Android 资源类型，例如可绘制对象和 XML 文件。当您调用 AAPT2 进行编译时，请每次调用都传递一个资源文件作为输入。然后，AAPT2 会解析该文件并生成一个扩展名为 .flat 的中间二进制文件。

当传递整个目录时，即使只有一个资源发生更改，AAPT2 也会重新编译目录中的所有文件。虽然您可以使用 --dir 标志将包含多个资源文件的资源目录传递给 AAPT2，但这样做无法获得增量资源编译的优势。

输出文件类型可能因您提供的编译输入而异，如下表所示。

表 1. 编译的输入和输出文件类型

AAPT2 输出的文件不是可执行文件，您必须稍后将这些二进制文件作为输入包含在链接阶段中以生成 APK。但是，生成的 APK 文件不是您可以立即部署到 Android 设备上的可执行文件，因为它不包含 DEX 文件且未签名。

编译语法

使用 compile 的通用语法如下所示

aapt2 compile path-to-input-files [options] -o output-directory/

在以下示例中，AAPT2 分别编译名为 values.xml 和 myImage.png 的资源文件。

aapt2 compile project_root/module_root/src/main/res/values-en/strings.xml -o compiled/
aapt2 compile project_root/module_root/src/main/res/drawable/myImage.png -o compiled/

如表 1 所示，输出文件的名称取决于输入文件名及其父目录的名称。

对于前面使用 strings.xml 文件作为输入的示例，aapt2 会自动将输出文件命名为 values-en_strings.arsc.flat。但是，存储在 drawable 目录中的已编译 drawable 文件命名为 drawable_img.png.flat。

编译选项

您可以与 compile 命令一起使用多个选项，如表 2 所示。

表 2. 编译命令选项

链接

在链接阶段，AAPT2 会合并编译阶段生成的所有中间文件，例如资源表、二进制 XML 文件和处理后的 PNG 文件，然后将这些文件打包到一个 APK 中。此外，在此阶段还可以生成其他辅助文件，例如 R.java 和 ProGuard 规则文件。但是，生成的 APK 不包含 DEX 字节码且未签名。您无法将此 APK 部署到设备上。

如果您没有使用 Android Gradle 插件从 命令行构建您的应用，则可以使用其他命令行工具，例如 d8 将 Java 字节码编译成 DEX 字节码，以及 apksigner 来签署您的 APK。

链接语法

使用 link 的通用语法如下所示

aapt2 link path-to-input-files [options] -o
outputdirectory/outputfilename.apk --manifest AndroidManifest.xml

在以下示例中，AAPT2 合并了两个中间文件 drawable_Image.flat 和 values_values.arsc.flat，以及 AndroidManifest.xml 文件。AAPT2 将结果与 android.jar 文件链接，该文件保存 android 包中定义的资源。

 aapt2 link -o output.apk
 -I android_sdk/platforms/android_version/android.jar
    compiled/res/values_values.arsc.flat
    compiled/res/drawable_Image.flat --manifest /path/to/AndroidManifest.xml -v

链接选项

您可以将以下选项与 link 命令一起使用。

表 3. 链接命令选项

Dump

dump 用于打印有关使用 link 命令生成的 APK 的信息。

Dump 语法

使用 dump 的一般语法如下所示

aapt2 dump sub-command filename.apk [options]

以下示例打印来自指定 APK 的资源表的内容

aapt2 dump resources output.apk

Dump 子命令

使用 dump 命令指定以下子命令之一

表 4. Dump 子命令

Dump 选项

将以下选项与 dump 一起使用

表 5. Dump 选项

Diff

使用 diff 比较两个 APK 并识别它们之间的任何差异。

Diff 语法

使用 diff 的一般语法如下所示

aapt2 diff first.apk second.apk

diff 命令没有选项。

Optimize

optimize 用于在合并的资源和 resources.arsc 打包到 APK 中之前对其运行优化。此优化可以减少 APK 大小约 1-3%，具体取决于正在使用的资源的大小和数量。

Optimize 语法

使用 optimize 的一般语法如下所示

aapt2 optimize options file[,file[..]]

以下示例优化 input.apk 中的资源并在 output.apk 中创建一个新的优化后的 APK。它用更紧凑的二叉搜索树替换通常的扁平表表示形式，从而以检索性能为代价减小 APK 大小

aapt2 optimize -o output.apk --enable-sparse-encoding input.apk

Optimize 选项

您可以将以下选项与 optimize 一起使用

表 6. Optimize 选项

转换

默认情况下，AAPT compile 命令将资源编译成适合 APK 的二进制格式。通过指定 --proto-format，也可以指定适合 AAB 的 protobuf 格式。 convert 命令在两种格式之间转换 APK。

转换语法

convert 的通用语法如下所示

aapt2 convert -o output-file options file[,file[..]]

以下示例转换 input.apk 中的资源，并在 output.apk 中创建一个新的 APK，其中包含 protobuf 格式的资源。它用更紧凑的二叉搜索树替换了通常的扁平表表示，从而使 APK 更小，但代价是检索性能下降。

aapt2 convert -o output.apk --output-format proto --enable-sparse-encoding input.apk

转换选项

将以下选项与 convert 一起使用

表 7. 转换选项

守护进程模式

AAPT 2.19 版引入了用于发出命令的守护进程模式。守护进程模式允许您在一个 AAPT 会话中输入多个命令。

守护进程语法

使用以下命令启动守护进程模式

aapt2 daemon

守护进程模式运行后，您可以输入命令。命令的每个参数都必须位于单独的一行，命令末尾必须有一行空行。通过键入 Control+D 退出守护进程模式。

考虑以下各个 compile 命令

aapt2 compile project_root/module_root/src/main/res/values-en/strings.xml -o compiled/
aapt2 compile project_root/module_root/src/main/res/drawable/myImage.png -o compiled/

这些命令可以在守护进程模式下输入为

aapt2 daemon
Ready
compile
project_root/module_root/src/main/res/values-en/strings.xml
-o
compiled/

Done
compile
project_root/module_root/src/main/res/drawable/myImage.png
-o
compiled/

Done
^D
Exiting daemon

守护进程模式选项

守护进程模式的唯一选项是 --trace-folder folder，它会生成一个 systrace JSON 跟踪片段到指定的 folder。

版本

使用 version 命令确定您正在使用的 AAPT2 版本

aapt2 version
Android Asset Packaging Tool (aapt) 2.19-8678579

使用 AAPT2 时行为变化

在 AAPT2 之前，AAPT 是 Android Asset Packaging Tool 的默认版本，现在已弃用。虽然 AAPT2 应该可以立即与旧项目一起使用，但本节介绍了一些您应该注意的行为变化。

Android 清单中的元素层次结构

在早期版本的 AAPT 中，嵌套在 AndroidManifest.xml 文件中不正确节点中的元素要么被忽略，要么导致警告。例如，请考虑以下示例

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.myname.myapplication">
   <application
       ...
       <activity android:name=".MainActivity">
           <intent-filter>
               <action android:name="android.intent.action.MAIN" />
               <category android:name="android.intent.category.LAUNCHER" />
           </intent-filter>
           <action android:name="android.intent.action.CUSTOM" />
       </activity>
   </application>
</manifest>

早期版本的 AAPT 将简单地忽略放置错误的 <action> 标记。

使用 AAPT2 时，您会收到以下错误

AndroidManifest.xml:15: error: unknown element <action> found.

要解决此问题，请确保您的清单元素嵌套正确。有关更多信息，请阅读 应用清单概述。

资源声明

您不能再从 name 属性指示资源的类型。以下示例错误地声明了 attr 资源项

<style name="childStyle" parent="parentStyle">
    <item name="attr/my_attr">@color/pink</item>
</style>

以这种方式声明资源类型会导致以下构建错误

Error: style attribute 'attr/attr/my_attr (aka my.package:attr/attr/my_attr)'
not found.

要解决此错误，请使用 type="attr" 显式声明类型

<style name="childStyle" parent="parentStyle">
  <item type="attr" name="my_attr">@color/pink</item>
</style>

此外，在声明 <style> 元素时，其父元素也必须是样式资源类型。否则，您会收到类似于以下内容的错误

Error: (...) invalid resource type 'attr' for parent of style

@ 资源引用符号的错误使用

当您省略或错误地放置资源引用符号（@）时，AAPT2 会引发构建错误。例如，如果您在指定样式属性时省略了该符号

<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
  ...
  <!-- Note the missing '@' symbol when specifying the resource type. -->
  <item name="colorPrimary">color/colorPrimary</item>
</style>

构建模块时，AAPT2 会引发以下构建错误

ERROR: expected color but got (raw string) color/colorPrimary

此外，如果您在从 android 命名空间访问资源时错误地包含了该符号

...
<!-- When referencing resources from the 'android' namespace, omit the '@' symbol. -->
<item name="@android:windowEnterAnimation"/>

构建模块时，AAPT2 会引发以下构建错误

Error: style attribute '@android:attr/windowEnterAnimation' not found

库的错误配置

如果您的应用依赖于使用旧版 Android SDK Build Tools 构建的第三方库，则您的应用可能会在运行时崩溃，而不会显示任何错误或警告。此崩溃可能会发生，因为在库创建期间，R.java 字段被声明为 final。因此，所有资源 ID 都内联在库的类中。

AAPT2 依赖于能够在构建应用时重新分配库资源的 ID。如果库假设 ID 为 final 并将它们内联到库 DEX 中，则会出现运行时不匹配。

要解决此错误，请联系库作者使用最新版本的 Android SDK Build Tools 重新构建库，并重新发布库。