AAPT2

AAPT2 (Công cụ đóng gói tài nguyên Android) là một công cụ bản dựng mà Android Studio và Trình bổ trợ Android cho Gradle sử dụng để biên dịch và đóng gói các tài nguyên của ứng dụng. AAPT2 phân tích cú pháp, lập chỉ mục và biên dịch các tài nguyên thành định dạng nhị phân được tối ưu hoá cho nền tảng Android.

Trình bổ trợ Android cho Gradle 3.0.0 trở lên sẽ bật AAPT2 theo mặc định. Thường thì bạn không cần phải tự gọi aapt2. Tuy nhiên, nếu bạn muốn sử dụng thiết bị đầu cuối và hệ thống xây dựng của riêng mình qua Android Studio, bạn có thể sử dụng AAPT2 từ dòng lệnh. Bạn cũng có thể gỡ lỗi bản dựng có liên quan đến AAPT2 từ dòng lệnh. Để thực hiện việc này, bạn có thể tìm AAPT2 dưới dạng công cụ độc lập trong Bộ công cụ bản dựng SDK Android phiên bản 26.0.2 trở lên.

Để tải xuống Bộ công cụ bản dựng SDK Android từ dòng lệnh, hãy sử dụng sdkmanager và chạy lệnh sau:

sdkmanager "build-tools;build-tools-version"

Sau khi đã tải Bộ công cụ bản dựng SDK xuống, hãy tìm AAPT2 trong android_sdk/build-tools/version/.

Vì các bản sửa đổi của Bộ công cụ bản dựng SDK Android không được phát hành thường xuyên, nên phiên bản AAPT2 đi kèm trong Bộ công cụ bản dựng SDK của bạn có thể không phải là phiên bản mới nhất. Để tải phiên bản AAPT2 mới nhất, hãy đọc bài viết Tải AAPT2 xuống từ Kho lưu trữ Maven của Google.

Để sử dụng AAPT2 từ dòng lệnh trên Linux hoặc Mac, hãy chạy lệnh aapt2. Trên Windows, hãy chạy lệnh aapt2.exe.

AAPT2 có tính năng biên dịch gia tăng giúp hỗ trợ biên dịch tài nguyên nhanh hơn. Để hoàn thành việc biên dịch gia tăng, quá trình xử lý tài nguyên sẽ được tách thành hai bước:

• Biên dịch: biên dịch các tệp tài nguyên thành định dạng nhị phân.
• Liên kết: hợp nhất tất cả tệp đã biên dịch và đóng gói thành một gói duy nhất.

Cách phân chia này giúp cải thiện hiệu suất cho các bản dựng gia tăng. Ví dụ: nếu có thay đổi trong một tệp, bạn chỉ cần biên dịch lại tệp đó.

Tải AAPT2 xuống từ Google Maven

Để tải phiên bản AAPT2 mới nhất chưa được đóng gói trong bộ công cụ xây dựng, bạn có thể tải AAPT2 xuống từ Kho lưu trữ Maven của Google như sau:

1. Trong phần chỉ mục kho lưu trữ, hãy chuyển đến com.android.tools.build > aapt2.
2. Sao chép tên của phiên bản AAPT2 mới nhất.

3. Chèn tên phiên bản bạn vừa sao chép vào URL sau và chỉ định hệ điều hành đích: https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/aapt2-version/aapt2-aapt2-version- [windows | linux | osx].jar

   Ví dụ: để tải phiên bản 3.2.0-alpha18-4804415 cho Windows, bạn hãy sử dụng: https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/3.2.0-alpha18-4804415/aapt2-3.2.0-alpha18-4804415-windows.jar

4. Di chuyển đến URL trong trình duyệt—AAPT2 sẽ bắt đầu tải xuống trong chốc lát.

5. Mở gói tệp JAR bạn vừa tải xuống.

   Tệp JAR phải chứa tệp thực thi aapt2 và một số thư viện mà tệp thực thi phụ thuộc.

Biên dịch

AAPT2 hỗ trợ việc biên dịch tất cả các loại tài nguyên Android, chẳng hạn như các tệp XML và đối tượng có thể vẽ. Khi bạn gọi AAPT2 để biên dịch, hãy chuyển một tệp tài nguyên dưới dạng dữ liệu đầu vào cho mỗi lệnh gọi. Sau đó, AAPT2 sẽ phân tích cú pháp tệp và tạo tệp nhị phân trung gian có phần mở rộng .flat.

