zipalign

zipalign 是一种 zip 归档对齐工具,有助于确保归档文件中所有未压缩的文件相对于文件开头对齐。这允许通过 mmap(2) 直接访问文件,无需在 RAM 中复制这些数据,从而减少应用的内存使用量。

在将 APK 文件分发给最终用户之前,使用 zipalign 对其进行优化。如果您使用 Android Studio 构建(它使用 Android Gradle 插件 (AGP)),则会自动执行此操作。在这种情况下,您仍然应该使用 zipalign 来验证 APK 是否已对齐,但无需对其进行对齐。此文档主要面向自定义构建系统的维护人员。

注意:必须在构建过程中的特定点使用 zipalign。该点取决于您使用的应用签名工具

  • 如果您使用 apksigner,则必须在 APK 文件签名 **之前** 使用 zipalign。如果您使用 apksigner 对 APK 签名并对 APK 进行进一步更改,则其签名将失效。
  • 如果您使用 jarsigner(不推荐),则必须在 APK 文件签名 **之后** 使用 zipalign

为了实现对齐,zipalign 会更改 zip 本地文件标头部分中 "extra" 字段的大小。此过程还可以更改 "extra" 字段中的现有数据。

用法

如果您的 APK 包含共享库(.so 文件),请使用 -P 16 确保它们对齐到适合在 16KiB 和 4KiB 设备上使用 mmap(2) 的 16KiB 页面边界。对于其他文件,其对齐方式由 zipalign 的强制对齐参数确定,应在 32 位和 64 位系统上对齐到 4 字节。

要对齐 infile.apk 并将其另存为 outfile.apk

zipalign -P 16 -f -v 4 infile.apk outfile.apk

要确认 existing.apk 的对齐方式,请使用以下命令。

zipalign -c -P 16 -v 4 existing.apk

选项

下表列出了可用的 zipalign 选项

选项 说明
-c 仅检查对齐方式(不修改文件)。
-f 覆盖现有输出文件。
-h 显示工具帮助。
-P <pagesize_kb> 将未压缩的 .so 文件对齐到以 KiB 为单位指定的页面大小。对于 <pagesize_kb>,有效选项为 4、16 和 64。
-p 4KiB 页面对齐未压缩的 .so 文件。建议改为使用 -P 16,因为 -p 已弃用。
-v 详细输出。
-z 使用 Zopfli 重新压缩。