Démarrage

Installer

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil 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 à la 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 configuration Capacitor.

Sélectionner les ID des correctifs

Lister tous les correctifs expédié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é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	Valeur par défaut	Description
recommended	boolean	false	Applique les correctifs Capgo comme recommandés.
patches	string[]	[]	Applique les identifiants de correctifs explicites.
disabled	string[]	[]	Omet les identifiants de correctifs sélectionnés, même lorsqu'ils sont recommandés.
strict	boolean	false	Lance une erreur lorsque le correctif sélectionné est incompatibles ou ne peut pas être appliqué.

Conseil

Préférez l'explicit patches pour les applications de production afin que les correctifs appliqués soient visibles dans la revue code.

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 sélectionnés de la mise à jour comme des erreurs.

Flux de travail

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

Lorsqu'une mise à jour sélectionnée cible @capacitor/clila mise à jour s'applique au package CLI installé et au prochain cap Exécution utilise la mise à jour patchée du package CLI et du code.

Continuez de la section Démarrage

Si vous utilisez Accueil 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, Mise à jour ou ajout de plugins pour le détail d'implémentation dans Mise à jour ou ajout de plugins, et Alternatives de plugins Ionic Enterprise pour le flux de travail du produit dans les alternatives de plugins Ionic Enterprise.