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 页面边界，这适用于 16KiB 和 4KiB 设备中的 mmap(2)。对于其他文件，其对齐方式由 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 将未压缩的 .so 文件按 4KiB 页面对齐。建议改用 -P 16，因为 -p 已弃用。
-v 详细输出。
-z 使用 Zopfli 重新压缩。