AAPT2

AAPT2（Android 资源打包工具）是一种构建工具，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. 将复制的版本名称插入以下网址并指定目标操作系统： 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. 在浏览器中前往该网址，系统将随即开始下载 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_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 用于输出有关您使用 link 命令生成的 APK 的信息。

转储语法

使用 dump 的一般语法如下：

aapt2 dump sub-command filename.apk [options]

以下示例会输出所指定 APK 的资源表中的内容：

aapt2 dump resources output.apk

转储子命令

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

表 4. 转储子命令

转储选项

将以下选项与 dump 搭配使用：

表 5. 转储选项

diff

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

差异比较语法

使用 diff 的一般语法如下：

aapt2 diff first.apk second.apk

没有适用于 diff 命令的选项。

优化

optimize 用于在合并后的资源和 resources.arsc 被打包到 APK 之前对其运行优化。这项优化可将 APK 大小缩减约 1-3%，具体取决于所用资源的大小和数量。

优化语法

使用 optimize 的一般语法如下：

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

以下示例会优化 input.apk 中的资源，并在 output.apk 中创建一个经过优化的新 APK。它使用更紧凑的二进制搜索树替换通常的平面表格表示法，可以让 APK 体量更小，但检索性能会下降：

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

优化选项

您可以将以下选项与 optimize 搭配使用：

表 6. 优化选项

转换

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

转换语法

使用 convert 的一般语法如下：

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

以下示例会转换 input.apk 中的资源，并在包含 protobuf 格式资源的 output.apk 中创建一个新 APK。它使用更紧凑的二进制搜索树替换通常的平面表格表示法，可以让 APK 体量更小，但检索性能会下降：

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

转换选项

将以下选项与 convert 搭配使用：

表 7. 转换选项

守护程序模式

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

守护程序语法

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

aapt2 daemon

守护程序模式运行后，您可以输入命令。该命令的每个参数都必须单独占一行，并且命令的末尾有一个空行。按 Ctrl+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，它会生成指向指定 folder 的 systrace JSON 跟踪记录 fragment。

版本

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

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

使用 AAPT2 时的行为变化

在 AAPT2 之前，AAPT 是 Android 资源打包工具的默认版本，现在已被废弃。虽然 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 重新构建该库，然后重新发布该库。