zipalign

zipalign 是一款 zip 归档对齐工具，有助于确保归档中所有未压缩的文件相对于文件起始位置进行对齐。这样可以直接通过 mmap(2) 访问这些文件，无需将数据复制到内存中，从而减少应用的内存占用。

在向最终用户分发 APK 文件之前，请使用 zipalign 对其进行优化。如果您使用 Android Studio（它使用了 Android Gradle 插件 (AGP)）进行构建，此过程会自动完成。在这种情况下，您仍应使用 zipalign 验证 APK 是否已对齐，但无需手动执行对齐操作。本文档主要供自定义构建系统的维护者参考。

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

  • 如果您使用 apksigner，则必须在对 APK 文件进行签名之前使用 zipalign。如果您使用 apksigner 对 APK 进行签名后又对其进行了修改，其签名将会失效。
  • 如果您使用 jarsigner（不推荐），则必须在对 APK 文件进行签名之后使用 zipalign。

为了实现对齐，zipalign 会更改 zip Local File Header 部分中 "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 进行重新压缩。