Jika Capacitor plugin mulai gagal setelah upgrade ke Android Gradle Plugin 9 (AGP 9), kemungkinan besar Anda menghadapi masalah konfigurasi Gradle yang kecil namun krusial.
Artikel ini secara spesifik menargetkan intent pencarian umum seperti:
- error build plugin Capacitor AGP 9
- build plugin gagal di Android Gradle Plugin 9
proguard-android.txttidak ditemukan- AGP 9
getDefaultProguardFileerror - build Android Capacitor gagal setelah upgrade AGP
Versi singkatnya:
proguard-android.txtbukan lagi baseline default yang aman untuk dirujuk dalam build plugin AGP 9.- Beralih ke
proguard-android-optimize.txt. - Rebuild dan verifikasi.
Versi yang lebih panjang juga penting, terutama jika Anda mengelola banyak plugin atau workspace Capacitor yang besar. Di artikel ini, kita akan membahas:
- Apa itu Android dan AGP dalam build chain
- Apa itu Capacitor dan cara kerja build plugin
- Apa itu Capgo dan kenapa ini penting untuk keandalan rilis
- Perubahan spesifik AGP 9 yang merusak template plugin lama
- Strategi migrasi aman untuk satu repo atau banyak repo
Apa itu Android dalam konteks ini?
Android adalah sistem operasi sekaligus ekosistem build. Saat Anda merilis aplikasi atau plugin Capacitor di Android, proyek Anda akan melalui:
- Gradle sebagai build system.
- Android Gradle Plugin (AGP) sebagai integrasi Gradle khusus Android.
- Toolchain Android SDK untuk packaging, shrinking, linting, dan menghasilkan
.aar,.apk, atau.aaboutput.
Ketika versi AGP berubah, beberapa default dan file internal juga bisa berubah. Konfigurasi plugin yang berfungsi di AGP 8 bisa gagal di AGP 9 jika menunjuk ke baseline yang dihapus atau deprecated.
Apa itu Capacitor?
Capacitor adalah runtime lintas platform yang memungkinkan Anda membangun aplikasi iOS/Android dengan web code (TypeScript, JavaScript, HTML, CSS) sambil tetap memanggil API native.
Aplikasi Capacitor biasanya mencakup:
- Lapisan web (UI dan logika bisnis Anda)
- Shell native (
ios/,android/) - Plugin yang mengekspos fitur native ke JavaScript
Setiap plugin memiliki konfigurasi build native-nya sendiri. Di Android, ini berarti setiap plugin menyertakan android/build.gradle file yang harus di-parse dan dikompilasi dengan benar oleh AGP.
Jika pengaturan Gradle plugin sudah usang, build aplikasi keseluruhan bisa gagal, bahkan jika web code Anda sudah benar.
Apa itu Capgo?
Capgo menyediakan alat seputar pengiriman dan operasi Capacitor:
- Live Updates untuk perubahan web bundle
- Ekosistem plugin dan paket fitur native
- Alur kerja update yang ramah CI/CD untuk tim Capacitor
Meskipun ada live update, stabilitas native build tetap tidak bisa ditawar. Anda tetap membutuhkan build Android yang bersih untuk:
- Rilis App Store / Play Store
- Upgrade plugin native
- Migrasi SDK platform
- Onboarding tim dan keandalan CI
Itulah mengapa perbaikan kompatibilitas AGP 9 penting: mereka menjaga lapisan plugin Anda tetap andal sehingga pipeline pengiriman tetap dapat diprediksi.
Mengapa AGP 9 merusak konfigurasi plugin lama
Banyak template plugin secara historis menggunakan:
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
Dalam setup AGP 9, referensi baseline legacy ini bisa gagal karena file lama tidak lagi dijamin berada di lokasi yang diharapkan oleh template/konfigurasi lama.
Gejala umumnya berupa error Gradle saat assemble, lint, atau build fase build, sering menandakan resource baseline ProGuard hilang atau referensi file default tidak valid.
Sekilas: ProGuard, R8, dan file baseline
- R8 adalah code shrinker/optimizer modern pada build Android.
proguard-rules.proadalah aturan keep kustom project/plugin Anda.getDefaultProguardFile(...)menyuntikkan baseline yang disediakan Android.
Saat Anda mereferensikan:
proguard-android.txt-> baseline minimal legacyproguard-android-optimize.txt-> baseline modern yang dioptimalkan (default yang direkomendasikan di setup saat ini)
Untuk kompatibilitas dengan AGP 9, beralih ke proguard-android-optimize.txt adalah solusi praktisnya.
Perbaikan satu baris
Perbarui file Gradle plugin dan modul aplikasi:
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
Setidaknya periksa:
android/build.gradledi setiap pluginexample-app/android/app/build.gradledi repo plugin- File generator/template yang membuat config Gradle plugin baru
Panduan migrasi untuk satu plugin
1. Cari referensi lama
rg -n "proguard-android\\.txt" android example-app
2. Ganti referensi tersebut
perl -pi -e "s/proguard-android\\.txt/proguard-android-optimize.txt/g" \
android/build.gradle example-app/android/app/build.gradle
3. Verifikasi dengan Bun
bun run verify:android
Jika plugin Anda punya script verifikasi lengkap, jalankan:
bun run verify
Update massal semua repo plugin
Jika Anda mengelola banyak repo plugin dalam satu workspace, otomatiskan:
rg -l "proguard-android\\.txt" capacitor-* \
--glob '!**/node_modules/**' \
--glob '!**/.gradle/**' \
--glob '!**/build/**' \
| xargs perl -pi -e "s/proguard-android\\.txt/proguard-android-optimize.txt/g"
Lalu validasi bahwa tidak ada source plugin terlacak yang masih memakai file lama:
for d in capacitor-*; do
[ -d "$d/.git" ] || continue
git -C "$d" grep -n "proguard-android\\.txt" -- || true
done
Tidak ada hasil berarti referensi baseline lama sudah hilang dari file plugin yang dilacak.
Status rollout Capgo
Kami menyelesaikan migrasi ini di semua repositori dan template plugin resmi Capgo Capacitor:
- Modul Android plugin sekarang merujuk ke
proguard-android-optimize.txt - Aplikasi contoh Android plugin juga diperbarui
- Template scaffolding plugin diperbarui agar plugin baru aman untuk AGP 9 secara default
Ini mencegah kegagalan umum pada upgrade AGP 9 sebelum terjadi di CI.
Mengapa ini penting meskipun build Anda berhasil saat ini
Anda mungkin tidak melihat kegagalan segera jika:
- Cache CI Anda masih menutupi masalahnya
- Versi AGP Anda tercampur di berbagai proyek
- Hanya beberapa modul yang di-rebuild di dev lokal
Namun pada akhirnya, clean build, environment baru, atau runner yang di-upgrade akan memunculkannya. Melakukan migrasi sekarang menghilangkan ketidakstabilan tersembunyi.
Troubleshooting jika build masih gagal setelah penggantian
Cek poin berikut:
-
Semua modul sudah di-patch. Cek modul plugin, modul app, sample, dan aset template.
-
Tidak ada referensi ganda di shared script. Cari di seluruh repositori (termasuk script Gradle kustom).
-
Cache sudah bersih. Jalankan
./gradlew cleandan rebuild. -
Versi AGP / Gradle / JDK sudah selaras. Gunakan kombinasi yang didukung dokumentasi Android untuk versi AGP Anda.
-
CI memakai versi yang sama dengan lokal. Pin versi JDK dan Gradle wrapper di CI untuk menghindari environment drift.
-
Anda tidak hanya melakukan patch pada
node_modules. Perbaiki source plugin yang terlacak, bukan direktori dependency transient.
SEO FAQ: Error build plugin AGP 9 Capacitor
Bagaimana cara memperbaiki proguard-android.txt tidak ditemukan di AGP 9?
Ganti:
getDefaultProguardFile('proguard-android.txt')
Dengan:
getDefaultProguardFile('proguard-android-optimize.txt')
Lalu jalankan clean rebuild.
Mengapa build plugin Capacitor saya gagal setelah upgrade ke Android Gradle Plugin 9?
Kebanyakan kegagalan berasal dari konfigurasi Gradle lama di plugin android/build.gradle file yang masih merujuk ke proguard-android.txt. Proyek AGP 9 sebaiknya menggunakan proguard-android-optimize.txt.
Apa jalur migrasi AGP 9 tercepat untuk banyak plugin Capacitor?
Gunakan perintah search-and-replace di seluruh workspace, lalu validasi dengan git grep lalu jalankan bun run verify:android pada plugin yang representatif.
Apakah ini hanya masalah Capacitor?
Tidak. Modul Android mana pun (app atau library) yang menggunakan referensi baseline ProGuard yang sudah deprecated dapat mengalami error build AGP 9 serupa. Hal ini terutama terlihat di ekosistem plugin karena banyak repositori berbagi template lama.
Kata kunci apa yang relevan untuk migrasi ini?
Jika Anda mendokumentasikan ini di runbook internal atau halaman dukungan, sertakan istilah seperti:
- error build AGP 9
- file ProGuard Android Gradle Plugin 9 tidak ditemukan
- build Android plugin Capacitor gagal
proguard-android.txtpenggantiproguard-android-optimize.txtmigrasi
Tautan terkait
- Pengembang Android: Ringkasan build aplikasi Anda
- Android Gradle Plugin: Catatan rilis
- Shrinking code Android: R8 dan rules
- Dokumentasi Gradle: Dasar-dasar build tool
- Dokumentasi Capacitor: Dokumentasi resmi
- Dokumentasi Capgo: Dokumentasi auto update
Kesimpulan akhir
Masalah AGP 9 ini sederhana, tapi mudah terlewat di workspace multi-plugin. Begitu Anda mengganti proguard-android.txt dengan proguard-android-optimize.txt di mana pun relevan, build Android kembali menjadi dapat diprediksi.
Jika Anda menggunakan plugin Capgo, migrasi ini sudah diterapkan di repositori resmi sehingga Anda bisa upgrade dengan kejutan lebih sedikit.
Lanjut dari Capacitor Plugin AGP 9 Build Error Fix
Jika Anda menggunakan Fix Error Build Plugin AGP 9 di Capacitor untuk merencanakan otomatisasi CI/CD, hubungkan dengan CI/CD Capgo untuk workflow produk di Capgo CI/CD, Capgo Native Build untuk workflow produk di Capgo Native Builds, Integrasi Capgo untuk alur kerja produk di Integrasi Capgo, Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan Integrasi GitHub Actions untuk detail implementasi di Integrasi GitHub Actions.