Mengatasi Error: Please Upgrade Your Android Gradle Plugin Version to a Version of at Least

Saat membangun aplikasi Flutter atau Android, kamu mungkin menemukan error seperti:


Please upgrade your Android Gradle Plugin version to a version of at least X.Y.Z

Error ini muncul karena proyek menggunakan Android Gradle Plugin (AGP) versi lama yang sudah tidak kompatibel dengan Gradle, SDK, atau Flutter versi terbaru. Cara mengatasinya berbeda antara proyek Flutter dan Android native. Artikel ini akan membahas keduanya secara lengkap.

Untuk Project Android Native

1. Perbarui Android Gradle Plugin

Buka android/build.gradle lalu ubah versi plugin:


classpath 'com.android.tools.build:gradle:8.3.0'

2. Perbarui Gradle Wrapper

Buka gradle/wrapper/gradle-wrapper.properties:


distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip

3. Update Kotlin (Jika Diperlukan)

Masukkan di build.gradle root:


ext.kotlin_version = "1.8.22"

Untuk Project Flutter

1. Buka `android/settings.gradle`

Di Flutter versi terbaru, plugin dan AGP dikelola lewat settings.gradle atau settings.gradle.kts. Ubah bagian:id "com.android.application" version "[ganti dengan versi yang dibutuhkan]" apply false

Contoh:



plugins {
    id "dev.flutter.flutter-plugin-loader" version "1.0.0"
    id "com.android.application" version "8.3.0" apply false
    id "org.jetbrains.kotlin.android" version "1.8.22" apply false
}

Catatan: Pastikan struktur ini ada di bagian atas file settings.gradle.

2. Update Gradle Wrapper

Sama seperti Android native, buka file: android/gradle/wrapper/gradle-wrapper.properties pada bagian distributionUrl=[ganti url yang dibutuhkan]

Contoh:


distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-all.zip

3. Sinkronkan dan Bersihkan Proyek


flutter clean
flutter pub get
flutter build apk

Tabel Referensi Kompatibilitas

AGP Version	Gradle Minimum	Kotlin Minimum
8.3.0	8.4	1.8.22
8.2.0	8.4	1.8.10
8.0.0	8.2	1.8.0

Kesimpulan

Untuk mengatasi error Please upgrade your Android Gradle Plugin..., kamu harus menyesuaikan versi AGP dan Gradle sesuai kebutuhan:

Untuk Android Native: ubah di build.gradle dan gradle-wrapper.properties.
Untuk Flutter: ubah di settings.gradle, pastikan plugin AGP dan Kotlin terbaru digunakan.

Langkah ini penting agar proyek tetap kompatibel dengan Flutter dan Android SDK terbaru serta menghindari error build di masa depan.