Capacitor Plugin AGP 9 Buildfehler Fix

Wenn Ihr Capacitor Wenn Ihr Plugin nach dem Upgrade auf Android Gradle Plugin 9 (AGP 9) begonnen hat, zu fehlschlagen, sind Sie wahrscheinlich einem kleinen, aber kritischen Gradle-Konfigurationsproblem begegnet.

Dieser Beitrag richtet sich speziell an häufige Suchabsichten wie:

Capacitor Plugin Buildfehler AGP 9
AGP 9 Plugin Build fehlgeschlagen
proguard-android.txt nicht gefunden
AGP 9 getDefaultProguardFile Fehler
Capacitor Android Build fehlgeschlagen nach AGP Upgrade

The kurze Version:

proguard-android.txt ist nicht mehr der sichere Standardwert, der in AGP 9 Plugin-Builds als Referenz verwendet werden sollte.
Zum Wechseln proguard-android-optimize.txt.
Wiederherstellen und überprüfen.

Die längere Version ist auch wichtig, insbesondere wenn Sie viele Plugins oder große Capacitor-Arbeitsbereiche verwalten. In diesem Artikel behandeln wir:

Was Android und AGP in der Build-Kette sind
Was Capacitor ist und wie Plugin-Builds funktionieren
Was Capgo ist und warum dies für die Veröffentlichungsverlässlichkeit wichtig ist
Die genaue AGP 9-Änderung, die alte Plugin-Vorlagen bricht
Eine sichere Migrationstrategie für einen Repository oder viele Repositories

What ist Android in diesem Kontext?

Android ist sowohl ein Betriebssystem als auch ein Build-Ökosystem. Wenn Sie ein Capacitor-App oder -Plugin auf Android bereitstellen, durchläuft Ihr Projekt folgende Schritte:

Gradle als Build-System.
Android Gradle Plugin (AGP) als Android-spezifische Gradle-Integration.
Das Android-SDK-Toolchain für das Paketieren, Komprimieren, Überprüfen und Erzeugen von .aar, .apk, oder .aab Ausgaben.

Wenn sich die AGP-Version ändert, können auch einige Standards und interne Dateien geändert werden. Eine Plugin-Konfiguration, die für AGP 8 funktioniert hat, kann auf AGP 9 fehlschlagen, wenn sie auf eine entfernte oder veraltete Basis verweist.

Was ist Capacitor?

Capacitor ein plattformübergreifender Laufzeitumgebung, die Ihnen ermöglicht, iOS/Android-Anwendungen mit Web-code (TypeScript, JavaScript, HTML, CSS) zu erstellen, während Sie noch native APIs aufrufen.

Capacitor-Anwendungen umfassen üblicherweise:

Eine Web-Schicht (Ihre Benutzeroberfläche und Geschäftslogik)
Native-Shell (ios/, android/)
Plugins, die native Funktionen für JavaScript bereitstellen

Jedes Plugin hat seine eigene native Build-Konfiguration. Auf Android bedeutet dies, 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 die gesamte Anwendungsbuild fehlschlagen, selbst wenn Ihre Web-code korrekt ist.

Was ist Capgo?

Capgo bietet Werkzeuge rund um die Capacitor-Lieferung und -Betriebsweise:

Live Updates zum Web-Bundle-Wechsel
Ökosystem von Plugins und Pakete für native Funktionen
Update-Workflows für CI/CD, die sich auf Capacitor Teams beziehen

Selbst bei Live-Updates ist die Stabilität der native Build nicht verhandelbar. Sie benötigen immer noch saubere Android-Builds für:

Veröffentlichungen in App Store / Play Store
Native-Plugin-Updates
Migrations von Plattformen SDK
Einbindung von Teams und Zuverlässigkeit von CI

Das ist der Grund, warum die Kompatibilitätsfixe für AGP 9 wichtig sind: Sie halten Ihre Plugin-Schicht so lange verlässlich, bis die Lieferpipelines vorhersehbar bleiben.

Weshalb AGP 9 ältere Plugin-Konfigs bricht

Viele Plugin-Vorlagen nutzten historisch:

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

