zipalign

zipalign là một công cụ căn chỉnh tệp lưu trữ zip giúp đảm bảo mọi tệp không nén trong kho lưu trữ được căn chỉnh tương ứng với phần đầu tệp. Công cụ này cho phép truy cập trực tiếp vào các tệp thông qua mmap(2) , giúp hạn chế việc phải sao chép dữ liệu này trong RAM và làm giảm mức sử dụng bộ nhớ của ứng dụng.

Hãy sử dụng zipalign để tối ưu hoá tệp APK trước khi phân phối cho người dùng cuối. Nếu bạn dùng Android Studio để xây dựng ứng dụng, trình bổ trợ Android cho Gradle (AGP) sẽ tự động thực hiện việc này. Trong trường hợp đó, bạn vẫn nên sử dụng zipalign để xác minh tệp APK đã được căn chỉnh nhưng bạn không cần phải tự mình thực hiện thao tác này. Tài liệu này chủ yếu dành cho những nhà bảo trì hệ thống xây dựng tuỳ chỉnh.

Thận trọng: Bạn cần phải sử dụng zipalign tại một điểm cụ thể trong quy trình xây dựng. Điểm đó tuỳ thuộc vào công cụ ký ứng dụng mà bạn dùng:

  • Nếu sử dụng apksigner, bạn phải dùng zipalign trước khi tệp APK được ký. Nếu bạn ký vào tệp APK bằng apksigner và thực hiện thêm các thay đổi đối với tệp APK này thì chữ ký sẽ không hợp lệ.
  • Nếu sử dụng jarsigner (không nên), bạn phải dùng zipalign sau khi tệp APK được ký.

Để căn chỉnh được, zipalign sẽ thay đổi kích thước của trường "extra" trong phần Local File Header (Tiêu đề tệp cục bộ) của tệp zip. Quá trình này cũng có thể thay đổi dữ liệu hiện có trong các trường "extra".

Cách sử dụng

Nếu APK của bạn chứa thư viện chia sẻ (tệp .so), hãy sử dụng -P 16 để đảm bảo chúng phù hợp với ranh giới trang 16 KiB, phù hợp với mmap(2) trong cả thiết bị 16KiB và 4KiB. Đối với các tệp khác, việc căn chỉnh được xác định bởi giá trị đối số căn chỉnh bắt buộc thành zipalign, phải được căn chỉnh thành 4 byte trên cả hệ thống 32 bit và 64 bit.

Để căn chỉnh infile.apk và lưu tệp dưới dạng outfile.apk:

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

Để xác nhận cách căn chỉnh của existing.apk, hãy dùng lệnh sau.

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

Tùy chọn

Bảng sau đây liệt kê các tuỳ chọn zipalign hiện có:

Tuỳ chọn Nội dung mô tả
-c Chỉ kiểm tra cách căn chỉnh (không sửa đổi tệp).
-f Ghi đè tệp đầu ra hiện có.
-h Hiện thông tin trợ giúp về công cụ.
-P <pagesize_kb> căn chỉnh các tệp .so không nén theo kích thước trang đã chỉ định trong KiB. Lựa chọn hợp lệ cho <pagesize_kb> là 4, 16 và 64.
-p Căn chỉnh trang 4KiB cho tệp .so không nén. Bạn nên sử dụng Thay vào đó, -P 16, vì -p không được dùng nữa.
-v Chế độ đầu ra chi tiết.
-z Nén lại bằng Zopfli.