aapt - instrukcja obsługi, opcje, przykłady poleceń


NAZWA

aapt - Narzędzie do pakowania zasobów Androida

STRESZCZENIE

aapt command [ options ] files ...

OPIS

Narzędzie Android Asset Packaging Tool (aapt) pobiera pliki zasobów aplikacji, takie jak plik AndroidManifest.xml i pliki XML dla Twoich działań, i kompiluje je. Tworzony jest również R.java, dzięki czemu możesz odwoływać się do swoich zasobów z kodu Java.

OPCJE

Podsumowanie opcji znajduje się poniżej.

-a

drukuj dane specyficzne dla Androida (zasoby, manifest) podczas wyświetlania listy

-c

określić, które konfiguracje mają zostać uwzględnione. Wartością domyślną są wszystkie konfiguracje. Wartość parametru powinna być oddzieloną przecinkami listą wartości konfiguracyjnych. Ustawienia regionalne należy określić jako język lub parę język-region. Kilka przykładów: en port,en port,land,en_US

Jeśli umieścisz na liście specjalną lokalizację, zz_ZZ, wykona ona pseudolokalizację w domyślnej lokalizacji, modyfikując wszystkie ciągi, abyś mógł szukać ciągów, które pominęły proces internacjonalizacji. Na przykład: port,ląd,zz_ZZ

-d

co najmniej jedno urządzenie do uwzględnienia, oddzielone przecinkami

-f

wymusić nadpisanie istniejących plików

-g

określ tolerancję pikseli, aby wymusić obrazy w skali szarości, domyślnie 0

-j

określ plik jar lub zip zawierający klasy do uwzględnienia

-k

dodano śmieciową ścieżkę pliku(ów).

-m

utwórz katalogi pakietów w lokalizacji określonej przez -J

-u

aktualizować istniejące pakiety (dodawać nowe, zastępować starsze, usuwać usunięte pliki)

-v

Gadatliwe wyjście

-x

tworzyć rozszerzające (nieaplikacyjne) identyfikatory zasobów

-z

wymagaj lokalizacji atrybutów zasobów oznaczonych jako localization="sugerowane"

-A

dodatkowy katalog, w którym można znaleźć surowe pliki zasobów

-G

Plik do wyprowadzania opcji proguard.

-F

określ plik apk do wysłania

-I

dodaj istniejący pakiet do podstawowego zestawu dołączania

-J

określ, gdzie wyprowadzić definicje stałych zasobów R.java

-M

podaj pełną ścieżkę do pliku AndroidManifest.xml, który ma zostać uwzględniony w pliku ZIP

-P

określić, gdzie mają być wyprowadzane definicje zasobów publicznych

-S

katalog, w którym można znaleźć zasoby. Wiele katalogów zostanie przeskanowanych, a pierwsze znalezione dopasowanie (od lewej do prawej) będzie miało pierwszeństwo.

-0

określa dodatkowe rozszerzenie, dla którego takie pliki nie będą przechowywane w postaci skompresowanej w pliku .apk. Pusty ciąg znaków oznacza, że w ogóle nie należy kompresować żadnych plików.

--debug-mode

wstawia android:debuggable="true" do węzła aplikacji manifestu, umożliwiając debugowanie aplikacji nawet na urządzeniach produkcyjnych.

--min-sdk-version

wstawia android:minSdkVersion do manifestu. Jeśli wersja to 7 lub nowsza, domyślnym kodowaniem zasobów będzie UTF-8.

--target-sdk-version

wstawia android:targetSdkVersion do manifestu.

--max-res-version

ignoruje wersjonowane katalogi zasobów powyżej podanej wartości.

--values

użyte z „zasobami zrzutu” obejmuje również wartości zasobów.

--version-code

wstawia android:versionCode do manifestu.

--version-name

wstawia android:versionName do manifestu.

--custom-package

generuje R.java do innego pakietu.

--extra-packages

wygenerować R.java dla bibliotek. Oddziel biblioteki za pomocą „:”.

--generate-dependencies

generować pliki zależności w tych samych katalogach dla R.java i pakietu zasobów

--auto-add-overlay

Automatycznie dodawaj zasoby, które są tylko w nakładkach.

--preferred-configurations

Podobnie jak opcja -c do odfiltrowywania niepotrzebnych konfiguracji, ale wyraża tylko preferencje. Jeśli nie ma dostępnego zasobu z preferowaną konfiguracją, nie zostanie on usunięty.

--rename-manifest-package

Przepisz manifest tak, aby jego nazwa pakietu była nazwą pakietu podaną tutaj. Względne nazwy klas (na przykład .Foo) zostaną zmienione na nazwy bezwzględne w starym pakiecie, dzięki czemu kod nie będzie musiał się zmieniać.

--rename-instrumentation-target-package

Przepisz manifest tak, aby wszystkie jego składniki Instrumentacji były ukierunkowane na dany pakiet. Przydatne w połączeniu z opcją --rename-manifest-package w celu naprawienia testów na pakiecie, którego nazwa została zmieniona.

--product

Określa, który wariant wybrać dla ciągów zawierających warianty produktu

--utf16

zmienia domyślne kodowanie zasobów na UTF-16. Przydatne tylko wtedy, gdy poziom API jest ustawiony na 7 lub wyższy, gdzie domyślne kodowanie to UTF-8.

--non-constant-id

Ustaw identyfikator zasobów jako stały. Jest to wymagane do utworzenia klasy R Java, która nie zawiera wartości końcowej, ale jest używana do tworzenia skompilowanych bibliotek wielokrotnego użytku, które muszą uzyskiwać dostęp do zasobów.

--error-on-failed-insert

Wymusza na aapt zwrócenie błędu, jeśli nie uda się wstawić wartości do manifestu za pomocą opcji --debug-mode, --min-sdk-version, --target-sdk-version --version-code i --version-name. Wstawianie zwykle kończy się niepowodzeniem, jeśli manifest już definiuje atrybut.

--output-text-symbols

Generuje plik tekstowy zawierający symbole zasobów klasy R w określonym folderze.

--ignore-assets

Aktywa, które należy zignorować.

PRZYKŁADY

Wyświetl zawartość archiwum kompatybilnego z Zip:

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

Zrzut wartości:

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

TEMAT może być:

strings

Wydrukuj zawartość puli ciągów tabeli zasobów w pliku APK.

badging

Wydrukuj etykietę i ikonę aplikacji zadeklarowanej w pliku APK.

permissions

Wydrukuj uprawnienia z APK.

resources

Wydrukuj tabelę zasobów z pliku APK.

configurations

Wydrukuj konfiguracje w pliku APK.

xmltree

Wydrukuj skompilowane xml w podanych zasobach.

xmlstrings

Wydrukuj ciągi danych skompilowanych zasobów xml.

Spakuj zasoby Androida. Odczyta zasoby i zasoby, które są dostarczane z argumentami -M -A -S lub raw-files-dir. Opcje -J -P -F i -R kontrolują, które pliki są wysyłane:

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]

Usuń określone pliki z archiwum ZIP:

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

Dodaj określone pliki do archiwum ZIP:

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

Wykonaj wstępne przetwarzanie PNG w jednym lub kilku folderach zasobów i zapisz wyniki w folderze wyjściowym:

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

Wykonaj wstępne przetwarzanie PNG na pojedynczym pliku:

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

Wersja programu do drukowania:

aapt v[ersion]

AUTOR

aapt został napisany przez The Android Open Source Project.