In AGP 9-Einstellungen kann diese Legacy-Baseline-Referenz fehlschlagen, da das alte Datei nicht mehr in der erwarteten Lage durch ältere Templates/Configs garantiert ist.

Typische Symptome umfassen Gradle-Fehler während der assemble, lint,- oder build -Phasen, die oft auf fehlende ProGuard-Baseline-Ressourcen oder ungültige Standarddateverweise hinweisen.

Rückgrat: ProGuard, R8 und Baseline-Dateien

R8 ist der moderne code-Shrinker/Optimierer in Android-Builds.
proguard-rules.pro beschreibt Ihre Projekt/Plugin-Custom-Keep-Regeln.
getDefaultProguardFile(...) fügt ein Android-basiertes Baseline ein.

Wenn Sie auf Folgendes verweisen:

proguard-android.txt -> Legacy-Baseline (minimal)
proguard-android-optimize.txt -> Moderne optimierte Baseline (empfohlene Standard in aktuellen Konfigurationen)

For die AGP 9-Kompatibilität, das Wechseln zu proguard-android-optimize.txt ist der praktische Fix.

Der einezeilige Fix

Update Plugin- und App-Modul-Gradle-Dateien:

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

Mindestens prüfen Sie:

android/build.gradle bei jedem Plugin
example-app/android/app/build.gradle in Plugin-Repositories
Jeder Generator/Template-Datei, die neue Plugin-Gradle-Konfiguration erstellt

Migrationshinweis für ein Plugin

1. Finden Sie die alte Referenz

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

2. Ersetzen Sie sie

perl -pi -e "s/proguard-android\\.txt/proguard-android-optimize.txt/g" \
  android/build.gradle example-app/android/app/build.gradle

3. Überprüfen Sie mit Bun

bun run verify:android

Wenn Ihr Plugin vollständige Verifizierungs-Skripte hat, führen Sie Folgendes aus:

bun run verify

Alle Plugin-Repositories aktualisieren

Wenn Sie viele Plugin-Repositorys in einem Workspace verwalten, automatisieren Sie 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"

Validieren Sie dann, dass kein verfolgtes Plugin-Quellcode noch die alte Datei verwendet:

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

Keine Übereinstimmungen bedeuten, dass die alte Basisreferenz aus den verfolgten Plugin-Dateien verschwunden ist.

Capgo Rollout-Status

Wir haben diese Migration in allen offiziellen Capgo Capacitor Plugin-Repositorys und -Vorlagen durchgeführt:

Plugin-Android-Module verweisen nun auf proguard-android-optimize.txt
Plugin-Beispiel-Android-Anwendungen wurden ebenfalls aktualisiert
Plugin-Scaffolding-Vorlagen wurden aktualisiert, sodass neue Plugins standardmäßig AGP 9-sicher sind

Dies verhindert eine häufige Klasse von AGP 9-Aufwärtsfehlermeldungen, bevor sie CI treffen

Warum dies wichtig ist, auch wenn Ihr Build heute noch erfolgreich ist

You sehen möglicherweise keine Fehler sofort, wenn:

Dein CI-Cache verdeckt immer noch das Problem
Du hast gemischte AGP-Versionen in Projekten
Nur einige Module werden in der lokalen Entwicklung neu erstellt

Aber letztendlich werden saubere Builds, neue Umgebungen oder aktualisierte Runner das Problem offenlegen. Die Migration jetzt entfernt versteckte Instabilität.

Troubleshooting, wenn Builds nach der Ersetzung weiterhin fehlschlagen

Überprüfe diese Punkte:

Jedes Modul ist gepatcht. Betrachte Plugin-Module, Anwendungs-Module, Beispiele und Vorlagen-Assets.
Gibt es keine zweite Referenz in gemeinsam genutzten Skripten. Suche in der gesamten Repository (einschließlich benutzerdefinierten Gradle-Skripten) nach.
Sind die Caches sauber. Führe ./gradlew clean und erstelle neu.
Sind AGP / Gradle / JDK-Versionen synchron. Verwende kombinierungen, die von der Android-Dokumentation für deine AGP-Version unterstützt werden.
CI verwendet die gleichen Versionen wie lokale. Pin JDK- und Gradle-Wrapper-Versionen in CI, um Umgebungsdrift zu vermeiden.
Sie patchen nicht nur node_modules. Fixen Sie die Quelle des verwalteten Plugins, nicht die transienten Abhängigkeitsverzeichnisse.

