AAPT2

AAPT2 (Android Asset Packaging Tool) è uno strumento di creazione che Android Studio e Il plug-in Android Gradle viene utilizzato per compilare e pacchettizzare il risorse. AAPT2 analizza, indicizza, e compila le risorse in un formato binario ottimizzato per la piattaforma Android.

Il plug-in Android Gradle 3.0.0 e versioni successive attiva AAPT2 per impostazione predefinita. Tu in genere non hanno bisogno di richiamare aapt2 autonomamente. Tuttavia, se preferisci utilizzare il tuo terminale e il tuo sistema di compilazione invece di Android Studio, puoi usare AAPT2 dalla riga di comando. Puoi anche eseguire il debug degli errori di build relativi ad AAPT2 dalla riga di comando. A questo scopo, cerca AAPT2 come strumento autonomo in Android Build Build Tools 26.0.2 e versioni successive.

Per scaricare Android SDK Build Tools dalla riga di comando, utilizza sdkmanager ed esegui questo comando:

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

Dopo aver scaricato SDK Build Tools, cerca AAPT2 in android_sdk/build-tools/version/.

Perché le revisioni di Android SDK Build Tools non vengono rilasciate spesso, la versione di AAPT2 inclusa negli SDK Build Tools potrebbe non essere più recenti. Per ottenere l'ultima versione di AAPT2: scarica AAPT2 da Google Maven.

Per usare AAPT2 dalla riga di comando su Linux o Mac, esegui il comando aapt2. Su Windows, esegui il comando aapt2.exe.

AAPT2 supporta una compilazione più rapida delle risorse abilitando compilation. Per realizzare una compilazione incrementale, separati in due passaggi:

• Compilazione: compila i file di risorse in formati binari.
• Link: unisce tutti i file compilati e li pacchettizza in un'unica pacchetto.

Questa separazione aiuta a migliorare le prestazioni delle build incrementali. Ad esempio: se ci sono modifiche in un singolo file, devi ricompilare solo quel file.

Scarica AAPT2 da Google Maven

Per ottenere la versione più recente di AAPT2 che non è inclusa negli strumenti di creazione, scarica AAPT2 dal Repository Maven di Google come segue:

1. Nell'indice del repository, naviga su com.android.tools.build > aapt2.
2. Copia il nome della versione più recente di AAPT2.

3. Inserisci il nome della versione che hai copiato nell'URL seguente e specifica il tuo sistema operativo target: https://dl.google.com/dl/android/maven2/com/android/tools/build/aapt2/ aapt2-version/aapt2-aapt2-version- [windows | linux | osx].jar

   Ad esempio, per scaricare la versione 3.2.0-alpha18-4804415 per Windows, utilizza: 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. Accedi all'URL in un browser. A breve inizierà il download di AAPT2.

5. Rimuovi il pacchetto del file JAR appena scaricato.

   Il file JAR deve contenere un eseguibile aapt2 e alcune librerie che da cui dipende l'eseguibile.

Compila

AAPT2 supporta la compilazione di tutti Tipi di risorse Android, ad esempio disegnabili e file XML. Quando richiami AAPT2 per la compilazione, un singolo file di risorse come input per ogni chiamata. AAPT2 analizza quindi il file e genera un file binario intermedio con estensione .flat.

Quando passa intere directory, AAPT2 ricompila tutti i file nella directory anche quando è cambiata una sola risorsa. Sebbene sia possibile passare le risorse directory contenenti più di un file di risorse in AAPT2 utilizzando l'--dir non usufruirai dei vantaggi della compilazione incrementale delle risorse in questo modo.

I tipi di file di output possono variare in base all'input fornito per la compilazione, come illustrato nella tabella seguente:

Tabella 1. Il file di input e output tipi di compilazione

I file generati da AAPT2 non sono eseguibili e dovrai includerli in un secondo momento file binari come input nella fase di collegamento per generare un APK. Tuttavia, generato non è un eseguibile che puoi implementare su un dispositivo Android dispositivo immediatamente, perché non contiene file DEX ed è non firmato.

Compila sintassi

