aapt - referenční příručka, možnosti, příklady příkazů


NÁZEV

aapt - Nástroj pro balení aktiv Android

SYNOPSE

aapt command [ options ] files ...

POPIS

Nástroj Android Asset Packaging Tool (aapt) vezme zdrojové soubory vaší aplikace, jako je soubor AndroidManifest.xml a soubory XML pro vaše aktivity, a zkompiluje je. Je také vytvořen R.java, takže můžete odkazovat na své zdroje z kódu Java.

MOŽNOSTI

Souhrn možností je uveden níže.

-a

tisknout data specifická pro Android (zdroje, manifest) při výpisu

-c

určete, které konfigurace se mají zahrnout. Výchozí nastavení jsou všechny konfigurace. Hodnota parametru by měla být čárkou oddělený seznam konfiguračních hodnot. Místní prostředí by měla být zadána jako pár jazyk nebo jazyk-region. Některé příklady: en port,en port,land,en_US

Pokud do seznamu vložíte speciální národní prostředí, zz_ZZ, provede pseudolokalizaci ve výchozím národním prostředí a upraví všechny řetězce, abyste mohli hledat řetězce, které proces internacionalizace neprošly. Například: port,land,zz_ZZ

-d

jeden nebo více prostředků zařízení, které chcete zahrnout, oddělené čárkami

-f

vynutit přepsání existujících souborů

-g

určete toleranci v pixelech pro vynucení zobrazení ve stupních šedi, výchozí 0

-j

zadejte soubor jar nebo zip obsahující třídy, které chcete zahrnout

-k

přidaná nevyžádaná cesta k souboru(ům).

-m

vytvořit adresáře balíčků v umístění určeném parametrem -J

-u

aktualizovat stávající balíčky (přidat nové, nahradit starší, odstranit smazané soubory)

-v

podrobný výstup

-x

vytvořit rozšiřující (neaplikační) ID prostředků

-z

vyžadovat lokalizaci atributů prostředků označených localization="suggested"

-A

další adresář, ve kterém lze najít nezpracované soubory aktiv

-G

Soubor, do kterého se mají vytisknout volby proguard.

-F

zadejte soubor apk, který se má vytisknout

-I

přidat existující balíček k základní sadě include

-J

určete, kam se mají vytisknout definice konstant prostředků R.java

-M

zadejte úplnou cestu k souboru AndroidManifest.xml, který chcete zahrnout do souboru zip

-P

určete, kam se mají vytisknout definice veřejných zdrojů

-S

adresář, ve kterém lze najít zdroje. Bude prohledáno více adresářů a první nalezená shoda (zleva doprava) bude mít přednost.

-0

určuje další příponu, pro kterou nebudou takové soubory uloženy komprimované v souboru .apk. Prázdný řetězec znamená, že nebudou komprimovány žádné soubory.

--debug-mode

vloží android:debuggable="true" do aplikačního uzlu manifestu, díky čemuž bude aplikace laditelná i na produkčních zařízeních.

--min-sdk-version

vloží android:minSdkVersion do manifestu. Pokud je verze 7 nebo vyšší, výchozí kódování zdrojů bude v UTF-8.

--target-sdk-version

vloží android:targetSdkVersion do manifestu.

--max-res-version

ignoruje adresáře prostředků s verzemi nad danou hodnotou.

--values

při použití s "výpisem zdrojů" zahrnuje také hodnoty zdrojů.

--version-code

vloží android:versionCode do manifestu.

--version-name

vloží android:versionName do manifestu.

--custom-package

vygeneruje R.javu do jiného balíčku.

--extra-packages

generovat R.javu pro knihovny. Knihovny oddělte ':'.

--generate-dependencies

generovat soubory závislostí ve stejných adresářích pro R.java a balíček prostředků

--auto-add-overlay

Automaticky přidávejte zdroje, které jsou pouze v překryvných vrstvách.

--preferred-configurations

Stejně jako volba -c pro odfiltrování nepotřebných konfigurací, ale vyjadřuje pouze preference. Pokud není k dispozici žádný zdroj s preferovanou konfigurací, nebude odebrán.

--rename-manifest-package

Přepište manifest tak, aby jeho název balíčku odpovídal zde uvedenému názvu balíčku. Relativní názvy tříd (například .Foo) budou se starým balíčkem změněny na absolutní názvy, aby se kód nemusel měnit.

--rename-instrumentation-target-package

Přepište manifest tak, aby všechny jeho instrumentační komponenty cílily na daný balíček. Užitečné při použití ve spojení s --rename-manifest-package k opravě testů proti balíčku, který byl přejmenován.

--product

Určuje, kterou variantu vybrat pro řetězce, které mají varianty produktu

--utf16

změní výchozí kódování zdrojů na UTF-16. Užitečné pouze tehdy, když je úroveň API nastavena na 7 nebo vyšší, kde je výchozí kódování UTF-8.

--non-constant-id

Zajistěte, aby ID prostředků nebylo konstantní. To je nutné k vytvoření třídy java R, která neobsahuje konečnou hodnotu, ale používá se k vytváření opakovaně použitelných kompilovaných knihoven, které potřebují přístup ke zdrojům.

--error-on-failed-insert

Vynutí, aby aapt vrátil chybu, pokud se mu nepodaří vložit hodnoty do manifestu s --debug-mode, --min-sdk-version, --target-sdk-version --version-code a --version-name. Vložení se obvykle nezdaří, pokud manifest již atribut definuje.

--output-text-symbols

Vygeneruje textový soubor obsahující symboly prostředků třídy R v zadané složce.

--ignore-assets

Aktiva, která mají být ignorována.

PŘÍKLADY

Seznam obsahu archivu kompatibilního se Zip:

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

Hodnoty výpisu:

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

SUBJECT může být:

strings

Vytiskněte obsah fondu řetězců tabulky zdrojů v souboru APK.

badging

Vytiskněte štítek a ikonu pro aplikaci deklarovanou v APK.

permissions

Vytiskněte oprávnění z APK.

resources

Vytiskněte tabulku zdrojů z APK.

configurations

Vytiskněte konfigurace v souboru APK.

xmltree

Vytiskněte zkompilované xmls v daných aktivech.

xmlstrings

Vytiskněte řetězce daných kompilovaných xml aktiv.

Zabalte zdroje pro Android. Přečte aktiva a zdroje, které jsou dodávány s argumenty -M -A -S nebo raw-files-dir. Volby -J -P -F a -R určují, které soubory budou vytištěny:

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]

Smazat zadané soubory z archivu kompatibilního se Zip:

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

Přidejte určené soubory do archivu kompatibilního se Zip:

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

Proveďte předběžné zpracování PNG v jedné nebo několika složkách zdrojů a uložte výsledky do výstupní složky:

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

Proveďte předběžné zpracování PNG na jednom souboru:

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

Verze programu pro tisk:

aapt v[ersion]

AUTOR

aapt byl napsán The Android Open Source Project.