Plug-in Android per Gradle 9.2.0 (aprile 2026)

Il plug-in Android per Gradle 9.2 è una release secondaria che include una serie di nuove funzionalità e miglioramenti.

Compatibilità

Il livello API massimo supportato dal plug-in Android per Gradle 9.2 è il livello API 37.0. Ecco altre informazioni sulla compatibilità:

Report di test e copertura unificati

AGP 9.2.0-alpha07 introduce attività per generare dashboard HTML che consolidano i risultati dei test e la copertura di vari tipi di test (unità e strumentazione), moduli e varianti di build, fornendo una panoramica completa in un'unica dashboard. Per saperne di più, consulta Generare report di copertura del codice unificati e Visualizzare report di test unificati.

Modifiche di R8

Le seguenti modifiche di R8 sono incluse in AGP 9.2.0.

Semantica -keepattributes più rigorosa per mantenere le annotazioni invisibili in fase di runtime

Le annotazioni invisibili in fase di runtime non possono essere lette in fase di runtime. Pertanto, D8 rimuove incondizionatamente le annotazioni invisibili in fase di runtime, senza possibilità di modificare questa impostazione.

Per la compatibilità con ProGuard, R8 supporta l'output delle annotazioni invisibili in fase di runtime. Tuttavia, quando si esegue la compilazione in DEX, in genere le annotazioni invisibili in fase di runtime non devono mai essere conservate. Tuttavia, è una pratica comune includere la regola pratica -keepattributes *Annotation* (direttamente o indirettamente dalle regole di conservazione del consumatore) per consentire a R8 di conservare le annotazioni visibili in fase di runtime. Purtroppo, in questo modo vengono conservate anche le annotazioni invisibili in fase di runtime.

Per attenuare questo problema e corrispondere meglio al comportamento di D8, i pattern -keepattributes con caratteri jolly non corrispondono più a RuntimeInvisibleAnnotations, RuntimeInvisibleParameterAnnotations e RuntimeInvisibleTypeAnnotations. Di conseguenza, le annotazioni invisibili in fase di runtime verranno conservate solo se il nome dell'attributo viene menzionato esplicitamente senza caratteri jolly.

Nessuna delle seguenti regole manterrà le annotazioni invisibili in fase di runtime:

-keepattributes *
-keepattributes *Annotation*
-keepattributes *Invisible*

Per mantenere le annotazioni invisibili in fase di runtime, utilizza la seguente regola:

-keepattributes RuntimeInvisibleAnnotations,
                RuntimeInvisibleParameterAnnotations,
                RuntimeInvisibleTypeAnnotations

Supporto per i nomi negati nelle regole dei membri

Il linguaggio di configurazione è stato esteso in modo che ora tu possa trovare corrispondenze con i pattern di nomi di membri negati.

Ad esempio, per trovare la corrispondenza con tutti i metodi che non terminano con "ForTesting", utilizza la seguente regola:

-keepclassmembers class com.example.MyClass {
  *** !*ForTesting(...);
}

I pattern di nomi di membri possono essere negati anche nella precondizione delle regole -if. Se un pattern di nomi di membri negati contiene caratteri jolly, non è possibile fare riferimento a questi caratteri jolly nella regola conseguente -if.

Problemi risolti

Plug-in Android per Gradle 9.2.1

Plug-in Android per Gradle 9.2.0