Aller au contenu principal
@capgo/capacitor-patch Mises à jour Open source

Patch Capacitor Plugin Capacitor

Applique des patchs core Capacitor, CLI, plugins et projet natif selon la version, pendant cap sync et update

Installer

bun add @capgo/capacitor-patch bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-patch
  • pnpm add @capgo/capacitor-patch
  • yarn add @capgo/capacitor-patch

Guide

Comment utiliser Capacitor Patch dans Capacitor

Utiliser @capgo/capacitor-patch

Appliquez les correctifs Capacitor sélectionnés depuis un catalogue de patchs par version lors de cap sync et cap update.

Installer

npm install @capgo/capacitor-patch
npx cap sync

Lister les patches disponibles

npx capgo-capacitor-patch list --all

Le catalogue inclut les IDs de patch, les packages cibles, les versions Capacitor supportées et les liens vers les PR Capacitor d'origine.

Sélectionnez les patches dans la config 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;

Dry-run et sync

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

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

Configuration

  • patches - IDs de patch explicites à appliquer.
  • recommended - appliquer les patches que Capgo marque comme recommandés.
  • disabled - ignorer un ID de patch sélectionné.
  • strict - échoue si un patch sélectionné est incompatible ou ne peut pas être appliqué.

Référence complète

Continuer depuis la page Utiliser @capgo/capacitor-patch

Si vous utilisez Utiliser @capgo/capacitor-patch pour planifier le travail sur les plugins natifs, connectez-l’à @capgo/capacitor-patch pour les détails d'implémentation dans @capgo/capacitor-patch, Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Ajout ou mise à jour de plugins, et Alternatives aux plugins Ionic Enterprise pour le workflow produit dans Alternatives aux plugins Ionic Enterprise.

FAQ

FAQ sur le plugin Capacitor Patch

Comment installer le plugin Capacitor Patch dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-patch" (ou "npm install @capgo/capacitor-patch"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-patch" dans votre code.

@capgo/capacitor-patch fonctionne-t-il avec React, Vue et Angular ?

Oui. Capacitor Patch est un package Capacitor, il fonctionne donc avec n'importe quel framework web tournant dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-patch ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-patch est gratuit et open source ?

Oui. Le code source de code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-patch/ et le package est gratuit à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Capacitor Patch sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements de Capacitor Patch sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo