Attivare l'ottimizzazione delle app con R8

Per un'esperienza utente ottimale, devi ottimizzare l'app in modo che sia il più piccola e veloce possibile. Il nostro strumento di ottimizzazione delle app, chiamato R8, semplifica l'app rimuovendo codice e risorse inutilizzati, riscrivendo il codice per ottimizzare le prestazioni del runtime e altro ancora. Per gli utenti, questo significa:

• Avvii più rapidi
• Memoria utilizzata ridotta
• Prestazioni di rendering e runtime migliorate
• Meno ANR

Panoramica dell'ottimizzazione R8

R8 utilizza un processo in più fasi per ottimizzare le dimensioni e la velocità dell'app. Le operazioni chiave includono:

• Riduzione del codice (nota anche come tree shaking): R8 identifica e rimuove il codice non raggiungibile dall'applicazione e dalle relative dipendenze della libreria. Analizzando i punti di ingresso dell'app (ad esempio Activities o Services definiti nel file manifest), R8 crea un grafico del codice a cui viene fatto riferimento e rimuove tutto ciò a cui non viene fatto riferimento.

• Ottimizzazioni logiche: R8 riscrive il codice per migliorare l'efficienza di esecuzione e ridurre il sovraccarico. Le tecniche chiave includono:

  • Inlining dei metodi: R8 sostituisce un sito di chiamata al metodo con il corpo effettivo del metodo chiamato. In questo modo si elimina il sovraccarico di una chiamata di funzione e R8 può eseguire ulteriori ottimizzazioni.

  • Unione delle classi: R8 combina insiemi di classi e interfacce in una singola classe. In questo modo si riduce il numero di classi nell'app, si riduce la pressione sulla memoria e si migliora la velocità di avvio.

• Offuscamento (noto anche come minimizzazione): per ridurre le dimensioni del file DEX , R8 abbrevia i nomi di classi, campi e metodi (ad esempio, com.example.MyActivity potrebbe diventare a.b.a).

A partire dalla versione 8.12.0 del plug-in Android per Gradle (AGP), R8 ottimizza anche le risorse nell'ambito delle sue fasi di ottimizzazione. Per saperne di più, consulta Riduzione delle risorse ottimizzata.

Attivare l'ottimizzazione

Per attivare l'ottimizzazione dell'app, imposta isMinifyEnabled = true (per l'ottimizzazione del codice) e isShrinkResources = true (per l'ottimizzazione delle risorse) nello script di build a livello di app della build release build's, come mostrato nel codice seguente. Ti consigliamo di attivare sempre entrambe le impostazioni. Ti consigliamo inoltre di attivare l'ottimizzazione dell'app solo nella versione finale dell'app che testi prima della pubblicazione, in genere la build di release, perché le ottimizzazioni aumentano il tempo di compilazione del progetto e possono rendere più difficile il debug a causa del modo in cui modificano il codice.

android {
    buildTypes {
        release {

            // Enables code-related app optimization.
            isMinifyEnabled = true

            // Enables resource shrinking.
            isShrinkResources = true

            proguardFiles(
                // Default file with automatically generated optimization rules.
                getDefaultProguardFile("proguard-android-optimize.txt"),

                ...
            )
            ...
        }
    }
    ...
}

android {
    buildTypes {
        release {

            // Enables code-related app optimization.
            minifyEnabled = true

            // Enables resource shrinking.
            shrinkResources = true

            // Default file with automatically generated optimization rules.
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt')

            ...
        }
    }
}

Ottimizzare la riduzione delle risorse per app ancora più piccole

La versione 8.12.0 del plug-in Android per Gradle (AGP) introduce la riduzione delle risorse ottimizzata, che mira a integrare l'ottimizzazione delle risorse e del codice per creare app ancora più piccole e veloci.

Prima della riduzione delle risorse ottimizzata, Android Asset Packaging Tool (AAPT2) generava regole di conservazione che trattavano la riduzione delle risorse separatamente dal codice, spesso conservando codice o risorse inaccessibili che facevano riferimento l'uno all'altro.

Con la riduzione delle risorse ottimizzata, le risorse vengono considerate come parte del codice del programma, formando il grafico di riferimento. Quando una raccolta di codice o risorse non viene referenziata, non è protetta da una regola di conservazione e può essere rimossa.

Attivare la riduzione delle risorse ottimizzata

Per attivare la nuova pipeline di riduzione delle risorse ottimizzata per AGP 8.12 o 8.13, aggiungi quanto segue al file gradle.properties del progetto:

android.r8.optimizedResourceShrinking=true

Se utilizzi AGP 9.0.0 o una versione successiva, non devi impostare android.r8.optimizedResourceShrinking=true. La riduzione delle risorse ottimizzata viene applicata automaticamente quando isShrinkResources = true è attivata nella configurazione della build.

Verificare e configurare le impostazioni di ottimizzazione di R8

Per consentire a R8 di utilizzare tutte le sue funzionalità di ottimizzazione, rimuovi la seguente riga dal file gradle.properties del progetto, se presente:

android.enableR8.fullMode=false # Remove this line from your codebase.

Tieni presente che l'attivazione dell'ottimizzazione dell'app rende difficili da comprendere le analisi dello stack, soprattutto se R8 rinomina i nomi di classi o metodi. Per ottenere analisi dello stack che corrispondano correttamente al codice sorgente, consulta Recuperare l'analisi dello stack originale.

Se R8 è attivato, devi anche creare profili di avvio per prestazioni di avvio ancora migliori.

Se attivi l'ottimizzazione dell'app e si verificano errori, ecco alcune strategie per risolverli:

• Aggiungi regole di conservazione per mantenere intatto il codice.
• Adotta le ottimizzazioni in modo incrementale.
• Aggiorna il codice per utilizzare librerie più adatte all' ottimizzazione.

Se ti interessa ottimizzare la velocità di build, consulta Configurare la modalità di esecuzione di R8 per informazioni su come configurare R8 in base al tuo ambiente.

Migliorare l'ottimizzazione R8

I vantaggi in termini di prestazioni di R8 sono direttamente correlati alla quantità di codebase che R8 è in grado di ottimizzare. Per ottenere il massimo da R8, attiva R8 in modalità completa e perfeziona le regole di conservazione per consentire la massima ottimizzazione di classi, campi e metodi.Per aiutarti, utilizza il R8 Configuration Analyzer.

R8 Configuration Analyzer ti consente di:

• Monitorare e migliorare la qualità complessiva della configurazione di R8 monitorando le metriche fornite dal report di R8 Configuration Analyzer.
• Trovare le regole di conservazione più ampie, ovvero quelle che impediscono la maggior parte dell'ottimizzazione
• e capire quale ottimizzazione impediscono per perfezionarle.

R8 Configuration Analyzer è disponibile in AGP versione 9.3.0-alpha05 o da R8 versione 9.3.7-dev. Per saperne di più, consulta Analizzare la configurazione di R8.

Modifiche al comportamento della versione di AGP e R8

La tabella seguente descrive le funzionalità chiave introdotte in varie versioni del plug-in Android per Gradle (AGP) e del compilatore R8.