Falls dein Capacitor Wenn dein Plugin nach dem Upgrade auf Android Gradle Plugin 9 (AGP 9) nicht mehr funktioniert, liegt es wahrscheinlich an einem kleinen, aber kritischen Gradle-Konfigurationsproblem.
Dieser Beitrag zielt auf häufige Suchintentionen wie:
- Capacitor Plugin-Build-Fehler AGP 9
- Android Gradle Plugin 9: Plugin-Build fehlgeschlagen
proguard-android.txtnicht gefunden- AGP 9
getDefaultProguardFileFehler - Capacitor Android-Build nach AGP-Upgrade fehlgeschlagen
Die Kurzversion:
proguard-android.txtist in AGP 9 Plugin Builds nicht mehr die sichere Standardbasis, auf die man sich beziehen sollte.- Wechsle zu
proguard-android-optimize.txt. - Neu bauen und verifizieren.
Die längere Version ist ebenfalls wichtig, besonders wenn du viele Plugins oder große Capacitor Workspaces pflegst. In diesem Artikel behandeln wir:
- Die Rolle von Android und AGP in der Build-Chain
- Was Capacitor ist und wie Plugin-Builds funktionieren
- Was Capgo ist und warum das für die Release-Stabilität wichtig ist
- Die genaue AGP-9-Änderung, die alte Plugin-Templates bricht
- Eine sichere Migrationsstrategie für ein oder mehrere Repos
Was bedeutet Android in diesem Kontext?
Android ist sowohl ein Betriebssystem als auch ein Build-Ökosystem. Wenn du eine Capacitor-App oder ein Plugin für Android auslieferst, durchläuft dein Projekt:
- Gradle- als Build-System.
- Android Gradle Plugin (AGP) als Android-spezifische Gradle-Integration.
- Die Android SDK Toolchain für Packaging, Shrinking, Linting und das Erzeugen von
.aar,.apk, oder.aabOutputs.
Wenn sich AGP-Versionen ändern, können sich auch Defaults und interne Dateien ändern. Eine Plugin-Konfiguration, die mit AGP 8 funktionierte, kann bei AGP 9 fehlschlagen, wenn sie auf eine entfernte oder veraltete Baseline verweist.
Was ist Capacitor?
Capacitor ist eine plattformübergreifende Runtime, mit der du iOS-/Android-Apps mit Web-code (TypeScript, JavaScript, HTML, CSS) entwickelst und dabei weiterhin auf native APIs zugreifen kannst.
Capacitor-Apps enthalten in der Regel:
- Eine Web-Schicht (deine UI und Geschäftslogik)
- Native Shells (
ios/,android/) - Plugins, die native Funktionen für JavaScript bereitstellen
Jedes Plugin hat seine eigene native Build-Konfiguration. Auf Android bedeutet das, dass jedes Plugin eine android/build.gradle Datei enthält, die AGP korrekt parsen und kompilieren muss.
Wenn die Gradle-Einstellungen der Plugins veraltet sind, kann der gesamte App-Build fehlschlagen – selbst wenn dein Web-code korrekt ist.
Was ist Capgo?
Capgo bietet Tools für die Auslieferung und den Betrieb von Capacitor:
- Live Updates für Web-Bundle-Änderungen
- Plugin-Ökosystem und native Feature-Pakete
- CI/CD-freundliche Update-Workflows für Capacitor-Teams
Auch mit Live Updates ist die Stabilität des Native Builds unverhandelbar. Saubere Android-Builds sind weiterhin nötig für:
- App Store- / Play Store-Releases
- Native Plugin-Updates
- Plattform-SDK-Migrationen
- Team-Onboarding und CI-Verlässlichkeit
Deshalb sind Kompatibilitätsfixes für AGP 9 wichtig: Sie sorgen dafür, dass Ihre Plugin-Ebene zuverlässig bleibt und die Delivery-Pipelines vorhersehbar sind.
Warum AGP 9 ältere Plugin-Konfigurationen bricht
Viele Plugin-Templates haben historisch Folgendes verwendet:
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
In AGP-9-Setups kann diese Legacy-Baseline-Referenz fehlschlagen, da die alte Datei nicht mehr an der von älteren Templates/Configs erwarteten Position garantiert ist.
Typische Symptome umfassen Gradle-Fehler während der assemble, lint, oder build Phasen, die häufig auf fehlende ProGuard-Baseline-Ressourcen oder ungültige Standarddateireferenzen hinweisen.
Kurzer Hintergrund: ProGuard, R8 und Baseline-Dateien
- R8 ist der moderne code-Shrinker/Optimizer in Android-Builds.
proguard-rules.prosind deine benutzerdefinierten Keep-Rules für Projekt/Plugin.getDefaultProguardFile(...)fügt eine von Android bereitgestellte Baseline ein.
Wenn du referenzierst:
proguard-android.txt-> Legacy, minimale Baselineproguard-android-optimize.txt-> Moderne, optimierte Baseline (empfohlener Standard in aktuellen Setups)
Für AGP-9-Kompatibilität ist der Wechsel zu proguard-android-optimize.txt die praktische Lösung.
Der Einzeiler-Fix
Gradle-Dateien für Plugin- und App-Modul aktualisieren:
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
Prüfe mindestens:
android/build.gradlein jedem Pluginexample-app/android/app/build.gradlein den Plugin-Repos- Alle Generator-/Template-Dateien, die neue Plugin-Gradle-Configs erstellen
Migrationsguide für ein Plugin
1. Alte Referenz finden
rg -n "proguard-android\\.txt" android example-app
2. Ersetzen
perl -pi -e "s/proguard-android\\.txt/proguard-android-optimize.txt/g" \
android/build.gradle example-app/android/app/build.gradle
3. Mit Bun verifizieren
bun run verify:android
Wenn dein Plugin vollständige Verification-Skripte hat, führe aus:
bun run verify
Batch-Update aller Plugin-Repos
Wenn du viele Plugin-Repos in einem Workspace pflegst, automatisiere es:
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"
Validiere dann, dass keine getrackte Plugin-Quelle die alte Datei noch verwendet:
for d in capacitor-*; do
[ -d "$d/.git" ] || continue
git -C "$d" grep -n "proguard-android\\.txt" -- || true
done
Keine Treffer bedeutet, dass der alte Baseline-Verweis aus den getrackten Plugin-Dateien verschwunden ist.
Capgo Rollout-Status
Wir haben diese Migration in allen offiziellen Capgo Capacitor-Plugin-Repositories und -Templates abgeschlossen:
- Android-Module von Plugins verweisen jetzt auf
proguard-android-optimize.txt - Auch die Android-Beispiel-Apps der Plugins wurden aktualisiert
- Die Plugin-Scaffolding-Templates wurden aktualisiert, damit neue Plugins standardmäßig AGP-9-konform sind
So wird eine häufige Art von AGP-9-Upgrade-Fehlern verhindert, bevor sie die CI treffen.
Warum das wichtig ist, auch wenn dein Build heute noch durchläuft
Möglicherweise sehen Sie keine Fehler sofort, wenn:
- Ihr CI-Cache maskiert das Problem weiterhin
- Sie verwenden gemischte AGP-Versionen über Projekte hinweg
- Nur einige Module werden in der lokalen Entwicklung neu gebaut
Doch irgendwann decken Clean Builds, neue Umgebungen oder aktualisierte Runner es auf. Die Migration jetzt beseitigt versteckte Instabilität.
Fehlersuche, falls Builds nach dem Austausch weiterhin fehlschlagen
Prüfe diese Punkte:
-
Jedes Modul ist gepatcht. Prüfe Plugin-Module, App-Module, Samples und Template-Assets.
-
Keine zweite Referenz in Shared Scripts. Durchsuche die gesamten Repositories (inklusive Custom Gradle Scripts).
-
Caches sind sauber. Führe aus
./gradlew cleanund baue neu. -
AGP-/Gradle-/JDK-Versionen sind abgestimmt. Nutze Kombinationen, die laut Android-Dokumentation für deine AGP-Version unterstützt werden.
-
CI nutzt dieselben Versionen wie lokal. Pinning von JDK- und Gradle-Wrapper-Versionen in der CI, um Environment-Drift zu vermeiden.
-
Du patchst nicht nur
node_modules. Fixe den eingecheckten Plugin-Quellcode, nicht flüchtige Dependency-Verzeichnisse.
SEO FAQ: AGP 9 Capacitor Plugin-Build-Fehler
Wie behebe ich proguard-android.txt nicht gefunden in AGP 9?
Ersetzen:
getDefaultProguardFile('proguard-android.txt')
Durch:
getDefaultProguardFile('proguard-android-optimize.txt')
Dann einen sauberen Rebuild ausführen.
Warum schlägt der Build meines Capacitor Plugins nach dem Upgrade auf Android Gradle Plugin 9 fehl?
Die meisten Fehler stammen von veralteter Gradle-Konfiguration in der Plugin- android/build.gradle datei, die noch auf proguard-android.txtverweist. AGP-9-Projekte sollten proguard-android-optimize.txt.
Was ist der schnellste Migrationsweg zu AGP 9 für viele Capacitor Plugins?
Verwende einen workspaceweiten Suchen-und-Ersetzen-Befehl und validiere anschließend mit git grep und führe aus bun run verify:android an repräsentativen Plugins.
Ist das nur ein Problem mit Capacitor?
Nein. Jedes Android-Modul (App oder Library), das veraltete ProGuard-Baseline-Referenzen verwendet, kann auf ähnliche AGP-9-Buildfehler stoßen. Besonders sichtbar ist das in Plugin-Ökosystemen, weil viele Repositories alte Templates teilen.
Welche Keywords sind für diese Migration relevant?
Wenn du das in internen Runbooks oder Supportseiten dokumentierst, füge Begriffe wie diese hinzu:
- AGP-9-Buildfehler
- Android Gradle Plugin 9 ProGuard-Datei fehlt
- Capacitor Plugin Android-Build fehlgeschlagen
proguard-android.txtErsetzungproguard-android-optimize.txtMigration
Weiterführende Links
- Android-Entwickler: App-Build-Übersicht
- Android Gradle Plugin: Release Notes
- Android code Shrinking: R8 und Regeln
- Gradle Docs: Grundlagen der Build-Tools
- Capacitor Docs: Offizielle Dokumentation
- Capgo Docs: Auto-Update-Docs
Final takeaway
Dieses AGP-9-Problem ist einfach, aber in Multi-Plugin-Workspaces leicht zu übersehen. Sobald du proguard-android.txt mit proguard-android-optimize.txt an allen relevanten Stellen ersetzt, werden Android-Builds wieder vorhersehbar.
Wenn du Capgo-Plugins verwendest, wurde diese Migration in den offiziellen Repositories bereits angewendet, sodass du mit weniger Überraschungen upgraden kannst.
Weiterlesen: Capacitor Plugin AGP 9 Build Error Fix
Wenn du es nutzt AGP-9-Build-Fehler im Capacitor Plugin beheben um CI/CD-Automatisierung zu planen, verbinde es mit Capgo CI/CD für den Produkt-Workflow in Capgo CI/CD, Capgo Native Builds optimieren für den Produkt-Workflow in Capgo Native Builds, Capgo Integrationen für den Produkt-Workflow in Capgo Integrations, CI/CD-Integration für die Implementierungsdetails in der CI/CD-Integration und GitHub Actions-Integration für die Implementierungsdetails in der GitHub Actions-Integration.