La sintassi generale per l'utilizzo di compile è la seguente:

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

Nell'esempio seguente, AAPT2 compila file di risorse denominati values.xml e myImage.png singolarmente:

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/

Come mostrato nella tabella 1, il nome del file di output dipende dall'input filename e il nome della relativa directory principale.

Per l'esempio precedente con il file strings.xml come input, aapt2 automaticamente assegna al file di output il nome values-en_strings.arsc.flat. Tuttavia, gli attributi compilati il file drawable archiviato nella directory drawable è denominato drawable_img.png.flat.

Opzioni di compilazione

Esistono diverse opzioni che puoi utilizzare con il comando compile, come mostrato nella tabella 2:

Tabella 2. Opzioni del comando di compilazione

Link

Nella fase di collegamento, AAPT2 unisce tutti i file intermedi inclusi nella compilazione generata automaticamente, come tabelle di risorse, file XML binari e file PNG elaborati e pacchettizzarli in un unico APK. Inoltre, altri È possibile generare file ausiliari, ad esempio file di regole R.java e ProGuard durante questa fase. Tuttavia, l'APK generato non contiene bytecode DEX e non è firmato. Non puoi eseguire il deployment di questo APK su un dispositivo.

Se non utilizzi il plug-in Android Gradle per creare un'app dalla riga di comando, puoi Usare altri strumenti a riga di comando, come d8 per compilare Bytecode Java in bytecode DEX e apksigner per firmare l'APK.

Sintassi dei link

La sintassi generale per l'utilizzo di link è la seguente:

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

Nell'esempio seguente, AAPT2 unisce due file intermedi, drawable_Image.flat, values_values.arsc.flat e AndroidManifest.xml file. AAPT2 collega il risultato con android.jar contenente le risorse definite nel pacchetto android:

 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

Opzioni di collegamento

Con il comando link puoi utilizzare le seguenti opzioni:

Tabella 3. Opzioni del comando Link

Dump

dump viene utilizzato per stampare informazioni sull'APK che hai generato utilizzando l'elemento Comando link.

Sintassi del dump

La sintassi generale per l'utilizzo di dump è la seguente:

aapt2 dump sub-command filename.apk [options]

L'esempio seguente stampa il contenuto dalla tabella delle risorse dell'oggetto APK:

aapt2 dump resources output.apk

Esegui il dump dei sottocomandi

Specifica uno dei seguenti sottocomandi con il comando dump:

Tabella 4. Esegui il dump dei sottocomandi

Opzioni di dump

Utilizza le seguenti opzioni con dump:

Tabella 5. Opzioni di dump

Differenza

Usa diff per confrontare due APK e identificare le eventuali differenze.

Sintassi diff

La sintassi generale per l'utilizzo di diff è la seguente:

aapt2 diff first.apk second.apk

Non sono disponibili opzioni per il comando diff.

Ottimizzazione

optimize viene utilizzato per eseguire ottimizzazioni sulle risorse unite e resources.arsc prima di essere pacchettizzati nell'APK. Questa ottimizzazione può ridurre le dimensioni degli APK dell'1-3% circa, a seconda delle dimensioni e del numero e le risorse utilizzate.

Ottimizza la sintassi

La sintassi generale per l'utilizzo di optimize è la seguente:

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

L'esempio seguente ottimizza le risorse in input.apk e crea un nuovo APK ottimizzato in output.apk. Sostituisce la solita rappresentazione tabella piatta con una struttura di ricerca binaria più compatta, che genera un APK più piccolo Costo delle prestazioni di recupero:

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

Opzioni di ottimizzazione

Puoi utilizzare le seguenti opzioni con optimize:

Tabella 6. Opzioni di ottimizzazione

Converti

Per impostazione predefinita, il comando AAPT compile compila le risorse in un formato binario compatibile con gli APK. È possibile specificare anche il formato protobuf che sia adatto agli AAB specificando --proto-format. convert consente di convertire gli APK tra i due formati.

Converti sintassi

La sintassi generale per convert è la seguente:

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

