Saltare alla navigazione

@capgo/capacitor-patch

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

@capgo/capacitor-patch è un pacchetto Capacitor che si limita alle funzioni di hook e applica i file di patch selezionati ogni volta che Capacitor viene eseguito sync o update.

È progettato per le correzioni utili prima che siano disponibili in una versione ufficiale di Capacitor. Il catalogo integrato traccia i PR esterni di Capacitor riflessi da Capacitor+ sync/upstream-pr-* rami.

Capacitor pacchetti

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

Capacitor CLI

Il pacchetto Patch ha inviato CLI file JavaScript. Quando viene applicato un pacchetto di patch CLI, il comando successivo utilizza il CLI patchato. cap command uses the patched code.

Applica patch dei progetti Android o iOS generati dopo

o cap sync La selezione sicura cap update.

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

Catalogo dei patch

Le patch sono di default opzionali. 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
  • intervallo di versione supportato
  • il PR upstream Capacitor
  • la branca di sincronizzazione Capacitor+ corrispondente
  • il file della patch consegnato con il pacchetto

Usare @capgo/capacitor-patch quando:

  • esiste un fix Capacitor upstream ma non è stato ancora rilasciato
  • il tuo app ha bisogno del fix senza mantenere script di patch locali
  • desideri che i patch si riapplichino dopo ogni sincronizzazione/aggiornamento Capacitor
  • hai bisogno di un catalogo leggibile da team dei fix su cui il tuo app dipende

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