aapt - manual referensi, opsi, contoh perintah


NAMA

aapt - Alat Pengemasan Aset Android

RINGKASAN

aapt command [ options ] files ...

KETERANGAN

Alat Pengemasan Aset Android (aapt) mengambil file sumber daya aplikasi Anda, seperti file AndroidManifest.xml dan file XML untuk Aktivitas Anda, dan mengompilasinya. R.java juga diproduksi sehingga Anda dapat mereferensikan sumber daya Anda dari kode Java Anda.

PILIHAN

Ringkasan opsi disertakan di bawah ini.

-a

cetak data khusus Android (sumber daya, manifes) saat mendaftar

-c

tentukan konfigurasi mana yang akan disertakan. Standarnya adalah semua konfigurasi. Nilai parameter harus berupa daftar nilai konfigurasi yang dipisahkan koma. Lokal harus ditentukan sebagai pasangan bahasa atau bahasa-wilayah. Beberapa contoh: en port,en port,land,en_US

Jika Anda memasukkan lokal khusus, zz_ZZ ke dalam daftar, itu akan melakukan pseudolokalisasi pada lokal default, memodifikasi semua string sehingga Anda dapat mencari string yang melewatkan proses internasionalisasi. Contoh: port,land,zz_ZZ

-d

satu atau beberapa aset perangkat untuk disertakan, dipisahkan dengan koma

-f

memaksa menimpa file yang ada

-g

tentukan toleransi piksel untuk memaksa gambar ke skala abu-abu, default 0

-j

tentukan file jar atau zip yang berisi kelas untuk disertakan

-k

jalur sampah file ditambahkan

-m

buat direktori paket di bawah lokasi yang ditentukan oleh -J

-u

perbarui paket yang ada (tambahkan yang baru, ganti yang lama, hapus file yang dihapus)

-v

keluaran bertele-tele

-x

membuat ID sumber daya perluasan (non-aplikasi).

-z

memerlukan pelokalan atribut sumber daya yang ditandai dengan localization="suggested"

-A

direktori tambahan untuk menemukan file aset mentah

-G

File untuk menampilkan opsi proguard.

-F

tentukan file apk untuk output

-I

tambahkan paket yang sudah ada ke base include set

-J

tentukan di mana akan menampilkan definisi konstanta sumber daya R.java

-M

tentukan path lengkap ke AndroidManifest.xml untuk disertakan dalam zip

-P

tentukan di mana harus mengeluarkan definisi sumber daya publik

-S

direktori di mana untuk menemukan sumber daya. Beberapa direktori akan dipindai dan kecocokan pertama yang ditemukan (dari kiri ke kanan) akan diutamakan.

-0

menentukan ekstensi tambahan yang file tersebut tidak akan disimpan terkompresi di .apk. String kosong berarti tidak memampatkan file sama sekali.

--debug-mode

menyisipkan android:debuggable="true" ke node aplikasi manifes, membuat aplikasi dapat di-debug bahkan di perangkat produksi.

--min-sdk-version

menyisipkan android:minSdkVersion ke dalam manifes. Jika versinya 7 atau lebih tinggi, pengkodean default untuk sumber daya akan berada di UTF-8.

--target-sdk-version

menyisipkan android:targetSdkVersion ke dalam manifes.

--max-res-version

mengabaikan direktori sumber daya berversi di atas nilai yang diberikan.

--values

bila digunakan dengan "buang sumber daya" juga menyertakan nilai sumber daya.

--version-code

menyisipkan android:versionCode ke dalam manifes.

--version-name

menyisipkan android:versionName ke dalam manifes.

--custom-package

menghasilkan R.java ke dalam paket yang berbeda.

--extra-packages

menghasilkan R.java untuk perpustakaan. Pisahkan perpustakaan dengan ':'.

--generate-dependencies

menghasilkan file ketergantungan di direktori yang sama untuk R.java dan paket sumber daya

--auto-add-overlay

Tambahkan sumber daya yang hanya ada di overlay secara otomatis.

--preferred-configurations

Seperti opsi -c untuk memfilter konfigurasi yang tidak diperlukan, tetapi hanya menyatakan preferensi. Jika tidak ada sumber daya yang tersedia dengan konfigurasi pilihan maka tidak akan dihapus.

