Anleitung zum Starten

Kopieren Sie einen Einrichtungsprompt mit den Installationsanweisungen und der vollständigen Markdown-Guideline 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

npm install @capgo/capacitor-patch
npx cap sync

Das Paket ist bis zu dem Zeitpunkt, an dem Sie Patches in Ihrer Capacitor-Konfiguration auswählen, eine No-Operation.

Patches auswählen

Alle gelieferten Patches auflisten:

npx capgo-capacitor-patch list --all

Fügen Sie dann die Patch-IDs 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;

Synchronisieren Sie erneut:

npx cap sync

und sync Native-Projekt-Patches werden nachher ausgeführt updateund sync Trockenlauf vor der Anwendung update.

Abschnitt mit dem Titel „Trockenlauf vor der Anwendung“

Verwenden Sie doctor um zu überprüfen, ob die ausgewählten Patches mit Ihren installierten Paketversionen übereinstimmen:

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

Verwenden Sie 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`	Patches Capgo als empfohlen markiert.
`patches`	`string[]`	`[]`	Patches explizite Patch-IDs anwendet.
`disabled`	`string[]`	`[]`	Ausgewählte Patch-IDs, auch wenn empfohlen, überspringt.
`strict`	`boolean`	`false`	Würft eine Ausnahme, wenn ein ausgewählter Patch inkompatibel ist oder nicht angewendet werden kann.

Abschnitt mit dem Titel “CLI Befehle”

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

Nützliche Optionen:

--root <dir> die App-Root-Verzeichnis festlegt.
--phase package|native|all beschränkt, welcher Patch-Phase ausgeführt wird.
--platform ios|android Plattformfilterung außerhalb eines Capacitor-Hooks anwendet.
--strict Ausgewählte Patchfehler als Fehler behandelt.

Arbeitsablauf

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

Wenn ein ausgewählter Patch auf @capacitor/cliden installierten CLI-Paket zielt und der nächste cap Befehl das gepatchte CLI-code verwendet.