AAPT2

AAPT2 (Android Asset Packaging Tool) è uno strumento di compilazione che Android Studio e Android Gradle Plugin utilizzano per compilare e pacchettizzare le risorse della tua app. AAPT2 analizza, indicizza e compila le risorse in un formato binario ottimizzato per la piattaforma Android.

Il plug-in Android per Gradle 3.0.0 e versioni successive attiva AAPT2 per impostazione predefinita. In genere non è necessario richiamare aapt2 manualmente. Tuttavia, se preferisci utilizzare il terminale e il tuo sistema di build anziché Android Studio, puoi utilizzare AAPT2 dalla riga di comando. Puoi anche eseguire il debug degli errori di build correlati ad AAPT2 dalla riga di comando. Per farlo, trova AAPT2 come strumento autonomo in Android SDK Build Tools 26.0.2 e versioni successive.

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

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

Dopo aver scaricato gli strumenti di compilazione dell'SDK, trova AAPT2 in android_sdk/build-tools/version/.

Poiché le revisioni degli strumenti di compilazione dell'SDK Android non vengono rilasciate spesso, la versione di AAPT2 inclusa negli strumenti di compilazione dell'SDK potrebbe non essere l'ultima. Per ottenere l'ultima versione di AAPT2, scarica AAPT2 da Google Maven.

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

AAPT2 supporta una compilazione più rapida delle risorse consentendo la compilazione incrementale. Per eseguire la compilazione incrementale, l'elaborazione delle risorse è divisa in due passaggi:

• Compila: compila i file di risorse in formati binari.
• Link: unisce tutti i file compilati e li raggruppa in un unico pacchetto.

Questa separazione contribuisce a migliorare il rendimento delle build incrementali. Ad esempio, se vengono apportate modifiche a un singolo file, devi ricompilare solo quel file.

Scaricare AAPT2 da Google Maven

Per ottenere la versione più recente di AAPT2 non inclusa negli strumenti di compilazione, scarica AAPT2 dal repository Maven di Google nel seguente modo:

1. Nell'indice del repository, vai a com.android.tools.build > aapt2.
2. Copia il nome dell'ultima versione di AAPT2.

3. Inserisci il nome della versione che hai copiato nel seguente URL e specifica il sistema operativo di destinazione: 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. Apri l'URL in un browser. Il download di AAPT2 inizierà a breve.

5. Decomprimi il file JAR che hai appena scaricato.

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

Compila

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

Quando vengono passate intere directory, AAPT2 ricompila tutti i file della directory anche quando è stata modificata una sola risorsa. Sebbene tu possa trasmettere a AAPT2 directory di risorse contenenti più di un file di risorse utilizzando il flag --dir, in questo modo non ottieni i vantaggi della compilazione incrementale delle risorse.

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

Tabella 1. I tipi di file di input e output per la compilazione

I file di output di AAPT2 non sono eseguibili e devi includerli in un secondo momento come input nella fase di collegamento per generare un APK. Tuttavia, il file APK generato non è un eseguibile che puoi distribuire immediatamente su un dispositivo Android, perché non contiene file DEX e non è firmato.

Sintassi di compilazione

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 i 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 dal nome del file di input e dal nome della directory principale.

Per l'esempio precedente con il file strings.xml come input, aapt2 assegna automaticamente al file di output il nome values-en_strings.arsc.flat. Tuttavia, il file drawable compilato 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 generati dalla fase di compilazione, come tabelle di risorse, file XML binari e file PNG elaborati, quindi li raggruppa in un unico APK. Inoltre, in questa fase possono essere generati altri file ausiliari, come i file di regole R.java e ProGuard. 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 la tua app dalla riga di comando, puoi utilizzare altri strumenti a riga di comando, come d8 per compilare il bytecode Java in bytecode DEX e apksigner per firmare il tuo 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 e values_values.arsc.flat, e il file AndroidManifest.xml. AAPT2 collega il risultato al file android.jar, che contiene 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

Puoi utilizzare le seguenti opzioni con il comando link:

Tabella 3. Opzioni del comando Link

Dump

dump viene utilizzato per stampare informazioni sull'APK che hai generato utilizzando il comando link.

Sintassi di dump

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

aapt2 dump sub-command filename.apk [options]

Il seguente esempio stampa i contenuti della tabella delle risorse dell'APK specificato:

aapt2 dump resources output.apk

