Zum Inhalt springen

@capgo/capacitor-patch

Anwendbare Korrekturen auf die Capacitor-Kernpakete, die CLI, Plugins und native Projekte während der Synchronisierung und Aktualisierungsschleifen anwenden.

@capgo/capacitor-patch ist ein Hook-only-Paket für Capacitor, das ausgewählte Patches anwendet, sobald Capacitor gestartet wird sync oder update.

Es ist für Korrekturen konzipiert, die vor ihrer Veröffentlichung in einer offiziellen Capacitor-Version nützlich sind. Das integrierte Katalog verfolgt externe upstream Capacitor-Pull-Requests, die von Capacitor+ reflektiert werden sync/upstream-pr-* Zweige

Capacitor Pakete

Patch @capacitor/core, @capacitor/android, @capacitor/ios, und drittbezogene Capacitor-Plugins unter node_modules.

Capacitor CLI

Patch wurde CLI JavaScript-Dateien verschickt. Wenn ein CLI-Patch angewendet wird, verwendet der nächste cap Befehl die gepatchte code.

Native Projekte

Anwenden von generierten Android- oder iOS-Projekt-Patches nach cap sync oder cap update.

Sichere Auswahl

Versionbereiche, Idempotenzprüfungen und der strikte Modus helfen dabei, veraltete Patches, die stillschweigend angewendet werden, zu verhindern.

Patches sind standardmäßig optional. Listen Sie den gelieferten Katalog auf, wählen Sie die Patch-IDs aus, die Ihre App benötigt, und fügen Sie sie hinzu. plugins.CapacitorPatch.patches.

Jeder Katalogeintrag enthält:

  • ein stabiler Patch-Id
  • das Ziel-Paket oder das native Projektstadium
  • unterstützter Versionsbereich
  • das aufsteigende Capacitor-Pull-Request
  • das entsprechende Capacitor+-Sync-Branch
  • Die Patchesdatei, die mit dem Paket geliefert wird

Verwenden @capgo/capacitor-patch wenn:

  • ein Capacitor-Fix bereits upstream vorhanden ist, aber noch nicht geliefert wurde
  • Ihr App benötigt den Fix, ohne lokale Patcheskripte zu pflegen
  • Sie möchten, dass Patches nach jedem Capacitor-Sync/Update erneut angewendet werden
  • Sie benötigen ein teamlesbares Katalog der Fixes, auf die Ihre App angewiesen ist

Für einen vollständigen Katalog und eine Anleitung zur Mitwirkung, sehen Sie sich das capacitor-Patches-Repository an.

Wenn Sie native Plugin-Arbeit planen, verwenden Sie @capgo/capacitor-patch um es mit Verwenden Sie @capgo/capacitor-patch zur Verbindung für die native Fähigkeit in Verwenden Sie @capgo/capacitor-patch, Capgo Plugin-Ordner zur Produktworkflow in Capgo Plugin-Ordner, Capacitor Plugins von Capgo zur Implementierungsdetail in Capacitor Plugins von Capgo, Hinzufügen oder Aktualisieren von Plugins zur Implementierungsdetail in Hinzufügen oder Aktualisieren von Plugins, und Alternativen zu Ionic Enterprise Plugin für den Produktworkflow in Alternativen zu Ionic Enterprise Plugin.