AAPT2 (AAPT 2)

AAPT2 (Android Asset Packaging Tool) ist ein Build-Tool, das von Android Studio Android-Gradle-Plug-in zum Kompilieren und Verpacken der Ressourcen AAPT2 parst, indexiert, und kompiliert die Ressourcen in einem Binärformat, das für den Android-Plattform.

Ab Android-Gradle-Plug-in 3.0.0 wird AAPT2 standardmäßig aktiviert. Ich normalerweise nicht selbst aapt2 aufrufen. Wenn Sie jedoch Ihr Terminal und Ihr eigenes Build-System anstelle von Android Studio verwenden, können Sie AAPT2 über die Befehlszeile ausführen. Du kannst auch Build-Fehler im Zusammenhang mit AAPT2 beheben über die Befehlszeile eingeben. Suchen Sie dazu AAPT2 als eigenständiges Tool in Android SDK Build Tools 26.0.2 und höher.

Um Android SDK Build Tools über die Befehlszeile herunterzuladen, verwenden Sie sdkmanager und führen Sie den folgenden Befehl aus:

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

Nachdem du die SDK Build Tools heruntergeladen hast, suche AAPT2 in android_sdk/build-tools/version/

Weil Versionen der Android SDK Build Tools nicht veröffentlicht werden Häufig ist die in deinen SDK-Build-Tools enthaltene Version von AAPT2 möglicherweise nicht die auf dem neuesten Stand. Um die neueste Version von AAPT2 zu erhalten, laden Sie AAPT2 von Google Maven herunter.

Wenn Sie AAPT2 über die Befehlszeile unter Linux oder Mac verwenden möchten, führen Sie den Befehl aapt2 aus. Führen Sie unter Windows den Befehl aapt2.exe aus.

AAPT2 unterstützt eine schnellere Kompilierung von Ressourcen, indem inkrementelle Kompilierung. Um eine inkrementelle Kompilierung zu erreichen, ist die Ressourcenverarbeitung in zwei Schritte unterteilt:

• Kompilieren: Die Ressourcendateien werden in Binärformate kompiliert.
• Link: Führt alle kompilierten Dateien zusammen und verpackt sie zu einer einzigen Datei Paket.

Diese Trennung trägt dazu bei, die Leistung inkrementeller Builds zu verbessern. Beispiel: Wenn eine einzelne Datei Änderungen enthält, müssen Sie nur diese Datei neu kompilieren.

AAPT2 von Google Maven herunterladen

Um die neueste Version von AAPT2 zu erhalten, die nicht in den Build-Tools enthalten ist, Laden Sie AAPT2 wie folgt aus dem Maven-Repository von Google herunter:

1. Gehen Sie im Repository-Index zu den com.android.tools.build > aapt2.
2. Kopiere den Namen der neuesten Version von AAPT2.

3. Fügen Sie den kopierten Versionsnamen in die folgende URL ein und geben Sie Ihre Zielbetriebssystem: https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/ aapt2-version/aapt2-aapt2-version- [windows | linux | osx].jar

   Um beispielsweise die Version 3.2.0-alpha18-4804415 für Windows herunterzuladen, verwenden Sie: 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. Rufen Sie die URL in einem Browser auf. AAPT2 wird in Kürze heruntergeladen.

5. Entpacken Sie die gerade heruntergeladene JAR-Datei.

   Die JAR-Datei sollte eine ausführbare aapt2 und einige Bibliotheken enthalten, die vom ausgeführt werden kann.

Kompilieren

AAPT2 unterstützt die Kompilierung aller Android-Ressourcentypen wie und XML-Dateien. Wenn Sie AAPT2 zur Kompilierung aufrufen, übergeben Sie eine einzelne Ressourcendatei als Eingabe pro Aufruf. AAPT2 parst die Datei dann. und generiert eine Zwischenbinärdatei mit der Erweiterung .flat.

Bei der Übergabe ganzer Verzeichnisse kompiliert AAPT2 alle Dateien im Verzeichnis neu auch wenn sich nur eine Ressource geändert hat. Sie können zwar Ressourcen Verzeichnisse mit mehr als einer Ressourcendatei in AAPT2 über das --dir können Sie auf diese Weise nicht von den Vorteilen der inkrementellen Ressourcenkompilierung profitieren.

Die Ausgabedateitypen können sich je nach Eingabe unterscheiden, die Sie für die Kompilierung bereitstellen. wie in der folgenden Tabelle dargestellt:

Tabelle 1 Die Ein- und Ausgabedatei Typen für die Kompilierung

Die von AAPT2 ausgegebenen Dateien sind keine ausführbaren Dateien und müssen später eingefügt werden Binärdateien als Eingabe in die Verknüpfungsphase ein, um ein APK zu generieren. Die Die generierte APK-Datei ist keine ausführbare Datei, die du auf einem Android-Gerät bereitstellen kannst. da es keine DEX-Dateien enthält und nicht unterzeichnet.

