AAPT2

AAPT2 (Android Asset Packaging Tool) adalah alat build yang digunakan oleh Android Studio dan Plugin Android Gradle untuk mengompilasi dan memaketkan resource aplikasi Anda. AAPT2 mengurai, mengindeks, dan mengompilasi resource menjadi format biner yang dioptimalkan untuk platform Android.

Plugin Android Gradle 3.0.0 dan yang lebih tinggi mengaktifkan AAPT2 secara default. Anda biasanya tidak perlu memanggil aapt2 sendiri. Namun, jika lebih memilih untuk menggunakan sistem build dan terminal milik sendiri daripada Android Studio, Anda dapat menggunakan AAPT2 dari command line. Anda juga dapat men-debug error build yang terkait dengan AAPT2 dari command line. Untuk melakukannya, temukan AAPT2 sebagai alat mandiri di Android SDK Build Tools 26.0.2 dan yang lebih tinggi.

Untuk mendownload Android SDK Build Tools dari command line, gunakan sdkmanager dan jalankan perintah berikut:

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

Setelah mendownload SDK Build Tools, temukan AAPT2 di android_sdk/build-tools/version/.

Karena revisi Android SDK Build Tools tidak sering dirilis, versi AAPT2 yang disertakan dalam SDK Build Tools Anda mungkin bukan yang terbaru. Untuk mendapatkan versi terbaru AAPT2, download AAPT2 dari Maven Google.

Untuk menggunakan AAPT2 dari command line di Linux atau Mac, jalankan perintah aapt2. Di Windows, jalankan perintah aapt2.exe.

AAPT2 mendukung kompilasi resource yang lebih cepat dengan mengaktifkan kompilasi inkremental. Untuk menyelesaikan kompilasi inkremental, pemrosesan resource dipisahkan menjadi dua langkah:

• Compile: mengompilasi file resource ke dalam format biner.
• Link: menggabungkan semua file yang dikompilasi, lalu memaketkannya menjadi satu.

Pembagian ini akan membantu meningkatkan performa untuk build inkremental. Misalnya, jika ada perubahan dalam satu file, Anda hanya perlu menghimpun ulang file tersebut.

Mendownload AAPT2 dari Maven Google

Untuk mendapatkan versi terbaru AAPT2 yang tidak disertakan dalam alat build, download AAPT2 dari repositori Maven Google sebagai berikut:

1. Di indeks repositori, buka com.android.tools.build > aapt2.
2. Salin nama versi terbaru AAPT2.

3. Masukkan nama versi yang Anda salin ke URL berikut dan tentukan sistem operasi target Anda: https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/ aapt2-version/aapt2-aapt2-version- [windows | linux | osx].jar

   Misalnya, untuk mendownload versi 3.2.0-alpha18-4804415 untuk Windows, gunakan: 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. Buka URL di browser. AAPT2 akan segera didownload.

5. Buka paket file JAR yang baru saja didownload.

   File JAR harus berisi file aapt2 yang dapat dieksekusi dan beberapa library yang dijadikan dependensi oleh file yang dapat dieksekusi tersebut.

Compile

AAPT2 mendukung kompilasi semua jenis resource Android, seperti file drawable dan file XML. Saat Anda memanggil AAPT2 untuk kompilasi, teruskan satu file resource sebagai input per pemanggilan. AAPT2 kemudian menguraikan file dan menghasilkan file biner perantara dengan ekstensi .flat.

Ketika Anda meneruskan seluruh direktori, AAPT2 akan mengompilasi ulang semua file dalam direktori tersebut meskipun hanya satu resource yang diubah. Meskipun Anda dapat meneruskan direktori resource yang berisi lebih dari satu file resource ke AAPT2 menggunakan flag --dir, Anda tidak akan mendapatkan manfaat dari kompilasi resource inkremental dengan cara ini.

Jenis file output dapat berbeda berdasarkan input yang Anda berikan untuk kompilasi, seperti ditunjukkan pada tabel berikut:

Tabel 1. Jenis file input dan output untuk kompilasi

File yang dihasilkan oleh AAPT2 tidak dapat dieksekusi, dan nantinya, Anda harus menyertakan file biner ini sebagai input dalam fase penautan untuk membuat APK. Namun, file APK yang dihasilkan juga bukan file yang dapat dieksekusi dan dapat langsung di-deploy ke perangkat Android, karena tidak berisi file DEX dan tidak ditandatangani.

