Capacitor Plugin AGP 9 Build Error Fix

Jika Anda memiliki Capacitor plugin mulai gagal setelah mengupgrade ke Android Gradle Plugin 9 (AGP 9), Anda mungkin mengalami masalah konfigurasi Gradle kecil tetapi sangat kritis.

Artikel ini secara spesifik mengarahkan niat pencarian umum seperti:

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

Versi singkat:

proguard-android.txt tidak lagi merupakan dasar aman default untuk merujuk dalam AGP 9 plugin builds.
Ganti ke proguard-android-optimize.txt.
Rebuild dan verifikasi.

Versi yang lebih panjang juga penting, terutama jika Anda menjaga banyak plugin atau workspace besar Capacitor.

Apa itu Android dan AGP dalam rantai pembangunan?
Apa itu Capacitor dan bagaimana plugin pembangunan bekerja?
Apa itu? Capgo apa itu dan mengapa ini penting untuk keandalan rilis?
Perubahan AGP 9 yang tepat yang menghancurkan template plugin lama
Strategi migrasi aman untuk satu repositori atau banyak repositori

Apa itu Android dalam konteks ini?

Android adalah baik sistem operasi dan ekosistem pembangunan. Ketika Anda mengirimkan aplikasi __CAPGO_KEEP_0__ atau plugin pada Android, proyek Anda melalui: is both an operating system and a build ecosystem. When you ship a Capacitor app or plugin on Android, your project goes through:

Android adalah baik sistem operasi dan ekosistem pembangunan. Ketika Anda mengirimkan aplikasi __CAPGO_KEEP_0__ atau plugin pada Android, proyek Anda melalui: As sistem pembangunan.
Android Gradle Plugin (AGP) As integrasi Gradle khusus Android.
Alat Android SDK untuk pengemasan, pengurangan, pemeriksaan kesalahan, dan produksi .aar, .apk, atau .aab Hasil.

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.

Aplikasi Capacitor biasanya mencakup:

Lapisan web (antarmuka pengguna dan logika bisnis Anda)
Lingkungan shell asli (ios/, android/)
Plugin yang mengungkapkan fitur native ke JavaScript

Setiap plugin memiliki konfigurasi build native sendiri. Pada Android, ini berarti setiap plugin termasuk android/build.gradle file yang AGP harus memparse 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:

Pembaruan hidup untuk perubahan bundle web
Ekosistem plugin dan paket fitur native
Pengaturan aliran kerja CI/CD yang ramah tim Capacitor

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

Rilis App Store / Play Store
Pembaruan plugin asli
Migrasi platform SDK
Penyertaan tim dan keandalan CI

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

Mengapa AGP 9 mengganggu konfigurasi plugin yang lebih tua

Banyak template plugin sejarahnya digunakan:

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

Dalam pengaturan AGP 9, referensi dasar yang berusia ini dapat gagal karena file yang lama tidak lagi dapat dipastikan ada di lokasi yang diharapkan oleh template/config yang lebih tua.

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

Latar belakang cepat: ProGuard, R8, dan file basis

R8 adalah pengurang/optimasi modern code dalam konstruksi Android.
proguard-rules.pro apakah aturan pengecualian kustom project/plugin Anda.
getDefaultProguardFile(...) menambahkan sebuah file basis yang disediakan oleh Android.

Saat Anda mengacu:

proguard-android.txt -> basis minimal legacy
proguard-android-optimize.txt -> basis yang dioptimalkan modern (rekomendasi default dalam konfigurasi saat ini)

Untuk konsistensi AGP 9, mengganti ke proguard-android-optimize.txt adalah solusi yang lebih praktis.

Solusi satu baris

Perbarui file Gradle plugin dan modul aplikasi:

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

Setidaknya, periksa:

android/build.gradle di setiap plugin
example-app/android/app/build.gradle di repositori plugin
Berapa file generator/template yang membuat konfigurasi Gradle baru untuk 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"

Lalu 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 lama basis lama hilang dari file plugin yang diikuti.

Capgo status peluncuran

Kami telah menyelesaikan migrasi ini di semua repositori dan template plugin 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 aman secara default dari AGP 9

Hal ini mencegah jenis kesalahan klasik AGP 9 upgrade sebelum mereka menabrak CI

Mengapa ini penting bahkan jika build Anda berhasil hari ini

Anda mungkin tidak melihat gagal segera jika:

Cache CI Anda masih menyembunyikan masalah
Anda memiliki versi AGP campuran di proyek-proyek
Hanya beberapa modul yang dibangun kembali di dev lokal

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

Mengatasi masalah jika bangunan 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 kustom).
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 dengan lokal. Tetapkan versi JDK dan wrapper Gradle di CI untuk menghindari pergeseran lingkungan.
Anda tidak hanya memperbaiki node_modules Perbaiki sumber plugin yang dipantau, bukan direktori dependensi transien.

FAQ SEO: AGP 9 Capacitor error bangunan plugin

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

Ganti:

getDefaultProguardFile('proguard-android.txt')

Dengan:

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

Lalu jalankan perbaikan bersih.

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

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

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

Gunakan perintah pencarian dan penggantian secara workspace-wide, lalu validasi dengan git grep dan jalankan bun run verify:android On plugin-plugin ini.

Apakah ini hanya masalah Capacitor?

Tidak. Apapun modul Android (aplikasi atau library) yang menggunakan referensi ProGuard yang sudah tidak digunakan lagi dapat mengalami kesalahan AGP 9 saat build. Hal ini sangat terlihat di ekosistem plugin karena banyak repository yang menggunakan template lama.

Kata-kata apa yang relevan untuk migrasi ini?

Jika Anda mendokumentasikan hal ini di buku petunjuk internal atau halaman dukungan, termasuk istilah seperti:

Kesalahan build AGP 9
File ProGuard Android Developers yang hilang
Plugin Capacitor gagal build Android
proguard-android.txt pengganti
proguard-android-optimize.txt migrasi

Pengembang Android: Ringkasan aplikasi Anda
Plugin Gradle Android: Catatan rilis
Pengurangan Android code: R8 dan aturan
Dokumen Gradle: Fundamental alat pembangun
Dokumen Capacitor: Dokumentasi resmi
Dokumen Capgo: Dokumen pembaruan otomatis

Kesimpulan akhir

Masalah AGP 9 ini 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.

Jika Anda menggunakan Capacitor plugin, migrasi ini sudah diterapkan di repositori resmi sehingga Anda dapat mengupgrade dengan lebih sedikit kejutan.

Lanjutkan dari __CAPGO_KEEP_0__ Plugin AGP 9 Build Error Fix Capacitor Plugin AGP 9 Build Error Fix __CAPGO_KEEP_0__ Plugin AGP 9 Build Error Fix Capgo CI/CD Capgo CI/CD untuk alur kerja produk di Capgo CI/CD, Capgo Native Builds untuk alur kerja produk di Capgo Native Builds, Integrasi Capgo untuk alur kerja produk dalam Integrasi Capgo, Pengintegrasian CI/CD untuk detail implementasi dalam Pengintegrasian CI/CD, dan Integrasi Aksi GitHub untuk detail implementasi dalam Integrasi Aksi GitHub.