Comandi secondari di dump

Specifica uno dei seguenti sottocomandi con il comando dump:

Tabella 4. Comandi secondari di dump

Opzioni di dump

Utilizza le seguenti opzioni con dump:

Tabella 5. Opzioni di dump

Diff

Utilizza diff per confrontare due APK e identificare eventuali differenze tra loro.

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 che vengano inserite nel pacchetto APK. Questa ottimizzazione può ridurre le dimensioni dell'APK di circa l'1-3%, a seconda delle dimensioni e del numero di risorse utilizzate.

Ottimizzare 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 consueta rappresentazione tabellare piatta con una rappresentazione più compatta, con conseguente riduzione delle dimensioni dell'APK, dell'utilizzo della memoria e della latenza di avvio, nonché un leggero aumento del tempo di ricerca delle singole risorse dopo l'avvio.

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 adatto agli APK. È possibile specificare anche il formato protobuf adatto agli AAB specificando --proto-format. Il comando convert converte gli APK tra i due formati.

Convertire la 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 un nuovo APK in output.apk contenente risorse in formato protobuf. Sostituisce la consueta rappresentazione tabellare piatta con una rappresentazione più compatta, con conseguente riduzione delle dimensioni dell'APK, dell'utilizzo della memoria e della latenza di avvio, nonché un leggero aumento

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

Opzioni di conversione

Utilizza le seguenti opzioni con convert:

Tabella 7. Opzioni di conversione

Modalità daemon

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

Sintassi del daemon

Avvia la modalità daemon con il seguente comando:

aapt2 daemon

Una volta eseguita la modalità demone, puoi inserire i comandi. Ogni argomento del comando deve essere su una riga separata, con una riga vuota alla fine del comando. Esci dalla modalità demone digitando Control+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à demone 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

L'unica opzione per la modalità demone è --trace-folder folder, che genera un frammento di traccia JSON systrace nel folder specificato.

Versione

Determina la versione di AAPT2 che stai utilizzando con il comando version:

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

Modifiche al comportamento durante l'utilizzo di AAPT2

Prima di AAPT2, AAPT era la versione predefinita di Android Asset Packaging Tool, ora ritirata. Sebbene AAPT2 debba funzionare immediatamente con i progetti precedenti, questa sezione descrive alcune modifiche del comportamento di cui devi essere a conoscenza.

Gerarchie degli elementi nel manifest Android

Nelle versioni precedenti di AAPT, gli elementi nidificati in nodi errati nel file AndroidManifest.xml venivano ignorati o generavano un avviso. Ad esempio, considera questo esempio:

<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> posizionato in modo errato.

Con AAPT2, viene visualizzato il seguente errore:

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

Per risolvere il problema, assicurati che gli elementi del manifest siano nidificati correttamente. Per saperne di più, consulta la panoramica del file manifest dell'app.

Dichiarazione delle risorse

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

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

La dichiarazione di un tipo di risorsa in questo modo genera il seguente errore di compilazione:

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>, il relativo elemento padre deve essere anche un tipo di risorsa di stile. In caso contrario, riceverai un errore simile al seguente:

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

Utilizzo errato dei simboli di riferimento delle risorse @

AAPT2 genera errori di compilazione quando ometti o posizioni in modo errato i simboli di riferimento delle risorse (@). Ad esempio, se ometti il simbolo quando specifichi 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>

Durante la creazione del modulo, AAPT2 genera il seguente errore di build:

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

Inoltre, se includi erroneamente il simbolo quando accedi a una risorsa dallo spazio dei nomi android:

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

Durante la creazione del 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 versioni precedenti di Android SDK Build Tools, la tua app potrebbe arrestarsi in modo anomalo in fase di runtime senza visualizzare errori o avvisi. Questo arresto anomalo potrebbe verificarsi perché durante la creazione della libreria, i campi R.java sono dichiarati final. Di conseguenza, tutti gli ID risorsa sono incorporati nelle classi della libreria.

AAPT2 si basa sulla possibilità di riassegnare gli ID alle risorse della libreria durante la creazione dell'app. Se la libreria presuppone che gli ID siano final e li incorpora nel DEX della libreria, si verifica una mancata corrispondenza del runtime.

Per risolvere questo errore, contatta l'autore della libreria per ricompilarla utilizzando l'ultima versione degli strumenti di compilazione dell'SDK Android e ripubblicala.