Anfahrt

GitHub

Kopieren Sie einen Setup-Vorschlag mit den Installationsanweisungen und der vollständigen Markdown-Dokumentation für diesen Plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-patch`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/capacitor-patch/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Installieren

Sie können unsere KI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihrer KI-Tool mithilfe der folgenden Befehl hinzu:

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 Plattform-spezifischen Anweisungen unten 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 erneut ausführen:

npx cap sync

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

und

Verwendung doctor Terminalfenster

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

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

npx capgo-capacitor-patch apply --phase package

Konfigurationsoptionen

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

CLI-Befehle

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

Nützliche Optionen:

--root <dir> setzt den Anwendungsroot.
--phase package|native|all beschränkt die Ausführung der Reparaturphase.
--platform ios|android wirkt eine Plattformfilterung außerhalb eines Capacitor-Hooks.
--strict Behandelt ausgewählte Patches als Fehler.

Arbeitsablauf

Sektion mit dem Titel "Arbeitsablauf" @capgo/capacitor-patch.
Installieren npx capgo-capacitor-patch list --all.
Ausführen plugins.CapacitorPatch.patches.
Fügen Sie die ausgewählten Patches IDs zu npx capgo-capacitor-patch doctor --strict.
Ausführen npx cap sync.

Ausführen @capacitor/cli, the patch applies to the installed CLI package and the next cap command uses the patched CLI code.

befehlt den gepatchten __CAPGO_KEEP_0 CAPGO_KEEP_1__ verwendet.

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 Ionic Enterprise Plugin Alternativen für das Produktworkflow in Ionic Enterprise Plugin Alternativen.