@capgo/capacitor-patch

Appliquez des correctifs vérifiés aux packages de noyau Capacitor, aux CLI, aux plugins et aux projets natifs lors des appels de synchronisation et de mise à jour.

Démarrer GitHub

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

C'est conçu pour des 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.

Ce qu'il répare

Packages Capacitor

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

Capacitor CLI

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

Native 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.

Catalogue de correctifs

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 natif cible
la plage de version prise en charge
le Capacitor PR upstream
la branch synchronisante correspondante Capacitor+
le fichier de patch fourni avec le package

Pourquoi l'utiliser

Utilisation @capgo/capacitor-patch lorsque :

un correctif Capacitor existe en amont mais n'a pas encore été expédié
votre application a besoin du correctif sans maintenir des scripts de patch locaux
vous voulez que les patches se réappliquent après chaque synchronisation/mise à jour Capacitor
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, voir le capacitor-patch repository.

Continuez à partir de @capgo/capacitor-patch

Si vous utilisez @capgo/capacitor-patch pour planifier le travail de plugin natif, connectez-le avec 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.