Syntax kompilieren

Die allgemeine Syntax zur Verwendung von compile lautet so:

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

Im folgenden Beispiel kompiliert AAPT2 Ressourcendateien mit den Namen values.xml und myImage.png einzeln:

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/

Wie in Tabelle 1 dargestellt, hängt der Name der Ausgabedatei von der Eingabe filename und den Namen des übergeordneten Verzeichnisses.

Für das vorherige Beispiel mit der Datei strings.xml als Eingabe aapt2 automatisch nennt die Ausgabedatei values-en_strings.arsc.flat. Die kompilierten Die im Drawable-Verzeichnis gespeicherte Drawable-Datei heißt drawable_img.png.flat.

Optionen kompilieren

Es gibt mehrere Optionen, die Sie mit dem Befehl compile verwenden können: in Tabelle 2:

Tabelle 2: Befehlsoptionen kompilieren

Link

In der Verknüpfungsphase führt AAPT2 alle Zwischendateien zusammen, die von der Kompilierung in der Phase erzeugt, wie Ressourcentabellen, binäre XML-Dateien und verarbeitete PNGs. und packt die Dateien dann in einem einzigen APK. Darüber hinaus haben andere Zusätzliche Dateien wie R.java- und ProGuard-Regeldateien können generiert werden. während dieser Phase. Das generierte APK enthält jedoch keinen DEX-Bytecode und ist nicht signiert. Du kannst dieses APK nicht auf einem Gerät bereitstellen.

Wenn Sie das Android-Gradle-Plug-in nicht verwenden, App über die Befehlszeile erstellen, können Sie andere Befehlszeilentools wie d8 zum Kompilieren verwenden Java-Bytecode in DEX-Bytecode und apksigner um Ihr APK zu signieren.

Link syntax

Die allgemeine Syntax zur Verwendung von link lautet so:

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

Im folgenden Beispiel führt AAPT2 zwei Zwischendateien zusammen, drawable_Image.flat und values_values.arsc.flat sowie die AndroidManifest.xml-Datei. AAPT2 verknüpft das Ergebnis mit dem android.jar -Datei, die die im Paket android definierten Ressourcen enthält:

 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

Linkoptionen

Mit dem Befehl link können Sie die folgenden Optionen verwenden:

Tabelle 3 Optionen für Linkbefehle

Erfassen

Mit dump werden Informationen zum APK gedruckt, das du mithilfe des link-Befehl.

Dump-Syntax

Die allgemeine Syntax zur Verwendung von dump lautet so:

aapt2 dump sub-command filename.apk [options]

Im folgenden Beispiel werden Inhalte aus der Ressourcentabelle der angegebenen APK:

aapt2 dump resources output.apk

Dump-Unterbefehle

Geben Sie mit dem Befehl dump einen der folgenden Unterbefehle an:

Tabelle 4 Dump-Unterbefehle

Dumpoptionen

Verwenden Sie die folgenden Optionen mit dump:

Tabelle 5 Dumpoptionen

Unterschied

Verwende diff, um zwei APKs zu vergleichen und Unterschiede zwischen ihnen zu identifizieren.

Differenz-Syntax

Die allgemeine Syntax zur Verwendung von diff lautet so:

aapt2 diff first.apk second.apk

Für den Befehl diff gibt es keine Optionen.

Optimieren

Mit optimize werden Optimierungen für die zusammengeführten Ressourcen und resources.arsc, bevor sie in das APK gepackt werden. Diese Optimierung die APK-Größe um etwa 1–3 % reduzieren, je nach Größe und Anzahl der die genutzt werden.

Optimize-Syntax

Die allgemeine Syntax zur Verwendung von optimize lautet so:

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

Im folgenden Beispiel werden die Ressourcen in input.apk optimiert und ein neues, optimiertes APK in output.apk. Sie ersetzt die übliche Darstellung in einer flachen Tabelle. mit einem kompakteren binären Suchbaum, was zu einem kleineren APK auf der Kosten für die Abrufleistung:

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

Optimize-Optionen

Mit optimize können Sie die folgenden Optionen verwenden:

Tabelle 6 Optimize-Optionen

Umwandeln

Standardmäßig kompiliert der AAPT-Befehl compile Ressourcen in einem Binärformat das für APKs geeignet ist. Sie können auch das protobuf-Format angeben der für AABs geeignet ist, indem Sie --proto-format angeben. Das convert werden APKs zwischen den beiden Formaten konvertiert.

Syntax konvertieren

Die allgemeine Syntax für convert lautet so:

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

