Aller directement au contenu

@capgo/capacitor-patch

Appliquer des correctifs validés aux packages de noyau Capacitor, aux CLI, aux plugins et aux projets natives lors des appels de synchronisation et de mise à jour.

@capgo/capacitor-patch est un package Capacitor uniquement basé sur des hooks qui applique des fichiers de correctifs sélectionnés chaque fois que Capacitor s'exécute sync ou update.

C'est conçu pour des correctifs utiles avant qu'ils ne soient intégrés dans une version officielle de Capacitor. Le catalogue intégré suit les PRs externes de Capacitor reflétés par Capacitor+ sync/upstream-pr-* branches.

Les packages Capacitor

Patch @capacitor/core, @capacitor/android, @capacitor/ios, et les plugins tiers Capacitor sous node_modules.

Capacitor CLI

Le patch CLI JavaScript a été expédié. Lorsqu'un patch CLI est appliqué, la commande suivante utilise le CLI patché. cap command uses the patched code.

Appliquer les patchs de projet Android ou iOS générés après

Apply generated Android or iOS project patches after cap sync ou cap update.

Sélection sécurisée

Les plages de version, les vérifications d'idempotence et le mode strict aident à empêcher les correctifs obsolètes d'appliquer silencieusement.

Les correctifs sont opt-in par défaut. Listez le catalogue expédié, choisissez les identifiants de correctif dont votre application a besoin, et ajoutez-les à plugins.CapacitorPatch.patches.

Chaque entrée du catalogue comprend :

  • un identifiant de correctif stable
  • le paquet cible ou la phase de projet natif
  • la plage de version prise en charge
  • le PR upstream Capacitor
  • la branche de synchronisation Capacitor+ correspondante
  • le fichier de patch expédié avec le package

Utilisation @capgo/capacitor-patch lorsque

  • un correctif Capacitor existe en amont mais n'a pas encore été expédié
  • votre application nécessite le correctif sans maintenir des scripts de patch locaux
  • vous souhaitez que les patches se réappliquent après chaque Capacitor synchronisation/mise à jour
  • vous avez besoin d'un catalogue lisible par l'équipe des correctifs dont votre application dépend

Pour un catalogue complet et guide de contribution, voir le capacitor-patch dépôt.

Si vous utilisez @capgo/capacitor-patch pour planifier le travail de plugin natif, connectez-le 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, Ajout ou Mise à jour de Plugins pour le détail d'implémentation dans Ajout ou Mise à jour de Plugins, et Alternatives de plugins d'entreprise Ionic pour le flux de travail du produit dans les alternatives de plugins d'entreprise Ionic.