Khi chuyển toàn bộ thư mục, AAPT2 sẽ biên dịch lại tất cả tệp trong thư mục ngay cả khi chỉ có một tài nguyên thay đổi. Mặc dù bạn có thể chuyển các thư mục tài nguyên chứa nhiều tệp tài nguyên cho AAPT2 bằng cách sử dụng cờ --dir, nhưng làm như vậy sẽ không tận dụng được lợi ích của việc biên dịch tài nguyên gia tăng theo cách này.

Các loại tệp đầu ra có thể khác nhau tuỳ theo dữ liệu đầu vào mà bạn cung cấp để biên dịch, như trình bày trong bảng sau:

Bảng 1. Loại tệp đầu vào và đầu ra để biên dịch

Các tệp đầu ra AAPT2 là tệp không thể thực thi, sau đó bạn phải đưa các tệp nhị phân này vào làm đầu vào trong giai đoạn liên kết để tạo tệp APK. Tuy nhiên, tệp APK được tạo không phải là tệp thực thi mà bạn có thể triển khai trên thiết bị Android ngay lập tức, vì tệp này không chứa các tệp DEX (mã byte biên dịch) và chưa được ký.

Cú pháp biên dịch

Cú pháp chung để sử dụng compile như sau:

aapt2 compile path-to-input-files [options] -o output-directory/

Trong ví dụ sau, AAPT2 biên dịch riêng lẻ các tệp tài nguyên có tên values.xml và myImage.png:

aapt2 compile project_root/module_root/src/main/res/values-en/strings.xml -o compiled/
aapt2 compile project_root/module_root/src/main/res/drawable/myImage.png -o compiled/

Như trình bày trong bảng 1, tên của tệp đầu ra phụ thuộc vào tên tệp đầu vào và tên của thư mục mẹ.

Trong ví dụ trước, trong đó tệp strings.xml làm dữ liệu đầu vào, aapt2 sẽ tự động đặt tên tệp đầu ra là values-en_strings.arsc.flat. Tuy nhiên, tệp đối tượng có thể vẽ đã biên dịch lưu trữ trong thư mục đối tượng có thể vẽ có tên là drawable_img.png.flat.

Tuỳ chọn biên dịch

Có một số tuỳ chọn mà bạn có thể sử dụng cùng với lệnh compile, như được cho thấy trong bảng 2:

Bảng 2. Tuỳ chọn lệnh biên dịch

Liên kết

Trong giai đoạn liên kết, AAPT2 hợp nhất tất cả tệp trung gian mà giai đoạn biên dịch tạo ra, chẳng hạn như bảng tài nguyên, tệp XML nhị phân và tệp PNG đã xử lý, sau đó đóng gói các tệp này thành một tệp APK duy nhất. Ngoài ra, các tệp phụ khác, chẳng hạn như tệp quy tắc R.java và ProGuard có thể được tạo trong giai đoạn này. Tuy nhiên, tệp APK đã tạo không chứa mã byte DEX và chưa được ký. Bạn không thể triển khai tệp APK này cho một thiết bị.

Nếu không dùng Trình bổ trợ Android cho Gradle để tạo bản dựng ứng dụng từ dòng lệnh, bạn có thể dùng các công cụ dòng lệnh khác, chẳng hạn như d8 để biên dịch mã byte Java thành mã byte DEX và apksigner để ký tệp APK của mình.

Cú pháp liên kết

Cú pháp chung để sử dụng link như sau:

aapt2 link path-to-input-files [options] -o
outputdirectory/outputfilename.apk --manifest AndroidManifest.xml

Trong ví dụ sau, AAPT2 hợp nhất hai tệp trung gian là drawable_Image.flat và values_values.arsc.flat với tệp AndroidManifest.xml. AAPT2 liên kết kết quả với tệp android.jar chứa các tài nguyên được xác định trong gói android:

 aapt2 link -o output.apk
 -I android_sdk/platforms/android_version/android.jar
    compiled/res/values_values.arsc.flat
    compiled/res/drawable_Image.flat --manifest /path/to/AndroidManifest.xml -v

Tuỳ chọn liên kết

Bạn có thể dùng các tuỳ chọn sau với lệnh link:

Bảng 3. Tuỳ chọn lệnh liên kết

Dump

dump được dùng để in thông tin về tệp APK bạn đã tạo bằng lệnh link.

Cú pháp kết xuất

Cú pháp chung để sử dụng dump như sau:

aapt2 dump sub-command filename.apk [options]

Ví dụ sau in nội dung từ bảng tài nguyên của tệp APK đã chỉ định:

aapt2 dump resources output.apk

Lệnh con kết xuất

Hãy chỉ định một trong các lệnh con sau đây bằng lệnh dump:

Bảng 4. Lệnh con kết xuất

