zipalign

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

在将 APK 文件分发给最终用户之前,使用 zipalign 对其进行优化。如果您使用 Android Studio 构建,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 确保它们对齐到 16 KiB 页面边界,以适合 16 KiB 和 4 KiB 设备上的 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 文件对齐到 4 KiB 页面。建议改用 -P 16,因为 -p 已弃用。
-v 详细输出。
-z 使用 Zopfli 重新压缩。