Im folgenden Beispiel werden die Ressourcen in input.apk konvertiert und ein neues, APK in output.apk mit Ressourcen im protobuf-Format. Sie ersetzt die üblichen Darstellung einer flachen Tabelle mit einer kompakteren binären Suchstruktur, die in einem kleineren APK auf Kosten der Abrufleistung:

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

Konvertierungsoptionen

Verwenden Sie die folgenden Optionen mit convert:

Tabelle 7 Umwandlungsoptionen

Daemon-Modus

Mit AAPT-Version 2.19 wurde der Daemon-Modus für die Ausgabe von Befehlen eingeführt. Mit dem Daemon-Modus mehrere Befehle in einer AAPT-Sitzung eingeben.

Daemon-Syntax

Starten Sie den Daemon-Modus mit dem folgenden Befehl:

aapt2 daemon

Sobald der Daemon-Modus ausgeführt wird, können Sie Befehle eingeben. Jedes Argument des -Befehl muss sich in einer separaten Zeile mit einer Leerzeile am Ende des Befehls befinden. Beenden Sie den Daemon-Modus, indem Sie Strg+D drücken.

Betrachten Sie die folgenden einzelnen compile-Befehle:

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/

Diese Befehle können im Daemon-Modus eingegeben werden als:

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

Optionen für den Daemon-Modus

Die einzige Option für den Daemon-Modus ist --trace-folder folder, die ein systrace-JSON generiert Trace-Fragment auf die angegebene folder.

Version

Bestimme die Version von AAPT2, die du mit dem Befehl version verwendest:

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

Verhaltensänderungen bei Verwendung von AAPT2

Vor AAPT2 war AAPT die Standardversion des Android Asset Packaging Tool, die mittlerweile eingestellt wurde. Obwohl AAPT2 sofort mit älteren Projekten enthält, werden in diesem Abschnitt einige Verhaltensänderungen beschrieben, die Sie bewusst sind.

Elementhierarchien im Android-Manifest

In früheren Versionen von AAPT waren Elemente, die in falschen Knoten in der AndroidManifest.xml Datei wurde entweder ignoriert oder es wurde eine Warnung ausgegeben. Hier ein Beispiel:

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

In früheren Versionen des AAPT wurde das falsch platzierte <action>-Tag einfach ignoriert.

Mit AAPT2 wird der folgende Fehler angezeigt:

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

Um das Problem zu beheben, müssen Sie dafür sorgen, dass Ihre Manifestelemente richtig verschachtelt sind. Weitere Informationen finden Sie in den App-Manifest-Übersicht.

Angabe von Ressourcen

Sie können den Ressourcentyp nicht mehr über das Attribut name angeben. Im folgenden Beispiel wird ein attr-Ressourcenelement fälschlicherweise deklariert:

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

Die Deklaration eines Ressourcentyps auf diese Weise führt zu folgendem Build-Fehler:

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

Um diesen Fehler zu beheben, müssen Sie den Typ explizit mit type="attr" deklarieren:

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

Außerdem muss beim Deklarieren eines <style>-Elements das übergeordnete Element ebenfalls ein Ressourcentyp des Stils. Andernfalls erhalten Sie eine Fehlermeldung, die in etwa so aussieht:

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

Falsche Verwendung von @-Ressourcenreferenzsymbolen

AAPT2 gibt Build-Fehler aus, wenn Sie eine Ressource weglassen oder falsch platzieren Referenzsymbole (@). Wenn Sie z. B. das Symbol weglassen, durch Angabe eines Stilattributs:

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

Beim Erstellen des Moduls gibt AAPT2 den folgenden Build-Fehler aus:

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

Wenn Sie das Symbol beim Zugriff auf eine Ressource aus dem Namespace android:

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

Beim Erstellen des Moduls gibt AAPT2 den folgenden Build-Fehler aus:

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

Falsche Konfiguration der Bibliotheken

Wenn Ihre App von einer Bibliothek eines Drittanbieters abhängig ist, die mit älteren Versionen der Android SDK-Build-Tools verwenden, App während der Laufzeit abstürzen kann, ohne dass Fehler oder Warnungen angezeigt werden. Dieser Absturz kann auftreten, weil die R.java-Felder während der Erstellung der Bibliothek hat final deklariert. Daher werden alle Ressourcen-IDs in den in der Bibliothek an.

AAPT2 setzt voraus, dass die IDs den Bibliotheksressourcen beim Erstellen von für Ihre App. Wenn die Bibliothek annimmt, dass die IDs final sind, und sie inline eingefügt werden, Bibliothek DEX enthält, liegt eine Abweichung der Laufzeit vor.

Bitten Sie den Autor der Bibliothek, die Bibliothek neu zu erstellen, um diesen Fehler zu beheben Verwenden Sie die neueste Version der Android SDK Build Tools und veröffentlichen Sie die Bibliothek.