Sintaksis Compile

Sintaksis umum untuk menggunakan compile adalah sebagai berikut:

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

Dalam contoh berikut, AAPT2 mengompilasi file resource dengan nama values.xml dan myImage.png secara terpisah:

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/

Seperti ditunjukkan dalam tabel 1, nama file output bergantung pada nama file input dan nama direktori induknya.

Untuk contoh sebelumnya dengan file strings.xml sebagai input, aapt2 secara otomatis menamai file output sebagai values-en_strings.arsc.flat. Namun, file drawable yang dikompilasi dan disimpan dalam direktori drawable dinamai drawable_img.png.flat.

Opsi Compile

Ada beberapa opsi yang dapat Anda gunakan dengan perintah compile, seperti ditunjukkan pada tabel 2:

Tabel 2. Opsi perintah Compile

Link

Dalam fase penautan, AAPT2 akan menggabungkan semua file perantara yang dihasilkan oleh fase kompilasi, seperti tabel resource, file XML biner, dan file PNG yang diproses, kemudian memaketkan file tersebut menjadi satu APK. Selain itu, file tambahan lainnya, seperti file aturan R.java dan ProGuard, dapat dibuat selama fase ini. Namun, APK yang dihasilkan tidak berisi bytecode DEX dan tidak ditandatangani. Anda tidak dapat men-deploy APK ini ke perangkat.

Jika tidak menggunakan plugin Android Gradle untuk mem-build aplikasi dari command line, Anda dapat menggunakan alat command line lainnya seperti d8 untuk mengompilasi bytecode Java menjadi bytecode DEX danapksigner untuk menandatangani APK.

Sintaksis Link

Sintaksis umum untuk menggunakan link adalah sebagai berikut:

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

Pada contoh berikut, AAPT2 menggabungkan dua file perantara, drawable_Image.flat dan values_values.arsc.flat, serta file AndroidManifest.xml. AAPT2 menautkan hasilnya ke file android.jar yang berisi resource yang ditentukan dalam paket 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

Opsi Link

Anda dapat menggunakan opsi berikut dengan perintah link:

Tabel 3. Opsi perintah link

Dump

dump digunakan untuk mencetak informasi tentang APK yang Anda buat menggunakan perintah link.

Sintaksis Dump

Sintaksis umum untuk menggunakan dump adalah sebagai berikut:

aapt2 dump sub-command filename.apk [options]

Contoh berikut mencetak konten dari tabel resource APK yang ditentukan:

aapt2 dump resources output.apk

Sub-perintah Dump

Tentukan salah satu sub-perintah berikut dengan perintah dump:

Tabel 4. Sub-perintah Dump

Opsi Dump

Gunakan opsi berikut dengan dump:

Tabel 5. Opsi Dump

Diff

Gunakan diff untuk membandingkan dua APK dan mengidentifikasi perbedaan di antara keduanya.

Sintaksis Diff

Sintaksis umum untuk menggunakan diff adalah sebagai berikut:

aapt2 diff first.apk second.apk

Tidak ada opsi untuk perintah diff.

Optimize

optimize digunakan untuk menjalankan pengoptimalan pada resource yang digabungkan dan resources.arsc sebelum dikemas ke dalam APK. Pengoptimalan ini dapat mengurangi ukuran APK sekitar 1-3%, bergantung pada ukuran dan jumlah resource yang digunakan.

Sintaksis Optimize

Sintaksis umum untuk menggunakan optimize adalah sebagai berikut:

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

Contoh berikut mengoptimalkan resource di input.apk dan membuat APK baru yang dioptimalkan di output.apk. Ini menggantikan representasi tabel datar biasa dengan hierarki penelusuran biner yang lebih ringkas, sehingga menghasilkan APK yang lebih kecil dengan mengorbankan performa pengambilan:

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

Opsi Optimize

Anda dapat menggunakan opsi berikut dengan optimize:

Tabel 6. Opsi Optimize

Convert

Secara default, perintah compile AAPT mengompilasi resource ke dalam format biner yang sesuai untuk APK. Anda juga dapat menentukan format protobuf yang cocok untuk AAB dengan menentukan --proto-format. Perintah convert mengonversi APK di antara dua format.

Sintaksis Convert

Sintaksis umum untuk convert adalah sebagai berikut:

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

