Fix Error Build Plugin AGP 9 di Capacitor

Jika Capacitor plugin mulai error setelah upgrade ke Android Gradle Plugin 9 (AGP 9), kemungkinan besar Anda mengalami masalah konfigurasi Gradle yang kecil tapi krusial.

Artikel ini ditujukan khusus untuk maksud pencarian umum seperti:

Error build plugin Capacitor pada AGP 9
Build plugin Android Gradle Plugin 9 gagal
proguard-android.txt tidak ditemukan
AGP 9 getDefaultProguardFile error
Capacitor Build Android gagal setelah upgrade AGP

Versi singkatnya:

proguard-android.txt bukan lagi baseline default yang aman untuk dirujuk pada 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 sistem build.
Android Gradle Plugin (AGP) sebagai integrasi Gradle khusus Android.
Toolchain Android SDK untuk packaging, shrinking, linting, dan menghasilkan .aar, .apk, atau .aab output.

Saat versi AGP berubah, beberapa pengaturan default dan file internal juga bisa berubah. Konfigurasi plugin yang berjalan di AGP 8 bisa gagal di AGP 9 jika merujuk ke baseline yang sudah dihapus atau deprecated.

Apa itu Capacitor?

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

Aplikasi Capacitor biasanya mencakup:

Lapisan web (UI dan business logic Anda)
Native shell (ios/, android/)
Plugin yang mengekspos fitur native ke JavaScript

Setiap plugin punya konfigurasi Native Build sendiri. Di Android, ini berarti setiap plugin menyertakan android/build.gradle file yang harus di-parse dan dikompilasi AGP dengan benar.

Jika pengaturan Gradle plugin sudah usang, seluruh proses build app bisa gagal, meskipun web code Anda sudah benar.

Apa itu Capgo?

Capgo menyediakan tools untuk pengiriman dan operasional Capacitor:

Live Updates untuk perubahan web bundle
Ekosistem plugin dan paket fitur native
Workflow update yang CI/CD-friendly untuk tim Capacitor

Meski ada live updates, stabilitas Native Build tetap krusial. Anda tetap butuh build Android yang bersih untuk:

Rilis App Store / Play Store
Upgrade plugin native
Migrasi platform SDK
Onboarding tim dan reliabilitas CI

Itulah mengapa perbaikan kompatibilitas AGP 9 penting: agar layer plugin Anda tetap andal sehingga delivery pipeline tetap terprediksi.

Mengapa AGP 9 merusak konfigurasi plugin lama

Banyak template plugin secara historis menggunakan:

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

Pada setup AGP 9, referensi baseline legacy ini bisa gagal karena file lama tidak lagi dijamin ada di lokasi yang diharapkan template/konfigurasi lama.

Gejala umum termasuk error Gradle saat assemble, lint, atau build fase, sering kali merujuk pada resource ProGuard baseline yang hilang atau referensi file default yang tidak valid.

Sekilas info: ProGuard, R8, dan baseline files

R8 adalah code shrinker/optimizer modern pada build Android.
proguard-rules.pro adalah aturan custom keep untuk proyek/plugin Anda.
getDefaultProguardFile(...) menyuntikkan baseline yang disediakan Android.

Saat Anda merujuk pada:

proguard-android.txt -> legacy, minimal baseline
proguard-android-optimize.txt -> modern optimized baseline (default yang direkomendasikan saat ini)

Untuk kompatibilitas AGP 9, beralih ke proguard-android-optimize.txt adalah solusi praktisnya.

Solusi satu baris

Update file Gradle plugin dan modul app:

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

Setidaknya periksa:

android/build.gradle di setiap plugin
example-app/android/app/build.gradle di 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

No matches berarti referensi baseline lama sudah hilang dari file plugin yang dilacak.

status rollout Capgo

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

Modul Android plugin sekarang merujuk ke proguard-android-optimize.txt
Contoh aplikasi Android plugin juga telah diperbarui
Template scaffolding plugin telah diperbarui agar plugin baru otomatis aman untuk AGP 9

Ini mencegah kegagalan upgrade AGP 9 yang umum terjadi sebelum mencapai CI.

Mengapa ini penting meski build Anda berhasil saat ini

Anda mungkin tidak langsung melihat kegagalan jika:

Cache CI Anda masih menutupi masalah tersebut
Anda menggunakan versi AGP yang campur aduk di berbagai proyek
Hanya beberapa modul yang di-rebuild saat 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 clean dan 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

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

Ganti:

getDefaultProguardFile('proguard-android.txt')

Menjadi:

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

Lalu jalankan clean rebuild.

Kenapa build plugin Capacitor saya gagal setelah upgrade ke Android Gradle Plugin 9?

Kebanyakan error disebabkan oleh konfigurasi Gradle lama pada plugin android/build.gradle di file yang masih mereferensikan 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 dan jalankan bun run verify:android pada plugin representatif.

Apakah ini hanya masalah Capacitor?

Tidak. Modul Android apa pun (app atau library) yang menggunakan referensi ProGuard baseline yang sudah deprecated bisa mengalami error build AGP 9 serupa. Hal ini sangat terlihat di ekosistem plugin karena banyak repositori menggunakan template lama.

Kata kunci apa yang relevan untuk migrasi ini?

Jika Anda mendokumentasikan ini di runbook internal atau halaman support, sertakan istilah seperti:

Kesalahan build AGP 9
File ProGuard Android Gradle Plugin 9 hilang
Android build Capacitor plugin failed
proguard-android.txt pengganti
proguard-android-optimize.txt migrasi

Untuk Developer 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. Setelah Anda mengganti proguard-android.txt dengan proguard-android-optimize.txt di bagian yang relevan, Android build akan kembali stabil.

Jika Anda menggunakan plugin Capgo, migrasi ini sudah diterapkan di repositori resmi sehingga Anda bisa upgrade dengan lebih lancar.

Lanjut ke 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.