Saltare al contenuto

@capgo/capacitor-patch

Applica correzioni approvate ai pacchetti core di Capacitor, ai CLI, ai plugin e ai progetti nativi durante gli hook di sincronizzazione e aggiornamento.

@capgo/capacitor-patch è un pacchetto Capacitor a hook solo che applica file di patch selezionati ogni volta che Capacitor esegue sync o update.

È costruito per le correzioni utili prima che siano presenti in una versione ufficiale di Capacitor. Il catalogo integrato traccia PRs upstream esterni di Capacitor riflessi su Capacitor+ sync/upstream-pr-* rami.

Pacchetti Capacitor

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

Capacitor CLI

Il patch di CLI file JavaScript è stato spedito. Quando viene applicato un patch CLI, il prossimo cap comando utilizza il code patch.

Progetti nativi

Applica le patch dei progetti Android o iOS generati dopo cap sync o cap update.

Scegliere in modo sicuro

Le finestre di versione, i controlli di idempotenza e il modo stringente aiutano a prevenire che le patch obsolete si applichino in modo silenzioso.

Il catalogo delle patch è di default opzionale. Elencare il catalogo consegnato, scegliere gli ID delle patch che il tuo app ha bisogno, e aggiungerle a plugins.CapacitorPatch.patches.

Ogni voce del catalogo include:

  • un ID stabile della patch
  • il pacchetto o la fase del progetto nativo di destinazione
  • la finestra di versione supportata
  • il Capacitor PR upstream
  • il ramo sincrono di corrispondenza Capacitor+
  • il file di patch spedito con il pacchetto

Usa @capgo/capacitor-patch quando:

  • esiste un Capacitor correttivo upstream ma non è stato ancora spedito
  • il tuo app ha bisogno del correttivo senza mantenere script di patch locali
  • vuoi che le patch si riapplichino dopo ogni Capacitor sincronizzazione/aggiornamento
  • hai bisogno di un catalogo leggibile da team delle correzioni che la tua app dipende

Per un catalogo completo e guida alla contribuzione, vedi il capacitor-patch repository.

Se stai utilizzando @capgo/capacitor-patch per pianificare il lavoro di plugin nativo, connettilo con Utilizzando @capgo/capacitor-patch per la capacità nativa in Utilizzando @capgo/capacitor-patch, Directory dei plugin Capgo per il flusso di lavoro del prodotto in Directory dei plugin Capgo, Plugin Capacitor sviluppati da Capgo per la dettaglio di implementazione in Plugin Capacitor sviluppati da Capgo, Aggiungere o aggiornare i plugin per i dettagli di implementazione in Aggiungere o Aggiornare Plugin, e Alternative per Plugin Enterprise Ionic per il workflow del prodotto in Alternative Plugin Enterprise Ionic.