Plug-in Android per Gradle 3.2.0 (settembre 2018)

Questa versione del plug-in Android richiede quanto segue:

Versione minima Versione predefinita Note
Gradle 4,6 4,6 Per saperne di più, consulta la sezione Aggiornare Gradle.
Strumenti di build dell'SDK 28.0.3 28.0.3 Installa o configura gli strumenti di compilazione dell'SDK.

3.2.1 (ottobre 2018)

Con questo aggiornamento, non è più necessario specificare una versione per gli strumenti di build dell'SDK. Il plug-in Android per Gradle ora utilizza la versione 28.0.3 per impostazione predefinita.

Nuove funzionalità

  • Supporto per la creazione di Android App Bundle: l'app bundle è un nuovo formato di caricamento che include tutto il codice compilato e le risorse della tua app, rimandando la generazione e la firma dell'APK al Google Play Store. Non devi più creare, firmare e gestire più APK e gli utenti possono scaricare file di dimensioni inferiori ottimizzati per il loro dispositivo. Per scoprire di più, leggi Informazioni su Android App Bundle.

  • Supporto per velocità di build incrementali migliorate quando si utilizzano i processori di annotazioni: il DSL AnnotationProcessorOptions ora estende CommandLineArgumentProvider, il che consente a te o all'autore del processore di annotazioni di annotare gli argomenti per il processore utilizzando annotazioni del tipo di proprietà di build incrementale. L'utilizzo di queste annotazioni migliora la correttezza e le prestazioni delle build pulite incrementali e memorizzate nella cache. Per scoprire di più, leggi Passa argomenti ai processori di annotazioni.

  • Strumento di migrazione per AndroidX: quando utilizzi il plug-in Android per Gradle 3.2.0 con Android 3.2 e versioni successive, puoi eseguire la migrazione delle dipendenze locali e Maven del tuo progetto per utilizzare le nuove librerie AndroidX selezionando Refactor > Migrate to AndroidX dalla barra dei menu. L'utilizzo di questo strumento di migrazione imposta anche i seguenti flag su true nel file gradle.properties:

    • android.useAndroidX: se impostato su true, il plug-in Android utilizza la libreria AndroidX appropriata anziché una libreria di supporto. Se questo flag non viene specificato, il plug-in lo imposta su false per impostazione predefinita.

    • android.enableJetifier: se impostato su true, il plug-in Android esegue automaticamente la migrazione delle librerie di terze parti esistenti per utilizzare AndroidX riscrivendo i relativi binari. Se questo flag non viene specificato, il plug-in lo imposta su false per impostazione predefinita. Puoi impostare questo flag su true solo se anche android.useAndroidX è impostato su true, altrimenti riceverai un errore di build.

      Per scoprire di più, leggi la panoramica di AndroidX.

  • Nuovo strumento di riduzione delle dimensioni del codice, R8: R8 è un nuovo strumento per la riduzione delle dimensioni e l'offuscamento del codice che sostituisce ProGuard. Puoi iniziare a utilizzare la versione di anteprima di R8 includendo quanto segue nel file gradle.properties del progetto:

            android.enableR8 = true
            
            android.enableR8 = true
            

Modifiche del comportamento

  • Il desugaring con D8 è ora abilitato per impostazione predefinita.

  • AAPT2 è ora disponibile nel repository Maven di Google. Per utilizzare AAPT2, assicurati di avere la dipendenza google() nel file build.gradle, come mostrato di seguito:

              buildscript {
                    repositories {
                        google() // here
                        jcenter()
                    }
                    dependencies {
                        classpath 'com.android.tools.build:gradle:3.2.0'
                    }
                }
                allprojects {
                    repositories {
                        google() // and here
                        jcenter()
                }
              
              buildscript {
                    repositories {
                        google() // here
                        jcenter()
                    }
                    dependencies {
                        classpath 'com.android.tools.build:gradle:3.2.0'
                    }
                }
                allprojects {
                    repositories {
                        google() // and here
                        jcenter()
                }
              
  • La configurazione multidex nativa è ora abilitata per impostazione predefinita. Le versioni precedenti di Android Studio attivavano la configurazione multidex nativa durante il deployment della versione di debug di un'app su un dispositivo con livello API Android 21 o versioni successive. Ora, indipendentemente dal fatto che tu stia eseguendo il deployment su un dispositivo o creando un APK per il rilascio, il plug-in Android per Gradle attiva la configurazione multidex nativa per tutti i moduli che impostano minSdkVersion=21 o versioni successive.

  • Il plug-in ora applica una versione minima del plug-in protobuf (0.8.6), del plug-in Kotlin (1.2.50) e del plug-in Crashlytics (1.25.4).

  • Il plug-in del modulo della funzionalità, com.android.feature, ora impone l'utilizzo di sole lettere, cifre e trattini bassi quando si specifica un nome del modulo. Ad esempio, se il nome del modulo della funzionalità include trattini, viene visualizzato un errore di build. Questo comportamento corrisponde a quello del plug-in delle funzionalità dinamiche.

Correzioni di bug