Aller au contenu

@capgo/capacitor-patch

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

@capgo/capacitor-patch est un package Capacitor composé uniquement de hooks qui applique les fichiers de patch sélectionnés à chaque exécution de Capacitor sync ou update.

Il est conçu pour les correctifs utiles avant leur intégration dans une release Capacitor officielle. Le catalogue embarqué suit les PR externes en amont de Capacitor répliquées par Capacitor+ sync/upstream-pr-* branches.

PlateformeSupportNotes
iOSHookcap sync patches
AndroidHookcap sync patches
Le WebN/ACLI uniquement

packages Capacitor

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

Capacitor CLI

Patcher les fichiers JavaScript CLI livrés. Lorsqu'un patch CLI est appliqué, la prochaine cap commande utilise le code patché.

Projets natifs

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

Sélection sécurisée

Les plages de versions, les vérifications d’idempotence et le mode strict empêchent l’application silencieuse de patches obsolètes.

Les patches sont désactivés par défaut. Consultez le catalogue livré, sélectionnez les identifiants de patch dont votre application a besoin et ajoutez-les à plugins.CapacitorPatch.patches.

Chaque entrée du catalogue comprend :

  • un identifiant de patch stable
  • le package cible ou la phase du projet natif
  • plage de versions prises en charge
  • la PR Capacitor en amont
  • the matching Capacitor+ sync branch
  • le fichier de patch livré avec le package

Utiliser @capgo/capacitor-patch quand :

  • un correctif Capacitor existe en amont mais n’a pas encore été publié
  • votre application a besoin du correctif sans avoir à maintenir des scripts de patch locaux
  • vous voulez que les patches soient réappliqués après chaque synchro/mise à jour Capacitor
  • vous avez besoin d’un catalogue lisible par l’équipe des correctifs dont votre application dépend

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

Si vous utilisez @capgo/capacitor-patch pour planifier le travail sur les plugins natifs, connectez-l’à Utiliser @capgo/capacitor-patch pour la fonctionnalité native de la page Utiliser @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.