L'esempio seguente converte le risorse in input.apk e crea una nuova risorsa, APK in output.apk contenente risorse per il formato protobuf. Sostituisce il solito rappresentazione a tabella piatta con un albero di ricerca binaria più compatto, in un APK di dimensioni inferiori a scapito delle prestazioni di recupero:

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

Opzioni di conversione

Utilizza le seguenti opzioni con convert:

Tabella 7. Converti opzioni

Modalità daemon

La versione 2.19 di AAPT ha introdotto la modalità daemon per l'invio di comandi. La modalità daemon puoi inserire più comandi in una singola sessione AAPT.

Sintassi del daemon

Avvia la modalità daemon con il seguente comando:

aapt2 daemon

Quando la modalità daemon è in esecuzione, puoi inserire i comandi. Ogni argomento del deve essere su una riga separata, con una riga vuota alla fine del comando. Esci dalla modalità daemon premendo Ctrl+D.

Considera i seguenti comandi compile individuali:

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/

Questi comandi possono essere inseriti in modalità daemon come:

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

Opzioni modalità daemon

La singola opzione per la modalità daemon è --trace-folder folder, che genera un file JSON systrace del frammento di traccia al valore folder specificato.

Versione

Determina la versione di AAPT2 in uso con il comando version:

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

Il comportamento cambia quando si utilizza AAPT2

Prima di AAPT2, AAPT era la versione predefinita dell'Android Asset Packaging Tool, che ora è deprecato. Anche se AAPT2 dovrebbe funzionare immediatamente con progetti precedenti, in questa sezione vengono descritte alcune modifiche del comportamento che dovresti di cui sei a conoscenza.

Gerarchie di elementi nel manifest Android

Nelle versioni precedenti di AAPT, gli elementi nidificati nei nodi errati nella AndroidManifest.xml file sono stati ignorati o hanno generato un avviso. Considera ad esempio il seguente:

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

Le versioni precedenti di AAPT ignoravano semplicemente il tag <action> in posizione errata.

Con AAPT2, ricevi il seguente errore:

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

Per risolvere il problema, assicurati che gli elementi manifest siano nidificati correttamente. Per ulteriori informazioni, leggi Panoramica del file manifest dell'app.

Dichiarazione delle risorse

Non puoi più indicare il tipo di una risorsa dall'attributo name. L'esempio seguente dichiara erroneamente un elemento di risorsa attr:

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

Dichiarare un tipo di risorsa in questo modo genera il seguente errore di build:

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

Per risolvere questo errore, dichiara esplicitamente il tipo utilizzando type="attr":

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

Inoltre, quando dichiari un elemento <style>, anche quello principale deve essere un un tipo di risorsa di stile. In caso contrario, viene visualizzato un errore simile al seguente:

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

Uso non corretto dei simboli di riferimento delle risorse @

AAPT2 genera errori di build quando ometti o posizioni in modo errato la risorsa simboli di riferimento (@). Ad esempio, se ometti il simbolo quando specificando un attributo di stile:

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

Quando si crea il modulo, AAPT2 genera il seguente errore di build:

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

Inoltre, se includi il simbolo in modo errato quando accedi a un risorsa dallo spazio dei nomi android:

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

Quando si crea il modulo, AAPT2 genera il seguente errore di build:

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

Configurazione errata delle librerie

Se la tua app ha una dipendenza da una libreria di terze parti creata utilizzando di Android Build Build Tools, il tuo potrebbe arrestarsi in modo anomalo in fase di runtime senza mostrare errori o avvisi. Questo arresto anomalo potrebbe verificarsi perché, durante la creazione della libreria, i campi R.java vengono dichiarato final. Di conseguenza, tutti gli ID risorsa sono incorporati corsi della biblioteca.

AAPT2 si basa sulla capacità di riassegnare gli ID alle risorse della libreria durante la creazione la tua app. Se la libreria presuppone che gli ID siano final e li incorpora in al file DEX della libreria, il runtime non corrisponde.

Per risolvere l'errore, contatta l'autore della libreria per ricreare la libreria utilizzando l'ultima versione di Android SDK Build Tools e ripubblicare il libreria.