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 比较两个 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 中的资源，并在 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 文件夹，它会将 systrace JSON 跟踪片段生成到指定的 文件夹。

版本

使用 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 构建工具构建的第三方库，则您的应用可能会在运行时崩溃而不会显示任何错误或警告。发生此崩溃的原因可能是：在库创建期间，R.java 字段被声明为 final。结果是，所有资源 ID 都内联在库的类中。

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

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