Da V3 a V4

Perché questo aggiornamento

Dopo molti discorsi nella community di Discord con te. Ho scoperto che il modo manuale era troppo manuale e non sicuro da utilizzare, ad esempio, l'auto-revert non era possibile, quindi se hai fallito l'aggiornamento in modalità manuale l'utente deve rimuovere l'app e reinstallarla, cosa è un terribile UX.

Meanwhile, I took this as an opportunity to give more freedom to you, and remove all bad code I made.

Sezione intitolata “Installazione”

npm i @capgo/capacitor-updater@4

Sezione intitolata “Aggiornamento cloud automatico”

Aggiornamento self-hosted automatico

If you use the basic example in your app, you are safe to migrate to the new version, enjoy!

Per te, ancora semplice, le modifiche sono:

• Il nome della impostazione da autoUpdateUrl da updateUrl
• Il metodo Endpoint cambiato da GET a POST

Utenti manuali

Per te, questa è la modifica più significativa, ma per il meglio! Otterrai tonnellate di miglioramenti, Leggi attentamente.

Cambiamenti

• autoUpdateUrl diventa updateUrl da questo impostazione può essere utilizzato anche in modalità manuale adesso
• Cancellazione di cancelDelay e delayUpdate in favore di setDelay
• Non più versionName in impostazione
• Cambia version chiave, che era restituita in molte funzioni in oggetto BundleInfo

interface BundleInfo {
  id: string;
  version: string;
  downloaded: string;
  status: 'success' | 'error' | 'pending' | 'downloading'
}

• Rinominato di nomi ingannevoli adesso (anche se non può essere chiaro a spiegazione, ma all'uso è facile da capire il nuovo):
  • cosa era chiamato un version ora si riferisce a un bundle
  • id si riferisce all'antico version chi era una stringa casuale di 10 caratteri, questo id è l'unica via affidabile e univoca per accedere ai tuoi bundle, ad esempio 7Dfcd2RedN.
  • version si riferisce ora a versionName tu hai scelto per un bundle, ad esempio 1.0.0
• updateUrl spostati da get a post, poiché i header personalizzati erano un problema per alcuni di voi e post è più logico, tutti i precedenti header vanno al corpo e il prefisso cap_ disparire.
• versionName il metodo è stato cancellato, in favore di getId
• la lista restituisce ora una lista di BundleInfo
• Rinomina getId diventa vero di default, se utilizzi il modo Manuale, impostalo su false. getDeviceId
• autoUpdate Sezione intitolata “Notizie”

Metodo

• la versione più recente disponibile. getLatestMetodo updateUrl che prendono
• tipo setDelay “background” | “kill” | “nativeVersion” | “data”, valore? {: string: come argomento per impostare il ritardo in modi diversi.} News
• Metodo next, per impostare la versione nella prossima backgrounding, al contrario di set chi lo fa immediatamente.
• Metodo isAutoUpdateEnabled, per informarti se sei in contesto di aggiornamento automatico
• Evento downloadComplete quando il download raggiunge il 100%
• Aggiunto campo obbligatorio version nel metodo di download
• notifyAppReady diventa obbligatorio anche in modalità manuale, se non viene chiamato dopo 10 secondi l'app reversiona alla versione precedente.

Contributi

@lincolnthree Grazie mille per aver iniziato questo lavoro, era impossibile far funzionare questo aggiornamento senza di te.

Continua da V3 a V4

Se stai utilizzando Da V3 a V4 per pianificare la consegna di aggiornamenti in tempo reale, connettilo con Capgo Aggiornamenti in Tempo Reale per il flusso di lavoro del prodotto in Capgo Aggiornamenti in Tempo Reale, Panoramica per i dettagli di implementazione in Panoramica, Caratteristiche per i dettagli di implementazione in Features, Aggiorna il comportamento per i dettagli di implementazione in Aggiorna il comportamento, e Tipi di Aggiornamento per i dettagli di implementazione in Tipi di Aggiornamento.