Tuỳ chọn kết xuất

Sử dụng các tuỳ chọn sau với dump:

Bảng 5. Tuỳ chọn kết xuất

Diff

Sử dụng diff để so sánh hai tệp APK và xác định mọi điểm khác biệt.

Cú pháp diff

Cú pháp chung để sử dụng diff như sau:

aapt2 diff first.apk second.apk

Không có tuỳ chọn cho lệnh diff.

Tối ưu hoá

optimize được dùng để chạy các hoạt động tối ưu hoá trên tài nguyên hợp nhất và resources.arsc trước khi được đóng gói vào tệp APK. Tính năng tối ưu hoá này có thể giảm kích thước tệp APK khoảng 1-3%, tuỳ thuộc vào kích thước và số lượng tài nguyên đang sử dụng.

Cú pháp tối ưu hoá

Cú pháp chung để sử dụng optimize như sau:

aapt2 optimize options file[,file[..]]

Ví dụ sau đây tối ưu hoá tài nguyên trong input.apk và tạo một tệp APK mới được tối ưu hoá trong output.apk. Tệp APK này dùng một cây tìm kiếm nhị phân nhỏ gọn hơn thay cho cách trình bày bảng phẳng thông thường, nhờ đó giảm kích thước tệp APK cùng với chi phí hiệu suất truy xuất:

aapt2 optimize -o output.apk --enable-sparse-encoding input.apk

Tùy chọn tối ưu hoá

Bạn có thể sử dụng các tuỳ chọn sau với optimize:

Bảng 6. Tùy chọn tối ưu hoá

Chuyển đổi

Theo mặc định, lệnh compile của AAPT biên dịch các tài nguyên thành một định dạng nhị phân phù hợp với tệp APK. Bạn cũng có thể chỉ định định dạng protobuf phù hợp với các AAB bằng cách chỉ định --proto-format. Lệnh convert chuyển đổi tệp APK giữa hai định dạng.

Cú pháp chuyển đổi

Cú pháp chung để sử dụng convert như sau:

aapt2 convert -o output-file options file[,file[..]]

Ví dụ sau đây chuyển đổi các tài nguyên trong input.apk và tạo một tệp APK mới trong output.apk chứa các tài nguyên ở định dạng Protobuf. Tệp APK này dùng một cây tìm kiếm nhị phân nhỏ gọn hơn thay cho cách trình bày bảng phẳng thông thường, nhờ đó giảm kích thước tệp APK cùng với chi phí hiệu suất truy xuất:

aapt2 convert -o output.apk --output-format proto --enable-sparse-encoding input.apk

Tuỳ chọn chuyển đổi

Sử dụng các tuỳ chọn sau với convert:

Bảng 7. Các tuỳ chọn chuyển đổi

Chế độ trình nền (Daemon mode)

AAPT phiên bản 2.19 đã ra mắt chế độ trình nền để đưa ra các lệnh. Chế độ trình nền cho phép bạn nhập nhiều lệnh trong một phiên AAPT.

Cú pháp trình nền

Bắt đầu chế độ trình nền bằng lệnh sau:

aapt2 daemon

Khi chế độ trình nền đang chạy, bạn có thể nhập các lệnh. Mỗi đối số của lệnh phải nằm trên một dòng riêng biệt, với một dòng trống ở cuối lệnh. Thoát khỏi chế độ trình nền bằng cách nhấn tổ hợp phím Control+D.

Hãy cân nhắc các lệnh compile riêng lẻ sau đây:

aapt2 compile project_root/module_root/src/main/res/values-en/strings.xml -o compiled/
aapt2 compile project_root/module_root/src/main/res/drawable/myImage.png -o compiled/

Bạn có thể nhập các lệnh sau đây trong chế độ trình nền:

aapt2 daemon
Ready
compile
project_root/module_root/src/main/res/values-en/strings.xml
-o
compiled/

Done
compile
project_root/module_root/src/main/res/drawable/myImage.png
-o
compiled/

Done
^D
Exiting daemon

Tuỳ chọn chế độ trình nền

Một tuỳ chọn duy nhất cho chế độ trình nền là --trace-folder folder, tuỳ chọn này sẽ tạo mảnh theo dõi JSON systrace thành folder đã chỉ định.

Phiên bản

Xác định phiên bản AAPT2 mà bạn đang sử dụng bằng lệnh version:

aapt2 version
Android Asset Packaging Tool (aapt) 2.19-8678579

Các thay đổi về hành vi khi sử dụng AAPT2

