Passer à la navigation principale
Retour aux plugins
@capgo/capacitor-patch
Tutoriel
@capgo/capacitor-patch

Capacitor Patch

Appliquer les correctifs de version Capacitor core, CLI, plugin et projet natif lors de la synchronisation et de la mise à jour de Cap

Guide

Tutoriel sur Capacitor Patch

Utiliser @capgo/capacitor-patch

Appliquer les corrections sélectionnées de Capacitor à partir d'un catalogue de correctifs géré par version pendant cap sync et cap update.

Installer

npm install @capgo/capacitor-patch
npx cap sync

Lister les correctifs disponibles

npx capgo-capacitor-patch list --all

Le catalogue comprend les identifiants de correctifs, les packages cibles, les versions de Capacitor prises en charge et les liens vers les PRs upstream de Capacitor.

Sélectionner les correctifs dans la configuration de Capacitor

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;

Étude de scénario et synchronisation

npx capgo-capacitor-patch doctor --phase package --strict
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.

Configuration

  • patches - des ID de correctifs explicites à appliquer.
  • recommended - appliquer les correctifs Capgo marqués comme recommandés.
  • disabled - ignorer un ID de correctif sélectionné.
  • strict - échouer lorsque le correctif sélectionné est incompatible ou ne peut pas s'appliquer.

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-patch

Si vous utilisez En utilisant @capgo/capacitor-patch pour planifier le travail de plugin natif, connectez-le avec @capgo/capacitor-patch pour les détails d'implémentation dans @capgo/capacitor-patch, Répertoire de plugins Capgo pour le flux de travail du produit dans Répertoire de plugins Capgo Plugins Capacitor par Capgo pour les détails 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 de Plugins Entreprise Ionic pour le flux de travail du produit dans Alternatives de Plugins Entreprise Ionic.