zipalign

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

在将 APK 文件分发给最终用户之前,先使用 zipalign 进行优化。如果您通过使用 Android Gradle 插件 (AGP) 的 Android Studio 进行构建,系统会自动完成此操作。在这种情况下,您仍应使用 zipalign 来验证 APK 是否已对齐,但您无需对齐。本文档主要适用于自定义构建系统的维护者。

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

  • 如果您使用的是 apksigner,则必须在为 APK 文件签名之前使用 zipalign。如果您在使用 apksigner 为 APK 签名之后对 APK 做出了进一步更改,签名便会失效。
  • 如果您使用的是 jarsigner(不推荐),则必须在为 APK 文件签名之后使用 zipalign

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

用法

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

如需对齐 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 <页面大小_kb> 将未压缩的 .so 文件对齐到指定的页面大小(以 KiB 为单位)。有效选项 为 4、16 和 64。<pagesize_kb>
-p 4KiB 页面对齐未压缩的 .so 文件。建议使用 -P 16,因为 -p 已废弃。
-v 详细输出。
-z 使用 Zopfli 重新压缩。