Nei progetti Flutter Android aggiornati ad Android Gradle Plugin 9 o successivo, l'uso del vecchio Kotlin Gradle Plugin può impedire la build o richiedere flag di compatibilità. Il progetto deve essere confrontato con la guida di migrazione Flutter: si verifica il plugin legacy, si aggiornano i file Gradle secondo il template e si mantiene una combinazione supportata di AGP, Gradle, Kotlin e Java.
LEGACY_KGP_AGP9
→
L'errore compare quando un plugin moderno utilizza feature di Java 8/11 (come java.time) su dispositivi Android con API precedenti alla 26 senza abilitare il desugaring.
CORE_LIBRARY_DESUGARING_REQUIRED
→
L'errore si manifesta quando Gradle non riesce a scaricare una libreria nativa da Google Maven o Maven Central a causa di blocco proxy o assenza di connessione.
RESOLVE_ARTIFACTS_FAILED
→
L'errore compare quando la versione del plugin Kotlin (ext.kotlin_version) in build.gradle è disallineata rispetto alle dipendenze AndroidX o al compilatore Kotlin.
KOTLIN_COMPILE_FAILED
→
L'errore generico segnala che la build nativa Android è fallita a causa di conflitti tra classi Duplicate class, versioni di supporto o errori di compilazione Java/Kotlin.
GRADLE_EXIT_1
→
L'errore si verifica durante la compilazione di progetti complessi quando il demone Gradle esaurisce la memoria RAM allocata (risolvibile con org.gradle.jvmargs=-Xmx4096m in gradle.properties).
GRADLE_OOM
→
L'errore si presenta durante il build quando un plugin Flutter richiede un'API Android minima (es. 21 per camera o firebase) superiore al minSdkVersion impostato in app/build.gradle.
MIN_SDK_VERSION_LOW
→
L'errore compare dopo aver aggiornato ad Android Gradle Plugin 8.0+ quando il file build.gradle del modulo o del plugin omette la direttiva obbligatoria 'namespace = "com.example.app"'.
AGP_NAMESPACE_MISSING
→