Passer au contenu

@capgo/capacitor-patch

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

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

Il est conçu pour les correctifs utiles avant qu'ils ne soient intégrés dans une version officielle Capacitor. Le catalogue intégré suit les PRs externes upstream 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 expédié les fichiers JavaScript CLI. Lorsqu'un patch CLI est appliqué, le prochain cap command utilise le patch code.

Projets natifs

Appliquer les correctifs générés pour les projets Android ou iOS après cap sync ou cap update.

ou choisir

Une sélection sûre

Les plages de version, les vérifications d'indépendance et le mode strict aident à empêcher les correctifs obsolètes d'être appliqués silencieusement.

Catalogue de correctifs

Catalogue de correctifs plugins.CapacitorPatch.patches.

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

  • Chaque entrée du catalogue comprend :
  • un identifiant de correctif stable : 
  • plage de versions supportées
  • le tirage Capacitor upstream
  • le branchement synchronisé Capacitor+ correspondant
  • le fichier de correctif expédié avec le paquet

Utiliser @capgo/capacitor-patch lorsque :

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

Pour un catalogue complet et guide de contribution, consultez le capacitor-patch repository.

Si vous utilisez @capgo/capacitor-patch 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, Capgo Répertoire des plugins pour le flux de travail du produit dans Capgo Répertoire des plugins, Capacitor Plugins par Capgo pour les détails d'implémentation dans Capacitor Plugins 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.