Anfahrtshilfe

GitHub

Kopieren Sie eine Setup-Vorlage 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

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 den folgenden Befehl ausführen:

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

Dann verwenden Sie den folgenden Prompt:

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 bis zum Auswahl von Patches in Ihrer Capacitor-Konfiguration ein Nop.

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 noch einmal ausführen:

npx cap sync

Paket-Patches laufen vorher sync und updateNative-Projekt-Patches laufen nachher sync und update.

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`	Wendet Patches Capgo als empfohlen zu.
`patches`	`string[]`	`[]`	Wendet explizite Patch-IDs an.
`disabled`	`string[]`	`[]`	Überspringt ausgewählte Patch-IDs, auch wenn sie empfohlen werden.
`strict`	`boolean`	`false`	Würfelt, 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, welcher Patch-Phase ausgeführt wird.
--platform ios|android wirkt die Plattformfilterung außerhalb eines Capacitor-Hooks.
--strict behandelt ausgewählte Fehler als Fehler.

Arbeitsablauf

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

Wenn ein ausgewählter Patch das @capacitor/cliinstallierte CLI-Paket und den nächsten cap befasst, verwendet die nächste Kommando die gepatchte CLI code.

Weitermachen von Anfang an

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.