@capgo/capacitor-patch

Wende geprüfte Fixes auf die Capacitor-Kernpakete, die CLI, Plugins und native Projekte während der Sync- und Update-Hooks an.

Loslegen GitHub

@capgo/capacitor-patch ist ein rein auf Hooks basierendes Capacitor-Paket, das ausgewählte Patch-Dateien anwendet, sobald Capacitor ausgeführt wird sync oder update.

Es ist für Fixes gedacht, die nützlich sind, bevor sie in einem offiziellen Capacitor-Release landen. Der mitgelieferte Katalog verfolgt externe Upstream-Capacitor-PRs, gespiegelt von Capacitor+ sync/upstream-pr-* Branches.

Plattformunterstützung

Plattform	Support	Notizen
iOS	Hook	cap sync patches
Android	Hook	cap sync patches
Web	n. v.	Nur CLI

Was gepatcht wird

Capacitor Pakete

Patch @capacitor/core, @capacitor/android, @capacitor/iosund Drittanbieter-Capacitor-Plugins unter node_modules.

Capacitor CLI

Patch bereits ausgelieferte CLI-JavaScript-Dateien. Wenn ein CLI-Patch angewendet wird, nutzt das nächste cap Befehl die gepatchte code.

Native Projekte

Wende generierte Android- oder iOS-Projektpatches nach cap sync oder cap update.

Sichere Auswahl

Versionsbereiche, Idempotenzprüfungen und der Strict-Mode helfen dabei, zu verhindern, dass veraltete Patches stillschweigend angewendet werden.

Patch-Katalog

Patches sind standardmäßig opt-in. Liste den mitgelieferten Katalog auf, wähle die Patch-IDs aus, die deine App braucht, und füge sie hinzu plugins.CapacitorPatch.patches.

Jeder Katalogeintrag enthält:

eine stabile Patch-ID
das Zielpaket oder die native Projektphase
den unterstützten Versionsbereich
den upstream Capacitor PR
den passenden Capacitor+ Sync-Branch
die mit dem Paket ausgelieferte Patch-Datei

Warum nutzen?

Nutzt @capgo/capacitor-patch wenn:

ein Capacitor-Fix upstream existiert, aber noch nicht veröffentlicht wurde
deine App den Fix braucht, ohne lokale Patch-Skripte pflegen zu müssen
du möchtest, dass Patches nach jedem Capacitor-Sync/Update erneut angewendet werden
du einen teamlesbaren Katalog der Fixes benötigst, von denen deine App abhängt

Für einen vollständigen Katalog und einen Beitragsleitfaden siehe die capacitor-patch-Repository.

Weiter von @capgo/capacitor-patch

Wenn du es nutzt @capgo/capacitor-patch Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-patch verwenden für die native Funktion in „Using @capgo/capacitor-patch“, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für das Implementierungsdetail beim Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow bei den Ionic Enterprise Plugin-Alternativen.