AAPT2

AAPT2 (Android Asset Packaging Tool) ist ein Build-Tool, das von Android Studio und dem Android Gradle-Plug-in verwendet wird, um die Ressourcen Ihrer App zu kompilieren und zu verpacken. AAPT2 parst, indexiert und kompiliert die Ressourcen in ein binäres Format, das für die Android-Plattform optimiert ist.

In Android-Gradle-Plug-in 3.0.0 und höher ist AAPT2 standardmäßig aktiviert. Normalerweise müssen Sie aapt2 nicht selbst aufrufen. Wenn Sie jedoch lieber Ihr Terminal und Ihr eigenes Buildsystem anstelle von Android Studio verwenden möchten, können Sie AAPT2 über die Befehlszeile nutzen. Sie können Build-Fehler im Zusammenhang mit AAPT2 auch über die Befehlszeile beheben. Dazu finden Sie AAPT2 als eigenständiges Tool in den Android SDK Build Tools ab Version 26.0.2.

Wenn Sie die Android SDK Build Tools über die Befehlszeile herunterladen möchten, verwenden Sie sdkmanager und führen Sie den folgenden Befehl aus:

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

Nachdem Sie die SDK-Build-Tools heruntergeladen haben, finden Sie AAPT2 unter android_sdk/build-tools/version/.

Da Revisionen der Android SDK Build Tools nicht oft veröffentlicht werden, ist die in Ihren SDK Build Tools enthaltene Version von AAPT2 möglicherweise nicht die neueste. Die aktuelle Version von AAPT2 kann aus Google Maven heruntergeladen werden.

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 die schnellere Kompilierung von Ressourcen durch die Möglichkeit der inkrementellen Kompilierung. Für die inkrementelle Kompilierung wird die Ressourcenverarbeitung in zwei Schritte unterteilt:

• Kompilieren: Kompiliert Ressourcendateien in binäre Formate.
• Link: Alle kompilierten Dateien werden zusammengeführt und in einem einzigen Paket verpackt.

Diese Trennung trägt dazu bei, die Leistung für inkrementelle Builds zu verbessern. Wenn beispielsweise Änderungen an einer einzelnen Datei vorgenommen wurden, müssen Sie nur diese Datei neu kompilieren.

AAPT2 von Google Maven herunterladen

Wenn Sie die neueste Version von AAPT2 verwenden möchten, die nicht in den Build-Tools enthalten ist, laden Sie AAPT2 aus dem Maven-Repository von Google herunter:

1. Rufen Sie im Repository-Index com.android.tools.build > aapt2 auf.
2. Kopieren Sie den Namen der neuesten Version von AAPT2.

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

   Wenn Sie beispielsweise die Version 3.2.0-alpha18-4804415 für Windows herunterladen möchten, verwenden Sie folgenden Link: 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. Der Download von AAPT2 beginnt in Kürze.

5. Entpacken Sie die JAR-Datei, die Sie gerade heruntergeladen haben.

   Die JAR-Datei sollte eine ausführbare Datei aapt2 und einige Bibliotheken enthalten, von denen die ausführbare Datei abhängt.

Kompilieren

AAPT2 unterstützt die Kompilierung aller Android-Ressourcentypen, z. B. Drawables und XML-Dateien. Wenn Sie AAPT2 für die Kompilierung aufrufen, übergeben Sie pro Aufruf eine einzelne Ressourcendatei als Eingabe. AAPT2 parst die Datei und generiert eine binäre Zwischendatei mit der Erweiterung .flat.

Wenn Sie ganze Verzeichnisse übergeben, kompiliert AAPT2 alle Dateien im Verzeichnis neu, auch wenn sich nur eine Ressource geändert hat. Sie können zwar mit dem Flag --dir Ressourcenverzeichnisse mit mehr als einer Ressourcendatei an AAPT2 übergeben, aber so profitieren Sie nicht von der inkrementellen Ressourcenkompilierung.

