Capacitor Plugin AGP 9 Build Error Fix

Jika plugin Capacitor anda mulai mengalami kesalahan setelah mengupgrade ke Android Gradle Plugin 9 (AGP 9), kemungkinan besar Anda menghadapi masalah konfigurasi Gradle yang kecil tetapi sangat kritis.

Artikel ini secara spesifik menargetkan niat pencarian umum seperti:

Capacitor plugin build error AGP 9
Plugin AGP 9 plugin build gagal
proguard-android.txt tidak ditemukan
AGP 9 getDefaultProguardFile kesalahan
Capacitor build Android gagal setelah mengupgrade AGP

Versi singkat:

proguard-android.txt tidak lagi merupakan dasar aman default untuk referensi di AGP 9 plugin builds.
Switch ke proguard-android-optimize.txt.
Rebuild dan verifikasi.

Versi yang lebih panjang juga penting, terutama jika Anda menjaga banyak plugin atau workspace Capacitor yang besar. Dalam artikel ini kami membahas:

Apa itu Android dan AGP di rantai build
Apa itu Capacitor dan bagaimana plugin builds bekerja
Apa itu __CAPGO_KEEP_0__ dan mengapa hal ini penting untuk keandalan rilis Capgo Strategi migrasi aman untuk satu repo atau banyak repo
__CAPGO_KEEP_0__
__CAPGO_KEEP_0__

Apa itu Android dalam konteks ini?

Android adalah baik sistem operasi maupun ekosistem pembangunan. Ketika Anda mengirimkan aplikasi atau plugin Capacitor pada Android, proyek Anda akan melewati:

Gradle sebagai sistem pembangunan.
Android Gradle Plugin (AGP) sebagai integrasi Gradle yang spesifik untuk Android.
Toolchain Android SDK untuk pengemasan, pengurangan, pemeriksaan kesalahan, dan produksi .aar, .apk, atau .aab output.

Ketika versi AGP berubah, beberapa default dan file internal juga dapat berubah. Konfigurasi plugin yang berfungsi untuk AGP 8 dapat gagal pada AGP 9 jika mengacu pada basis yang dihapus atau yang sudah tidak digunakan lagi.

Apa itu Capacitor?

Capacitor adalah runtime lintas platform yang memungkinkan Anda membangun aplikasi iOS/Android dengan web code (TypeScript, JavaScript, HTML, CSS) sambil masih memanggil API native.

Capacitor aplikasi biasanya mencakup:

Layer web (logika bisnis dan UI Anda)
Kotak native (ios/, android/)
Plugin yang mengungkapkan fitur native ke JavaScript

Setiap plugin memiliki konfigurasi build native sendiri. Pada Android, ini berarti setiap plugin termasuk sebuah android/build.gradle file yang AGP harus memproses dan mengompilasi dengan benar.

Jika pengaturan Gradle plugin sudah ketinggalan zaman, proses build aplikasi seluruhnya bisa gagal, bahkan ketika web code Anda sudah benar.

Apa itu Capgo?

Capgo menawarkan alat seputar pengiriman dan operasi Capacitor:

Perbaruan langsung untuk perubahan bundle web
Sistem plugin dan paket fitur asli
Alur kerja perbaruan yang ramah CI/CD untuk Capacitor tim

Meskipun ada perbaruan langsung, kestabilan pembangunan asli tidak dapat ditawar. Anda masih memerlukan pembangunan Android yang bersih untuk:

Rilis App Store / Play Store
Pengembangan plugin asli
Migrasi platform SDK
Kepatuhan tim dan keandalan CI

Oleh karena itu, perbaikan kompatibilitas AGP 9 penting: mereka menjaga lapisan plugin tetap dapat diandalkan sehingga alur pipa pengiriman tetap dapat diprediksi.

Mengapa AGP 9 memecahkan konfigurasi plugin yang lebih tua

Banyak template plugin secara historis menggunakan:

proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'

In AGP 9 konfigurasi, referensi dasar ini dapat gagal karena file lama tidak lagi dapat dijamin ada di lokasi yang diharapkan oleh template/konfigurasi yang lebih tua.

Gejala yang umum termasuk kesalahan Gradle selama assemble, lint, atau build tahap, sering kali menunjukkan sumber daya ProGuard dasar yang hilang atau referensi file default yang tidak valid.

Latar belakang singkat: ProGuard, R8, dan file dasar

R8 adalah kompresi/optimasi modern code dalam pembangunan Android.
proguard-rules.pro adalah aturan pengecualian yang disesuaikan oleh proyek/plugin Anda.
getDefaultProguardFile(...) menambahkan referensi dasar yang disediakan oleh Android.

Saat Anda mengacu pada:

proguard-android.txt -> referensi dasar minimal yang lama
proguard-android-optimize.txt -> referensi dasar yang dioptimalkan modern (rekomendasi default dalam konfigurasi saat ini)

For kompatibilitas AGP 9, beralih ke proguard-android-optimize.txt adalah solusi yang lebih praktis.

Solusi satu baris

Update file Gradle plugin dan modul aplikasi:

proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'

Paling tidak, periksa:

android/build.gradle dalam setiap plugin
example-app/android/app/build.gradle dalam repositori plugin
Apapun file generator/template yang membuat konfigurasi Gradle baru plugin

Petunjuk migrasi untuk satu plugin

1. Temukan referensi lama

rg -n "proguard-android\\.txt" android example-app

2. Ganti dengan __CAPGO_KEEP_0__

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 memiliki skrip verifikasi lengkap, jalankan:

bun run verify

Perbarui semua repositori plugin secara batch