Contoh berikut mengonversi resource di input.apk dan membuat APK baru di output.apk yang berisi resource format protobuf. Ini menggantikan representasi tabel datar biasa dengan hierarki penelusuran biner yang lebih ringkas, sehingga menghasilkan APK yang lebih kecil dengan mengorbankan performa pengambilan:

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

Opsi Convert

Gunakan opsi berikut dengan convert:

Tabel 7. Opsi Convert

Mode Daemon

AAPT versi 2.19 memperkenalkan mode daemon untuk mengeluarkan perintah. Mode daemon memungkinkan Anda memasukkan beberapa perintah dalam satu sesi AAPT.

Sintaksis Daemon

Mulai mode daemon dengan perintah berikut:

aapt2 daemon

Setelah mode daemon berjalan, Anda dapat memasukkan perintah. Setiap argumen perintah harus berada di baris terpisah, dengan baris kosong di akhir perintah. Keluar dari mode daemon dengan mengetik Control+D.

Pertimbangkan masing-masing perintah compile berikut:

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/

Perintah ini dapat dimasukkan dalam mode daemon sebagai:

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

Opsi mode Daemon

Satu-satunya opsi untuk mode daemon adalah --trace-folder folder, yang menghasilkan fragmen rekaman aktivitas JSON systrace ke folder yang ditentukan.

Versi

Tentukan versi AAPT2 yang Anda gunakan dengan perintah version:

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

Perubahan perilaku saat menggunakan AAPT2

Sebelum AAPT2, AAPT adalah versi default Android Asset Packaging Tool, yang sekarang tidak digunakan lagi. Meskipun AAPT2 dapat langsung berfungsi dengan project lama, bagian ini menjelaskan beberapa perubahan perilaku yang harus Anda ketahui.

Hierarki elemen dalam manifes Android

Dalam versi AAPT sebelumnya, elemen yang dibuat bertingkat dalam node yang salah pada file AndroidManifest.xml akan diabaikan atau mengakibatkan munculnya peringatan. Misalnya, perhatikan contoh berikut:

<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>

AAPT versi sebelumnya akan mengabaikan tag <action> yang salah tempat.

Dengan AAPT2, Anda akan menerima error berikut:

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

Untuk mengatasi masalah ini, pastikan elemen manifes dibuat bertingkat dengan benar. Untuk mengetahui informasi selengkapnya, baca ringkasan Manifes Aplikasi.

Deklarasi resource

Anda tidak lagi dapat menunjukkan jenis resource dari atribut name. Contoh berikut salah mendeklarasikan item resource attr:

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

Mendeklarasikan jenis resource dengan cara ini akan mengakibatkan error build seperti berikut:

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

Untuk mengatasi error ini, deklarasikan jenis menggunakan type="attr" secara eksplisit:

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

Selain itu, saat mendeklarasikan elemen <style>, induknya juga harus berupa jenis resource gaya. Jika tidak, Anda akan mendapatkan error seperti berikut:

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

Penggunaan simbol referensi resource @ yang salah

AAPT2 akan menampilkan error build saat Anda menghilangkan atau salah menempatkan simbol referensi resource (@). Misalnya, jika Anda menghilangkan simbol saat menentukan atribut gaya:

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

Saat membuat modul, AAPT2 akan menampilkan error build seperti berikut:

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

Selain itu, jika Anda salah menyertakan simbol saat mengakses resource dari namespace android:

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

Saat membuat modul, AAPT2 akan menampilkan error build seperti berikut:

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

Konfigurasi library yang salah

Jika aplikasi Anda memiliki dependensi di library pihak ketiga yang dibuat menggunakan versi lama Android SDK Build Tools, aplikasi mungkin akan berhenti bekerja pada runtime tanpa menampilkan error atau peringatan apa pun. Error ini mungkin terjadi karena selama pembuatan library, kolom R.java dideklarasikan sebagai final. Akibatnya, semua ID resource disisipkan dalam class library.

AAPT2 bergantung pada kemampuan untuk menetapkan ulang ID ke resource library saat mem-build aplikasi Anda. Jika library mengasumsikan ID adalah final dan menyisipkannya di DEX library, akan terjadi ketidakcocokan runtime.

Untuk mengatasi error ini, hubungi pembuat library untuk mem-build ulang library menggunakan versi terbaru Android SDK Build Tools dan memublikasikannya lagi.