Die Ausgabedateitypen können je nach Eingabe für die Kompilierung variieren, wie in der folgenden Tabelle dargestellt:

Tabelle 1 Die Ein- und Ausgabedateitypen für die Kompilierung

Die von AAPT2 ausgegebenen Dateien sind keine ausführbaren Dateien. Sie müssen diese Binärdateien später als Eingabe in die Link-Phase einfügen, um ein APK zu generieren. Die generierte APK-Datei ist jedoch keine ausführbare Datei, die Sie sofort auf einem Android-Gerät bereitstellen können, da sie keine DEX-Dateien enthält und nicht signiert ist.

Syntax kompilieren

Die allgemeine Syntax für die Verwendung von compile lautet so:

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

Im folgenden Beispiel kompiliert AAPT2 die 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 gezeigt, hängt der Name der Ausgabedatei vom Namen der Eingabedatei und des übergeordneten Verzeichnisses ab.

Im vorherigen Beispiel mit der Datei strings.xml als Eingabe benennt aapt2 die Ausgabedatei automatisch als values-en_strings.arsc.flat. Die kompilierte Drawable-Datei im Drawable-Verzeichnis heißt jedoch drawable_img.png.flat.

Kompilierungsoptionen

Mit dem Befehl compile können Sie verschiedene Optionen verwenden, wie in Tabelle 2 dargestellt:

Tabelle 2 Optionen für den Compile-Befehl

Link

In der Link-Phase führt AAPT2 alle Zwischendateien zusammen, die in der Kompilierungsphase generiert werden, z. B. Ressourcentabellen, binäre XML-Dateien und verarbeitete PNG-Dateien. Anschließend werden die Dateien in einem einzelnen APK verpackt. Außerdem können in dieser Phase andere Hilfsdateien wie R.java und ProGuard-Regeldateien generiert werden. Das generierte APK enthält jedoch keinen DEX-Bytecode und ist nicht signiert. Sie können dieses APK nicht auf einem Gerät bereitstellen.

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

Link-Syntax

Die allgemeine Syntax für die 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, drawable_Image.flat und values_values.arsc.flat, sowie die Datei AndroidManifest.xml zusammen. AAPT2 verknüpft das Ergebnis mit der Datei android.jar, 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 den Link-Befehl

Erfassen

dump wird verwendet, um Informationen zum APK auszugeben, das Sie mit dem Befehl link generiert haben.

Dump-Syntax

Die allgemeine Syntax für die Verwendung von dump lautet so:

aapt2 dump sub-command filename.apk [options]

Im folgenden Beispiel wird der Inhalt der Ressourcentabelle des angegebenen APK ausgegeben:

aapt2 dump resources output.apk

Unterbefehle für „dump“

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

Tabelle 4. Unterbefehle für „dump“

Dump-Optionen

Verwenden Sie die folgenden Optionen mit dump:

Tabelle 5. Dump-Optionen

Unterschied

Mit diff können Sie zwei APKs vergleichen und Unterschiede zwischen ihnen ermitteln.

Diff-Syntax

Die allgemeine Syntax für die 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 ausgeführt, bevor sie in das APK gepackt werden. Durch diese Optimierung kann die APK-Größe je nach Größe und Anzahl der verwendeten Ressourcen um etwa 1–3 % reduziert werden.

Syntax optimieren

Die allgemeine Syntax für die 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 erstellt. Sie ersetzt die übliche flache Tabellendarstellung durch eine kompaktere Darstellung, was zu einer Verkleinerung der APK-Größe, einer Reduzierung der Speichernutzung und der Startlatenz sowie zu einer geringfügigen Erhöhung der einzelnen Ressourcensuchzeit nach dem Start führt.

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

Optionen für die Optimierung

Sie können die folgenden Optionen mit optimize verwenden:

Tabelle 6. Optionen für die Optimierung

Umwandeln