Jika Anda menjaga banyak repositori plugin dalam satu workspace, otomatisasikan:

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"

Validasi bahwa tidak ada sumber plugin yang diikuti masih menggunakan file lama:

for d in capacitor-*; do
  [ -d "$d/.git" ] || continue
  git -C "$d" grep -n "proguard-android\\.txt" -- || true
done

Tidak ada match berarti referensi baseline lama hilang dari file plugin yang diikuti.

Status Capgo rollout

Kami telah menyelesaikan migrasi ini di semua repositori dan template resmi Capgo Capacitor:

Modul Android plugin sekarang mengacu pada proguard-android-optimize.txt
Contoh aplikasi Android plugin telah diperbarui juga
Template pengembangan plugin telah diperbarui sehingga plugin baru secara default aman untuk AGP 9

Ini mencegah jenis kesalahan upgrade AGP 9 yang umum sebelum mereka menabrak CI.

Mengapa ini penting bahkan jika build Anda berhasil hari ini

Mungkin Anda tidak melihat gagalnya segera jika:

Cache CI Anda masih menyembunyikan masalah
Anda memiliki versi AGP yang campur aduk di antara proyek
Hanya beberapa modul yang dibangun ulang dalam pengembangan lokal

Tapi akhirnya, bangun bersih, lingkungan baru, atau pengguna runner yang ditingkatkan mengungkapkannya. Melakukan migrasi sekarang menghilangkan ketidakstabilan yang disembunyikan.

Mengatasi masalah jika bangun masih gagal setelah penggantian

Periksa poin-poin berikut:

Setiap modul telah diperbaiki. Lihat modul plugin, modul aplikasi, contoh, dan aset template.
Tidak ada referensi kedua di skrip bersama. Cari seluruh repositori (termasuk skrip Gradle yang disesuaikan).
Cache bersih. Jalankan ./gradlew clean dan bangun ulang.
Versi AGP / Gradle / JDK disesuaikan. Gunakan kombinasi yang didukung oleh dokumentasi Android untuk versi AGP Anda.
CI menggunakan versi yang sama seperti lokal. Tetapkan versi JDK dan wrapper Gradle di CI untuk menghindari perubahan lingkungan.
Anda tidak hanya memperbaiki node_modules. Perbaiki sumber plugin yang dipantau, bukan direktori dependensi transient.

FAQ SEO: AGP 9 Capacitor plugin build error

Bagaimana cara saya memperbaiki `proguard-android.txt` tidak ditemukan di AGP 9?

Ganti:

getDefaultProguardFile('proguard-android.txt')

Dengan:

getDefaultProguardFile('proguard-android-optimize.txt')

Lalu jalankan rebuild bersih.

Mengapa plugin Capacitor saya gagal dibangun setelah mengupgrade ke Android Gradle Plugin 9?

Kebanyakan gagal berasal dari konfigurasi Gradle legacy di plugin android/build.gradle file yang masih mengacu proguard-android.txt. Projek AGP 9 harus menggunakan proguard-android-optimize.txt.

Apa saja cara migrasi AGP 9 yang paling cepat untuk banyak plugin Capacitor?

Gunakan perintah pencarian dan penggantian secara berbasis workspace, kemudian validasi dengan git grep dan jalankan bun run verify:android pada plugin representatif.

Apakah ini hanya masalah Capacitor saja?

Tidak. Apapun modul Android (aplikasi atau library) yang menggunakan referensi ProGuard yang sudah usang dapat mengalami kesalahan AGP 9 yang sama. Hal ini sangat terlihat dalam ekosistem plugin karena banyak repository yang menggunakan template lama.

Apa saja kata kunci yang relevan untuk migrasi ini?

Jika Anda sedang mendokumentasikan hal ini dalam buku petunjuk internal atau halaman dukungan, termasuklah istilah seperti:

Kesalahan AGP 9
File ProGuard Android Gradle Plugin 9 yang hilang
Plugin Capacitor gagal membangun Android
proguard-android.txt penggantian
proguard-android-optimize.txt migrasi

Android Developers: Tinjauan pembangunan aplikasi Anda
Android Plugin Gradle: Catatan rilis
Android code pengurangan ukuran: R8 dan aturan
Dokumen Gradle: Dasar-dasar alat pembangunan
Capacitor dokumen: Dokumentasi resmi
Capgo dokumen: Dokumen pembaruan otomatis

Poin penting terakhir

Masalah ini dengan AGP 9 sangat sederhana, tetapi mudah dilupakan dalam workspace plugin multi. proguard-android.txt Setelah Anda mengganti proguard-android-optimize.txt dengan

If you use Capgo plugins, this migration is already applied in official repositories so you can upgrade with fewer surprises.

Keep going from Capacitor Plugin AGP 9 Build Error Fix

__CAPGO_KEEP_0__ plugin, migrasi ini sudah diterapkan di repositori resmi sehingga Anda dapat mengupgrade dengan lebih sedikit kejutan. Capacitor Plugin AGP 9 Build Error Fix __CAPGO_KEEP_0__ Plugin AGP 9 Build Error Fix","Jika Anda menggunakan plugin","__CAPGO_KEEP_0__ Plugin AGP 9 Build Error Fix","untuk merencanakan otomatisasi CI/CD, hubungkannya dengan Capgo Pengujian Integrasi untuk alur kerja produk di Capgo Pengujian Integrasi, Capgo Pembangunan Nativ untuk alur kerja produk di Capgo Pembangunan Nativ, Capgo Integrasi untuk alur kerja produk di Capgo Integrasi, Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan GitHub Integrasi Aksi untuk detail implementasi di GitHub Integrasi Aksi.