Passer à la navigation

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

Apply vetted fixes to Capacitor core packages, the CLI, plugins, and native projects during sync and update hooks.

@capgo/capacitor-patch is a hook-only Capacitor package that applies selected patch files whenever Capacitor runs sync ou update.

It is built for fixes that are useful before they land in an official Capacitor release. The bundled catalog tracks external upstream Capacitor PRs mirrored by Capacitor+ sync/upstream-pr-* La bibliothèque de catalogues embarqués suit les PRs externes upstream __CAPGO_KEEP_1__ reflétés par __CAPGO_KEEP_2__+

Cette package n'a pas de runtime natif __CAPGO_KEEP_0__. Il fonctionne à travers les appels de hooks __CAPGO_KEEP_1__, les fichiers de package __CAPGO_KEEP_2__ et les fichiers de projet natif générés.

Ce qu'il corrige

Capacitor packages

Les packages __CAPGO_KEEP_0__ @capacitor/core, @capacitor/android, @capacitor/ios, and third-party Capacitor plugins under node_modules.

Capacitor CLI

CLI CLI Patch envoyé des fichiers JavaScript CLI. Lorsqu'un CLI patch 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

Patchs sécurisés

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

Catalogue de correctifs

Sous-titre de la section intitulée « Catalogue de correctifs » plugins.CapacitorPatch.patches.

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

  • Chaque entrée du catalogue comprend :
  • un identifiant de patch stable : 
  • plage de versions prises en charge
  • le tirage Capacitor PR
  • le branchement Capacitor+ synchronisé
  • le fichier de correctif expédié avec le paquet

Utiliser @capgo/capacitor-patch lorsque :

  • une correction Capacitor existe en amont mais n'a pas encore été expédiée
  • Votre application a besoin de la correction sans maintenir des scripts de correctifs locaux
  • Vous souhaitez que les correctifs 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 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 aux Plugins d'Entreprise Ionic pour le flux de travail du produit dans Alternatives aux Plugins d'Entreprise Ionic.