Passer à la navigation

@capgo/capacitor-patch

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

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

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

Capacitor packages

Patch @capacitor/core, @capacitor/android, @capacitor/ioset des plugins tiers Capacitor node_modules.

Capacitor CLI

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

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

ou cap sync Sélection sécurisée cap update.

Les plages de versions, les vérifications d'idempotence et le mode strict aident à empêcher les patchs obsolètes d'être appliqués silencieusement.

Catalogue de patchs

Patches plugins.CapacitorPatch.patches.

Chaque entrée du catalogue comprend :

  • un ID de patch stable
  • la phase de projet natif ou le package cible
  • la plage de version prise en charge
  • le PR upstream Capacitor
  • le branchement de synchronisation Capacitor+ correspondant
  • le fichier de patch expédié avec le package

Utiliser @capgo/capacitor-patch lorsque :

  • un correctif Capacitor existe upstream mais n'a pas encore été expédié
  • Votre application nécessite la correction sans maintenir des scripts de mise à jour locales
  • you want patches to re-apply after every Capacitor sync/update
  • 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 repository.

Si vous utilisez @capgo/capacitor-patch pour planifier le travail de plugin natif, connectez-le avec Utilisation de @capgo/capacitor-patch pour la capacité native dans Utilisation de @capgo/capacitor-patch, Répertoire des plugins Capgo pour le flux de travail du produit dans le répertoire des plugins Capgo, Capacitor Plugins par Capgo pour le détail d'implémentation dans Capacitor Plugins par Capgo, Ajouter ou Mettre à Jour les Plugins pour le détail 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.