Passer à la navigation

@capgo/capacitor-patch

Appliquer 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 uniquement basé sur des appels qui applique des fichiers de correctifs 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 PR externes de Capacitor répliqués par Capacitor+ sync/upstream-pr-* branches

Packages Capacitor

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

Capacitor CLI

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

Projects

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

Sélection de sécurité

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

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 à plugins.CapacitorPatch.patches.

Chaque entrée du catalogue comprend :

  • un identifiant de correctif stable
  • le paquetage ou la phase de projet native cible
  • la plage de version prise en charge
  • le Capacitor PR upstream
  • la branch synchronisée correspondante Capacitor
  • le fichier de patch fourni avec le package

Utilisation @capgo/capacitor-patch lorsque

  • un Capacitor correctif existe en amont mais n'a pas encore été déployé
  • votre application a besoin du correctif sans maintenir des scripts de patch locaux
  • vous souhaitez que les patches 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 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 à Utilisation de @capgo/capacitor-patch pour la capacité native dans Utilisation de @capgo/capacitor-patch, Répertoire de plugin Capgo pour le flux de travail du produit dans Répertoire de plugin Capgo, Plugins Capacitor par Capgo pour le détail d'implémentation dans Plugins Capacitor par Capgo, Ajout ou mise à jour de plugins pour les détails d'implémentation dans l'ajout ou la mise à jour de plugins, et Alternatives de plugins d'entreprise Ionic pour le flux de travail du produit dans les alternatives de plugins d'entreprise Ionic.