Standardmäßig kompiliert der AAPT-Befehl compile Ressourcen in ein binäres Format, das für APKs geeignet ist. Sie können auch das Protobuf-Format angeben, das für AABs geeignet ist, indem Sie --proto-format angeben. Mit dem Befehl convert werden APKs zwischen den beiden Formaten konvertiert.

Syntax umstellen

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 erstellt. Sie ersetzt die übliche Darstellung in einer flachen Tabelle durch eine kompaktere Darstellung. Dadurch werden APK-Größe, Arbeitsspeichernutzung und Startlatenz reduziert und die

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

Konvertierungsoptionen

Verwenden Sie die folgenden Optionen mit convert:

Tabelle 7. Konvertierungsoptionen

Daemon-Modus

Mit AAPT-Version 2.19 wurde der Daemon-Modus für die Ausführung von Befehlen eingeführt. Im Daemon-Modus können Sie mehrere Befehle in einer einzigen 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 Befehls muss in einer separaten Zeile stehen. Am Ende des Befehls muss eine leere Zeile eingefügt werden. Beenden Sie den Daemon-Modus mit Strg+D.

Beachten 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 so eingegeben werden:

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. Dadurch wird ein systrace-JSON-Trace-Fragment für den angegebenen folder generiert.

Version

Ermitteln Sie die Version von AAPT2, die Sie verwenden, mit dem Befehl version:

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, das jetzt verworfen wurde. AAPT2 sollte sofort mit älteren Projekten funktionieren. In diesem Abschnitt werden jedoch einige Verhaltensänderungen beschrieben, die Sie beachten sollten.

Elementhierarchien im Android-Manifest

In früheren Versionen von AAPT wurden Elemente, die in der Datei AndroidManifest.xml in falschen Knoten verschachtelt waren, entweder ignoriert oder es wurde eine Warnung ausgegeben. Betrachten Sie beispielsweise das folgende 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 von AAPT wurde das falsch platzierte <action>-Tag einfach ignoriert.

Mit AAPT2 erhalten Sie den folgenden Fehler:

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

Achten Sie darauf, dass die Manifestelemente richtig verschachtelt sind, um das Problem zu beheben. Weitere Informationen finden Sie in der Übersicht über App-Manifeste.

Ressourcendeklaration

Sie können den Typ einer Ressource 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>

Wenn Sie einen Ressourcentyp auf diese Weise deklarieren, erhalten Sie den folgenden Build-Fehler:

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

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

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

Wenn Sie ein <style>-Element deklarieren, muss das übergeordnete Element außerdem ein Stilressourcentyp sein. Andernfalls wird ein Fehler wie der folgende angezeigt:

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

Falsche Verwendung von @-Symbolen für Ressourcenreferenzen

AAPT2 gibt Build-Fehler aus, wenn Sie Ressourcenzuweisungssymbole (@) weglassen oder falsch platzieren. Wenn Sie das Symbol beispielsweise beim Angeben eines Stilattributs weglassen:

<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 fälschlicherweise einfügen:

...
<!-- 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 von Bibliotheken

Wenn Ihre App von einer Drittanbieterbibliothek abhängig ist, die mit älteren Versionen der Android SDK Build Tools erstellt wurde, kann es sein, dass Ihre App zur Laufzeit abstürzt, ohne dass Fehler oder Warnungen angezeigt werden. Dieser Absturz kann auftreten, weil die R.java-Felder beim Erstellen der Bibliothek als final deklariert werden. Daher sind alle Ressourcen-IDs in den Klassen der Bibliothek inline enthalten.

AAPT2 muss beim Erstellen Ihrer App IDs für Bibliotheksressourcen neu zuweisen können. Wenn die Bibliothek davon ausgeht, dass die IDs final sind, und sie in den DEX-Code der Bibliothek einfügt, kommt es zu einer Laufzeitabweichung.

Wenden Sie sich an den Autor der Bibliothek, um die Bibliothek mit der neuesten Version der Android SDK-Build-Tools neu zu erstellen und neu zu veröffentlichen.