Débutant

Copiez un prompt de configuration avec les étapes d'installation et la guide markdown complète pour ce 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.

Installer

npm install @capgo/capacitor-patch
npx cap sync

Le package est inopérant jusqu'à ce que vous sélectionniez des correctifs dans votre fichier de configuration Capacitor.

Sélectionner les ID des correctifs

Lister tous les correctifs embarqués :

npx capgo-capacitor-patch list --all

Ajoutez ensuite les ID des correctifs dont votre application a besoin à 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;

Exécutez à nouveau la synchronisation :

npx cap sync

Les correctifs de package s'exécutent avant sync et update. Les correctifs de projet natif s'exécutent après sync et update.

Avant d'appliquer, mode débogage

Utiliser doctor pour vérifier si les correctifs sélectionnés correspondent aux versions de package installées :

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

Utilisez apply lorsque vous souhaitez exécuter les patchs sélectionnés manuellement :

npx capgo-capacitor-patch apply --phase package

Options de configuration

Option	Type	Défaut	Description
`recommended`	`boolean`	`false`	Applique les patchs Capgo comme recommandés.
`patches`	`string[]`	`[]`	Applique les identifiants de patch explicites.
`disabled`	`string[]`	`[]`	Saut les ID de patch sélectionnés, même lorsqu'ils sont recommandés.
`strict`	`boolean`	`false`	Lève une erreur lorsque le patch sélectionné est incompatibles ou ne peut pas s'appliquer.

CLI commandes

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

Options utiles :

--root <dir> fixe la racine de l'application.
--phase package|native|all limite la phase de patch qui s'exécute.
--platform ios|android applique le filtrage de plateforme en dehors d'un Capacitor hook.
--strict traite les échecs de patch sélectionnés comme des erreurs.

Flux de travail

Installer @capgo/capacitor-patch.
Démarer npx capgo-capacitor-patch list --all.
Ajoutez les identifiants de patch sélectionnés à plugins.CapacitorPatch.patches.
Démarer npx capgo-capacitor-patch doctor --strict.
Démarer npx cap sync.

Lorsqu'un patch sélectionné cible @capacitor/cli, le patch s'applique au package CLI installé et au suivant cap command utilise le patch CLI code.

Continuez de l'onglet Démarrage

Si vous utilisez Démarrage pour planifier le travail de plugin natif, connectez-le à En utilisant @capgo/capacitor-patch pour la capacité native dans En utilisant @capgo/capacitor-patch, Répertoire du plugin Capgo pour le flux de travail du produit dans Répertoire du plugin Capgo, Plugins Capacitor par Capgo pour le détail d'implémentation dans Plugins Capacitor par Capgo Ajouter ou Mettre à Jour les Plugins pour les détails d'implémentation dans Ajouter ou Mettre à Jour les Plugins, et Alternatives d'Extension d'Entreprise Ionic pour le flux de travail du produit dans Alternatives d'Extension d'Entreprise Ionic.