Commencer

Copiez un prompt de configuration avec les étapes d'installation et la guide Markdown complet 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

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil d'IA en utilisant la commande suivante :

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

Ensuite, utilisez la prompt suivante :

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

Si vous préférez la configuration manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques au plateforme ci-dessous :

npm install @capgo/capacitor-patch
npx cap sync

Le package n'est pas opérationnel jusqu'à ce que vous sélectionniez des correctifs dans votre Capacitor de configuration.

Sélectionner les identifiants des correctifs

Lister tous les correctifs expédiés :

npx capgo-capacitor-patch list --all

Ajoutez ensuite les identifiants 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écuter à nouveau la synchronisation :

npx cap sync

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

et

Sous-titre « Effectuez un test sans appliquer » doctor Utilisez

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

Copier dans le presse-papier apply Utilisez

npx capgo-capacitor-patch apply --phase package

Options de configuration

Option	Type	Défaut	Description
`recommended`	`boolean`	`false`	Applique les correctifs Capgo en les marquant comme recommandés.
`patches`	`string[]`	`[]`	Applique les identifiants de correctif explicites.
`disabled`	`string[]`	`[]`	Omet les identifiants de correctif sélectionnés, même lorsqu'ils sont recommandés.
`strict`	`boolean`	`false`	Lance une erreur lorsque le correctif sélectionné est incompatible ou ne peut pas être appliqué.

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 par plateforme en dehors d'un Capacitor crochet.
--strict trait les échecs de patch sélectionnés en tant qu'erreurs.

Flux de travail

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

Lorsqu'un patch sélectionné cible @capacitor/clile patch s'applique au package CLI installé et au prochain cap la commande utilise le package CLI code patché.

Continuez de Getting Started

Si vous utilisez Démarrage pour planifier le travail de plugin natif, connectez-l’avec En utilisant @capgo/capacitor-patch pour la capacité native dans En utilisant @capgo/capacitor-patch, Répertoire de plugin Capgo pour le flux de travail du produit dans Répertoire de plugin Capgo, Plugins Capacitor par Capgo pour le détail d'implémentation dans Plugins Capacitor par Capgo, Ajouter ou mettre à jour des plugins pour le détail d'implémentation dans Ajouter ou mettre à jour des plugins, et Alternatives de plugins Ionic Enterprise pour le flux de travail du produit dans les alternatives de plugins Ionic Enterprise