Aller directement au contenu

@capgo/capacitor-patch

Appliquez des correctifs validés aux Capacitor paquets de noyau, les CLI, les plugins et les projets natives lors des appels de fonctions de synchronisation et de mise à jour.

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

C'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 PR externes de Capacitor reflétés par Capacitor+ sync/upstream-pr-* branches.

Capacitor packages

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

Capacitor CLI

Patch shipped CLI JavaScript files. When a CLI patch is applied, the next 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ûre cap update.

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

Catalogue de patchs

Les correctifs sont activés par défaut. Liste du catalogue livré, sélectionnez 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 paquetage ou la phase de projet natif ciblée
  • la plage de versions supportées
  • le Capacitor PR upstream
  • le branchement de synchronisation Capacitor+ correspondant
  • le fichier de correctif livré avec le paquet

Pourquoi l'utiliser

Pourquoi l'utiliser

Utilisez-le @capgo/capacitor-patch lorsque :

  • une correction Capacitor existe en amont mais n'a pas encore été déployée
  • votre application a besoin de la correction sans maintenir des scripts de patch locaux
  • vous souhaitez que les patches se réappliquent après chaque synchronisation/mise à jour Capacitor
  • vous avez besoin d'un catalogue lisible par l'équipe des corrections dont votre application a besoin

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