Gradle

Projects using the Kotlin Gradle Plugin must migrate to built-in Kotlin for AGP 9+ – Flutter LEGACY_KGP_AGP9

LEGACY_KGP_AGP9

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.

Categoria: FlutterGruppo: GradleConfidenza: altaUltimo aggiornamento: 19-08-2026Letto 15 volte

Cosa significa questo errore?

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.

Messaggio originale

Projects using the Kotlin Gradle Plugin must migrate to built-in Kotlin for AGP 9+

Contesto e parole chiave

Alias

  • built-in Kotlin migration
  • legacy kotlin-android plugin

Messaggi alternativi

  • Migrazione Kotlin integrata richiesta
  • Plugin Kotlin legacy non compatibile con AGP 9

Prodotti

  • Flutter Android / AGP 9+ / Kotlin

Piattaforme

  • Linux
  • macOS
  • Windows

Parole chiave

  • built-in kotlin flutter
  • flutter agp 9 kotlin
  • legacy kotlin gradle plugin

Cause possibili

Applicazione di kotlin-android nel vecchio stile

Il progetto usa ancora il flusso legacy invece della configurazione Kotlin integrata prevista dalla nuova toolchain.

molto comune

File Gradle generati da una vecchia release Flutter

settings.gradle e app/build.gradle non riflettono il template richiesto dalla versione corrente.

comune

Diagnosi

Plugin Kotlin applicato nei file Android

Cercare kotlin-android e org.jetbrains.kotlin.android in settings.gradle, build.gradle e app/build.gradle.

Come leggere il risultato. La presenza della configurazione legacy determina se la migrazione è necessaria.

Versione AGP effettiva

Leggere la dichiarazione del plugin com.android.application nel progetto.

Come leggere il risultato. AGP 9+ attiva le regole di migrazione descritte dalla documentazione Flutter.

Risoluzione

Migrazione al Kotlin integrato

Difficoltà: avanzataRischio: medio

Applicare la procedura Flutter per rimuovere la dipendenza dal flusso Kotlin legacy.

  1. Verificare le versioni AGP e Flutter.
  2. Applicare le modifiche a settings.gradle e build.gradle indicate dalla guida.
  3. Rimuovere solo i blocchi legacy indicati.
  4. Eseguire flutter run o flutter build apk per la validazione.
shell
flutter build apk

Conservare una copia dei file Gradle prima della migrazione.

Mantenimento temporaneo delle flag di compatibilità

Difficoltà: mediaRischio: basso

Usare le flag documentate solo come ponte durante la migrazione, senza considerarle una soluzione permanente.

  1. Verificare che il progetto applichi realmente KGP.
  2. Aggiungere le flag indicate al gradle.properties quando previsto.
  3. Pianificare la migrazione definitiva al template aggiornato.
  4. Rimuovere le flag obsolete dopo la verifica.

Domande frequenti

La migrazione al Kotlin integrato riguarda tutti i progetti Flutter?

Riguarda in particolare i progetti che applicano già il Kotlin Gradle Plugin e vengono portati ad AGP 9 o successivo; i progetti che non usano KGP seguono il percorso indicato dalla propria configurazione.

Approfondimenti

Schede correlate