Anfahrt

Installieren

Sie können unsere KI-gestützte Einrichtung verwenden, um den Plugin zu installieren. Fügen Sie die Capgo Fähigkeiten zu Ihrem KI-Tool hinzu, indem Sie die folgende Befehl ausführen:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Verwenden Sie dann die folgende Anfrage:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-patch` plugin in my project.

Wenn Sie die manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und die unten angegebenen Plattform-spezifischen Anweisungen befolgen:

npm install @capgo/capacitor-patch
npx cap sync

Die Paketierung ist ein Nop, bis Sie Patches in Ihrer Capacitor-Konfiguration auswählen.

Patch-IDs auswählen

Alle gelieferten Patches auflisten:

npx capgo-capacitor-patch list --all

Fügen Sie dann die IDs der Patches hinzu, die Ihre App benötigt. capacitor.config.ts:

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'Example',
  webDir: 'dist',
  plugins: {
    CapacitorPatch: {
      patches: ['upstream-pr-8418-android'],
      strict: true,
    },
  },
};

export default config;

Synchronisierung nochmals ausführen:

npx cap sync

Package-Patches werden ausgeführt bevor sync und update. Native-Projekt-Patches werden nach sync und update.

Dry-run vor der Anwendung

Verwenden doctor Sie können überprüfen, ob die ausgewählten Patches mit Ihren installierten Paketversionen übereinstimmen:

npx capgo-capacitor-patch doctor --phase package --strict

Verwenden apply wenn Sie die ausgewählten Patches manuell ausführen möchten:

npx capgo-capacitor-patch apply --phase package

Konfigurationsoptionen

Option	Typ	Standard	Beschreibung
recommended	boolean	false	Stellt Patches Capgo als empfohlen dar.
patches	string[]	[]	Stellt explizite Patch-IDs dar.
disabled	string[]	[]	Überspringt die ausgewählten Patch-IDs, auch wenn sie empfohlen werden.
strict	boolean	false	Wirft eine Exception, wenn eine ausgewählte Patches inkompatibel ist oder nicht angewendet werden kann.

Tip

Verwenden Sie explizite patches zur Anwendung auf Produktionsanwendungen, damit die angewendeten Reparaturen in der code-Übersicht sichtbar sind.

CLI-Befehle

npx capgo-capacitor-patch list --all
npx capgo-capacitor-patch doctor
npx capgo-capacitor-patch apply

Hilfreiche Optionen:

• --root <dir> setzt den Anwendungsroot.
• --phase package|native|all beschränkt die Phase, die ausgeführt wird.
• --platform ios|android applit die Plattformfilterung außerhalb eines Capacitor-Hooks.
• --strict behandelt ausgewählte Patches als Fehler.

Arbeitsablauf

1. Installieren @capgo/capacitor-patch.
2. Ausführen npx capgo-capacitor-patch list --all.
3. Fügen Sie die ausgewählten Patch-IDs zu plugins.CapacitorPatch.patches.
4. Ausführen npx capgo-capacitor-patch doctor --strict.
5. Ausführen npx cap sync.

Wenn ein ausgewählter Patch auf das installierte __CAPGO_KEEP_0__-Paket und das nächste __CAPGO_KEEP_1__-Paket zielt. @capacitor/cli, the patch applies to the installed CLI package and the next cap command uses the patched CLI code.

Installieren

Wenn Sie Getting Started zum Planen von native Plugin-Arbeiten verwenden, verbinden Sie es mit Mit @capgo/capacitor-patch für die native Fähigkeit in Mit @capgo/capacitor-patch, Capgo Plugin-Verzeichnis für den Produktworkflow in Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetails in Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin Alternativen für das Produktworkflow in Ionic Enterprise Plugin Alternativen.