Trước AAPT2, AAPT là phiên bản mặc định của Công cụ đóng gói tài nguyên Android nhưng hiện không còn được dùng nữa. Mặc dù AAPT2 sẽ hoạt động tức thì với các dự án cũ, nhưng phần này sẽ mô tả một số thay đổi về hành vi mà bạn cần lưu ý.

Hệ phân cấp phần tử trong tệp kê khai Android

Trong các phiên bản AAPT trước, các phần tử lồng trong các nút không chính xác trong tệp AndroidManifest.xml sẽ bị bỏ qua hoặc dẫn đến cảnh báo. Hãy xem ví dụ sau đây:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.myname.myapplication">
   <application
       ...
       <activity android:name=".MainActivity">
           <intent-filter>
               <action android:name="android.intent.action.MAIN" />
               <category android:name="android.intent.category.LAUNCHER" />
           </intent-filter>
           <action android:name="android.intent.action.CUSTOM" />
       </activity>
   </application>
</manifest>

Các phiên bản AAPT trước sẽ chỉ bỏ qua thẻ <action> bị đặt nhầm chỗ.

Với AAPT2, bạn sẽ gặp lỗi sau:

AndroidManifest.xml:15: error: unknown element <action> found.

Để giải quyết lỗi này, hãy nhớ lồng ghép chính xác các phần tử tệp kê khai của bạn. Để biết thêm thông tin, hãy đọc bài viết Tổng quan về tệp kê khai ứng dụng.

Khai báo tài nguyên

Bạn không còn chỉ định được loại tài nguyên từ thuộc tính name. Ví dụ sau đây khai báo không chính xác một mục tài nguyên attr:

<style name="childStyle" parent="parentStyle">
    <item name="attr/my_attr">@color/pink</item>
</style>

Việc khai báo loại tài nguyên theo cách này sẽ dẫn đến lỗi bản dựng sau đây:

Error: style attribute 'attr/attr/my_attr (aka my.package:attr/attr/my_attr)'
not found.

Để khắc phục lỗi này, hãy khai báo rõ ràng loại tệp bằng type="attr":

<style name="childStyle" parent="parentStyle">
  <item type="attr" name="my_attr">@color/pink</item>
</style>

Ngoài ra, khi khai báo phần tử <style>, phần tử gốc cũng phải là tài nguyên kiểu. Nếu không, bạn sẽ gặp lỗi tương tự như sau:

Error: (...) invalid resource type 'attr' for parent of style

Sử dụng các ký hiệu tham chiếu tài nguyên @ không đúng cách

AAPT2 phát ra lỗi bản dựng khi bạn bỏ qua hoặc thiết lập không chính xác các ký hiệu tham chiếu tài nguyên (@). Ví dụ: nếu bạn bỏ qua biểu tượng khi chỉ định thuộc tính kiểu:

<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
  ...
  <!-- Note the missing '@' symbol when specifying the resource type. -->
  <item name="colorPrimary">color/colorPrimary</item>
</style>

Khi xây dựng mô-đun, AAPT2 sẽ phát ra lỗi bản dựng sau đây:

ERROR: expected color but got (raw string) color/colorPrimary

Ngoài ra, nếu bạn thêm biểu tượng không chính xác khi truy cập vào một tài nguyên từ không gian tên android:

...
<!-- When referencing resources from the 'android' namespace, omit the '@' symbol. -->
<item name="@android:windowEnterAnimation"/>

Khi xây dựng mô-đun, AAPT2 sẽ phát ra lỗi bản dựng sau đây:

Error: style attribute '@android:attr/windowEnterAnimation' not found

Cấu hình thư viện không chính xác

Nếu ứng dụng của bạn có phần phụ thuộc trên thư viện bên thứ ba được tạo bằng các phiên bản Bộ công cụ bản dựng SDK Android cũ hơn thì ứng dụng của bạn có thể gặp sự cố trong thời gian chạy mà không hiện lỗi hoặc cảnh báo nào. Sự cố này có thể xảy ra vì trong quá trình tạo thư viện, các trường R.java được khai báo final. Do đó, tất cả mã tài nguyên nằm trong các lớp của thư viện.

AAPT2 căn cứ vào việc gán lại mã nhận dạng cho các tài nguyên thư viện khi tạo bản dựng ứng dụng. Nếu thư viện giả định rằng các mã nhận dạng này là final và cùng dòng trong DEX của thư viện, thì thời gian chạy sẽ không khớp.

Để giải quyết lỗi này, hãy liên hệ với người tạo thư viện để xây dựng lại thư viện bằng cách sử dụng phiên bản Bộ công cụ xây dựng SDK Android mới nhất rồi đăng lại thư viện.