--rename-manifest-package

Tulis ulang manifes sehingga nama paketnya adalah nama paket yang diberikan di sini. Nama kelas relatif (misalnya .Foo) akan diubah menjadi nama absolut dengan paket lama sehingga kode tidak perlu diubah.

--rename-instrumentation-target-package

Tulis ulang manifes agar semua komponen instrumentasinya menargetkan paket yang diberikan. Berguna bila digunakan bersamaan dengan --rename-manifest-package untuk memperbaiki pengujian terhadap paket yang telah diganti namanya.

--product

Menentukan varian mana yang akan dipilih untuk string yang memiliki varian produk

--utf16

mengubah penyandian default untuk sumber daya menjadi UTF-16. Hanya berguna saat level API disetel ke 7 atau lebih tinggi dengan penyandian default adalah UTF-8.

--non-constant-id

Jadikan ID sumber daya tidak konstan. Ini diperlukan untuk membuat kelas R java yang tidak berisi nilai akhir tetapi digunakan untuk membuat pustaka terkompilasi yang dapat digunakan kembali yang perlu mengakses sumber daya.

--error-on-failed-insert

Memaksa aapt untuk mengembalikan kesalahan jika gagal memasukkan nilai ke dalam manifes dengan --debug-mode, --min-sdk-version, --target-sdk-version --version-code dan --version-name. Penyisipan biasanya gagal jika manifes sudah menentukan atribut.

--output-text-symbols

Menghasilkan file teks yang berisi simbol sumber daya kelas R di folder yang ditentukan.

--ignore-assets

Aset yang harus diabaikan.

CONTOH

Daftar konten arsip yang kompatibel dengan Zip:

aapt l[ist] [-v] [-a] file.{zip,jar,apk}

Nilai buang:

aapt d[ump] [--values] SUBJECT file.{apk} [asset [asset ...]]

SUBJEK bisa berupa:

strings

Cetak konten kumpulan string tabel sumber daya di APK.

badging

Cetak label dan ikon untuk aplikasi yang dideklarasikan di APK.

permissions

Cetak izin dari APK.

resources

Cetak tabel sumber daya dari APK.

configurations

Cetak konfigurasi di APK.

xmltree

Cetak xml yang dikompilasi dalam aset yang diberikan.

xmlstrings

Cetak string dari aset xml terkompilasi yang diberikan.

Kemas sumber daya android. Ini akan membaca aset dan sumber daya yang disertakan dengan argumen -M -A -S atau raw-files-dir. Opsi -J -P -F dan -R mengontrol file mana yang dihasilkan:

aapt p[ackage] [-d] [-f] [-m] [-u] [-v] [-x] [-z] [-M AndroidManifest.xml] [-0 extension [-0 extension ...]] [-g tolerance] [-j jarfile] [--debug-mode] [--min-sdk-version VAL] [--target-sdk-version VAL] [--app-version VAL] [--app-version-name TEXT] [--custom-package VAL] [--rename-manifest-package PACKAGE] [--rename-instrumentation-target-package PACKAGE] [--utf16] [--auto-add-overlay] [--max-res-version VAL] [-I base-package [-I base-package ...]] [-A asset-source-dir] [-G class-list-file] [-P public-definitions-file] [-S resource-sources [-S resource-sources ...]] [-F apk-file] [-J R-file-dir] [--product product1,product2,...] [-c CONFIGS] [--preferred-configurations CONFIGS] [raw-files-dir [raw-files-dir] ...] [--output-text-symbols DIR]

Hapus file tertentu dari arsip yang kompatibel dengan Zip:

aapt r[emove] [-v] file.{zip,jar,apk} file1 [file2 ...] 

Tambahkan file tertentu ke arsip yang kompatibel dengan Zip:

aapt a[dd] [-v] file.{zip,jar,apk} file1 [file2 ...]

Lakukan PNG preprocessing pada satu atau beberapa folder resource dan simpan hasilnya di folder output:

aapt c[runch] [-v] -S resource-sources ... -C output-folder ... 

Lakukan preprocessing PNG pada satu file:

aapt s[ingleCrunch] [-v] -i input-file -o outputfile 

Cetak versi program:

aapt v[ersion]

PENGARANG

aapt ditulis oleh The Android Open Source Project.