Gradle e Build Android

Execution failed for task ':app:checkDebugAarMetadata': The minCompileSdk must be at least N. – Flutter CHECK_AAR_METADATA_FAIL

CHECK_AAR_METADATA_FAIL

Una libreria o plugin Android (es. `androidx.core`, `google_mobile_ads`) richiede un `compileSdkVersion` più recente rispetto a quello configurato in `android/app/build.gradle`.

Categoria: FlutterGruppo: Gradle e Build AndroidConfidenza: altaUltimo aggiornamento: 19-08-2026Letto 1 volta

Cosa significa questo errore?

Una libreria o plugin Android (es. `androidx.core`, `google_mobile_ads`) richiede un `compileSdkVersion` più recente rispetto a quello configurato in `android/app/build.gradle`.

Messaggio originale

Execution failed for task ':app:checkDebugAarMetadata': The minCompileSdk must be at least N.

Contesto e parole chiave

Alias

  • checkDebugAarMetadata failed
  • minCompileSdk Flutter

Messaggi alternativi

  • verifica metadati AAR fallita minCompileSdk richiesta superiore

Prodotti

  • Flutter SDK / Dart VM / Flutter Framework / Gradle / CocoaPods

Piattaforme

  • Android
  • iOS
  • Linux
  • macOS
  • Web
  • Windows

Parole chiave

  • CHECK_AAR_METADATA_FAIL
  • dart
  • errore-flutter-check-debug-aar-metadata-failed
  • flutter
  • flutter.build.check-debug-aar-metadata-failed
  • Gradle e Build Android
  • widget

Cause possibili

Origine del problema per Flutter Android: checkDebugAarMetadata failed (minCompileSdk insufficiente)

Una libreria o plugin Android (es. `androidx.core`, `google_mobile_ads`) richiede un `compileSdkVersion` più recente rispetto a quello configurato in `android/app/build.gradle`.

molto comune

Diagnosi

Diagnostica Flutter per Flutter Android: checkDebugAarMetadata failed (minCompileSdk insufficiente)

Eseguire flutter doctor con flag verbose ed esaminare l'output di debug a console.

Come leggere il risultato. Evidenzia discrepanze nelle toolchain Android/iOS, plugin mancanti o configurazioni SDK errate.

flutter
flutter doctor -v

Risoluzione

Procedura di risoluzione per Flutter Android: checkDebugAarMetadata failed (minCompileSdk insufficiente)

Difficoltà: facileRischio: basso

Applicare la correzione al codice Dart o alla configurazione di build secondo la documentazione ufficiale Flutter.

  1. Verificare i vincoli di layout o la gerarchia dei widget
  2. Eseguire una pulizia della cache di build con flutter clean
  3. Aggiornare le dipendenze con flutter pub get
flutter
flutter clean && flutter pub get

Domande frequenti

Come risolvere il codice o problema CHECK_AAR_METADATA_FAIL in Flutter?

Una libreria o plugin Android (es. `androidx.core`, `google_mobile_ads`) richiede un `compileSdkVersion` più recente rispetto a quello configurato in `android/app/build.gradle`.

Approfondimenti

Schede correlate