SEO FAQ: AGP 9 Capacitor Plugin-Baufehler

Wie behebe ich `proguard-android.txt` nicht gefunden in AGP 9?

Ersetzen Sie:

getDefaultProguardFile('proguard-android.txt')

Dann führen Sie einen sauberen Neubau durch.

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

Weshalb scheitert mein __CAPGO_KEEP_0__-Plugin nach dem Upgrade auf Android Gradle Plugin 9?

Why does my Capacitor plugin build fail after upgrading to Android Gradle Plugin 9?

Dateien, die sich noch auf alte Versionen beziehen android/build.gradle Warum scheitert mein __CAPGO_KEEP_0__-Plugin nach dem Upgrade auf Android Gradle Plugin 9? Die meisten Fehler kommen von der veralteten Gradle-Konfiguration in den Plugin-Dateien, die sich noch auf alte Versionen beziehen. proguard-android.txt. AGP 9 Projekte sollten AGP 9 9 Projekte sollten AGP 9 Projekte verwenden proguard-android-optimize.txt.

Was ist der schnellste Weg zur Migration von AGP 9 für viele Capacitor-Plugins?

Verwenden Sie einen workspace-weiten Such-und-Ersatz-Befehl, dann überprüfen Sie mit git grep und führen Sie bun run verify:android auf repräsentativen Plugins aus.

Gilt dies nur für ein Capacitor-Problem?

Nein. Jedes Android-Modul (Anwendung oder Bibliothek), das veraltete ProGuard-Baselinereferenzen verwendet, kann ähnliche AGP 9-Buildfehler erleiden. Dies ist insbesondere in Plugin-Ökosystemen sichtbar, weil viele Repositories alte Templates teilen.

Welche Schlüsselwörter sind für diese Migration relevant?

Wenn Sie dies in internen Runbooks oder Unterstützungsseiten dokumentieren, fügen Sie Begriffe wie:

AGP 9-Buildfehler
Android-Gradle-Plugin 9 ProGuard-Datei fehlt
Capacitor-Plugin-Android-Build fehlgeschlagen
proguard-android.txt Ersatz
proguard-android-optimize.txt Migration

Android-Entwickler: Übersicht über die App-Bauanleitung
Android-Gradle-Plugin: Hinweise zur Veröffentlichung
Android code Komprimierung: R8 und Regeln
Gradle-Dokumentation: Grundlagen der Build-Tool-Technologie
Capacitor Dokumentation: Offizielles Dokumentation
Capgo Dokumentation: Automatische Aktualisierungsdokumentation

Letzter Schlusspunkt

Diese AGP 9-Frage ist einfach, aber es ist leicht, sie in Mehr-Plugin-Umgebungen zu übersehen. Sobald Sie " proguard-android.txt mit proguard-android-optimize.txt überall relevant, werden Android-Builds wieder vorhersehbar.

Wenn Sie Capgo-Plugins verwenden, ist diese Migration bereits in offiziellen Repositorien angewendet, sodass Sie mit weniger Überraschungen aufsteigen können.

Weitermachen Sie von Capacitor-Plugin-AGP-9-Build-Fehler-Fix

Wenn Sie " Capacitor-Plugin-AGP-9-Build-Fehler-Fix " zum Planen der CI/CD-Automatisierung verwenden, verbinden Sie es mit Capgo CI/CD für den Produktworkflow in Capgo CI/CD Capgo Native Builds für den Produktworkflow in Capgo Native Builds Capgo Integrations für den Produktworkflow in Capgo Integrations CI/CD-Integration für die Implementierungsdetails in CI/CD-Integration und GitHub Actions-Integration für die Implementierungsdetails in GitHub Actions-Integration

Capacitor Plugin AGP 9 Build Error Fix