@capgo/capacitor-patch

Applica fix verificati ai pacchetti core di Capacitor, CLI, plugin e progetti nativi durante gli hook di sync e update.

@capgo/capacitor-patch è un pacchetto Capacitor basato solo su hook che applica i file patch selezionati ogni volta che viene eseguito Capacitor sync oppure update.

È pensato per fix utili prima che arrivino in una release ufficiale di Capacitor. Il catalogo incluso traccia le PR upstream esterne di Capacitor mirrorate da Capacitor+ sync/upstream-pr-* rami.

Supporto piattaforme

Piattaforma	Supporto	Note
iOS	Hook	cap sync patches
Android	Hook	cap sync patches
Web	N/D	solo CLI

Cosa viene patchato

pacchetti Capacitor

Patch @capacitor/core, @capacitor/android, @capacitor/ios, e plugin Capacitor di terze parti sotto node_modules.

Capacitor CLI

Patch dei file JavaScript CLI distribuiti. Quando viene applicato un patch CLI, il successivo cap comando utilizza il code patchato.

Progetti nativi

Applica i patch generati per i progetti Android o iOS dopo cap sync oppure cap update.

Selezione sicura

Gli intervalli di versione, i controlli di idempotenza e la strict mode evitano che patch obsolete vengano applicate in silenzio.

Catalogo patch

Le patch sono opt-in di default. Elenca il catalogo spedito, seleziona gli ID delle patch necessari per la tua app e aggiungili a plugins.CapacitorPatch.patches.

Ogni voce del catalogo include:

un ID patch stabile
il pacchetto target o la fase del progetto nativo
intervallo di versioni supportate
la PR upstream di Capacitor
il ramo di sync Capacitor+ corrispondente
il file di patch incluso nel pacchetto

Perché usarlo

Usa @capgo/capacitor-patch quando:

esiste un fix Capacitor upstream ma non è ancora stato rilasciato
la tua app ha bisogno della patch senza dover gestire script locali
vuoi che le patch vengano riapplicate dopo ogni sync/update di Capacitor
ti serve un catalogo leggibile dal team dei fix da cui dipende la tua app

Per il catalogo completo e la guida per contribuire, consulta il repository capacitor-patch.

Continua da @capgo/capacitor-patch

Se stai usando @capgo/capacitor-patch per pianificare il lavoro sui plugin nativi, collegalo a Utilizzo di @capgo/capacitor-patch per la funzionalità nativa in Usare @capgo/capacitor-patch, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli su come aggiungere o aggiornare i plugin, e Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Alternative ai plugin Ionic Enterprise.