Gradle

Your project requires a newer version of the Kotlin Gradle plugin – Flutter KOTLIN_VERSION_TOO_OLD

KOTLIN_VERSION_TOO_OLD

Flutter può bloccare la build Android quando il progetto usa una versione del Kotlin Gradle Plugin inferiore a quella richiesta dal framework e dalle dipendenze AndroidX. Il messaggio chiede di aggiornare la versione Kotlin nel progetto Android. Prima della modifica bisogna verificare la coppia Flutter, Android Gradle Plugin e Gradle wrapper, perché un aggiornamento isolato può creare un nuovo conflitto di compatibilità.

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

Cosa significa questo errore?

Flutter può bloccare la build Android quando il progetto usa una versione del Kotlin Gradle Plugin inferiore a quella richiesta dal framework e dalle dipendenze AndroidX. Il messaggio chiede di aggiornare la versione Kotlin nel progetto Android. Prima della modifica bisogna verificare la coppia Flutter, Android Gradle Plugin e Gradle wrapper, perché un aggiornamento isolato può creare un nuovo conflitto di compatibilità.

Messaggio originale

Your project requires a newer version of the Kotlin Gradle plugin

Contesto e parole chiave

Alias

  • Kotlin Gradle plugin too old
  • Kotlin version mismatch Flutter

Messaggi alternativi

  • Aggiornare ext.kotlin_version
  • Versione Kotlin non supportata dal progetto Flutter

Prodotti

  • Flutter Android build / Kotlin Gradle Plugin

Piattaforme

  • Linux
  • macOS
  • Windows

Parole chiave

  • android gradle kotlin flutter
  • flutter kotlin gradle plugin too old
  • flutter kotlin version error

Cause possibili

Kotlin sotto la versione minima richiesta

Il file Gradle del progetto mantiene una versione Kotlin precedente a quella necessaria per le dipendenze dell'embedding Flutter.

molto comune

Kotlin, AGP e Gradle wrapper non allineati

L'aggiornamento di un solo componente lascia incompatibile il resto dello stack Android.

comune

Diagnosi

Versione Kotlin dichiarata

Cercare ext.kotlin_version o il plugin org.jetbrains.kotlin.android nei file Android.

Come leggere il risultato. La versione effettiva deve rispettare il minimo richiesto dalla release Flutter usata.

powershell
Get-ChildItem android -Recurse -File | Select-String -Pattern 'kotlin|org.jetbrains.kotlin'

Versioni AGP e Gradle wrapper

Leggere settings.gradle, build.gradle e gradle-wrapper.properties prima dell'aggiornamento.

Come leggere il risultato. La matrice di compatibilità evita di sostituire un errore Kotlin con un errore AGP o Java.

Risoluzione

Aggiornamento coordinato della toolchain Android

Difficoltà: avanzataRischio: medio

Allineare Kotlin alla versione minima e verificare AGP, Gradle e Java compatibili.

  1. Annotare le versioni attuali.
  2. Consultare la guida della release Flutter in uso.
  3. Aggiornare Kotlin e solo i componenti compatibili.
  4. Eseguire flutter clean e flutter pub get.
  5. Compilare un APK di verifica.
shell
flutter clean && flutter pub get && flutter build apk

Migrazione al Plugin DSL quando richiesta

Difficoltà: avanzataRischio: medio

Spostare le versioni dei plugin nel blocco plugins seguendo il modello della versione Flutter adottata.

  1. Creare un backup dei file Android.
  2. Confrontare il progetto con il template Flutter corrente.
  3. Spostare le dichiarazioni nel Plugin DSL.
  4. Eseguire la build e correggere solo incompatibilità documentate.

Domande frequenti

Posso aggiornare solo Kotlin senza toccare Gradle?

Non sempre. Kotlin, Android Gradle Plugin, Gradle wrapper e Java hanno vincoli reciproci; è necessario verificare la matrice compatibile della release Flutter in uso.

Approfondimenti

Schede correlate