Dal V3 al V4

Perché questo aggiornamento

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

Nel frattempo, ho visto in questo l'occasione di dare più libertà a te e di eliminare tutti i code che avevo fatto.

Installazione

npm i @capgo/capacitor-updater@4

Aggiornamento cloud automatico

Se utilizzi l'esempio base nella tua app, sei sicuro di poter migrare alla nuova versione, goditi!

Aggiornamento automatico auto-hosted

Per te, ancora semplice, le modifiche sono:

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

Utenti manuali

Per te, questa è la modifica più significativa, ma anche la migliore! Ti aspettano molte migliorie, Leggi attentamente.

Modifiche

• autoUpdateUrl diventa updateUrl ora può essere utilizzato anche in modalità manuale
• Cancellazione di cancelDelay e delayUpdate invece di setDelay
• Non più versionName in set
• Cambia version chiave, che è stato restituito in funzione di oggetto in molti casi BundleInfo

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

• Rinominato da nomi ingannevoli adesso (anche se non può essere chiaro all'uso, ma è facile da capire il nuovo):
  • quello che era chiamato un version ora si riferisce a un bundle
  • id si riferisca al vecchio version chi era una stringa casuale di 10 caratteri, questo id è l'unico modo affidabile e unico per accedere ai tuoi pacchetti, ad esempio 7Dfcd2RedN.
  • version si riferisce ora a versionName tu scegli per un pacchetto, ad esempio 1.0.0
• updateUrl passare da get a postpoiché i titoli personalizzati erano un problema per alcuni di voi e post è più logico, tutti i titoli precedenti vanno al corpo e il prefisso cap_ sparisce.
• versionName metodo è stato eliminato, in favore di getId
• la lista restituisce ora una lista di BundleInfo
• Rinomina getId in getDeviceId
• autoUpdate diventa vero per impostazione predefinita, se utilizzi il modo Manuale, impostalo su false.

Novità

• Metodo getLatestquesto metodo ti consente di ottenere dalla tua server impostato con updateUrl la versione disponibile più recente.
• Metodo setDelay chi prende {tipo: “background” | “kill” | “nativeVersion” | “data”, valore? : string} come argomento per impostare il ritardo in modi diversi.
• Metodo next, per impostare la versione nella prossima backgrounding, al contrario di set chi lo fa istantaneamente.
• 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 sec 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 dall'aggiornamento da V3 a V4

Se stai utilizzando Da V3 a V4 per pianificare live update consegne, connettilo con Capgo Aggiornamenti in Tempo Reale per il flusso di lavoro del prodotto nei Capgo Live Update. Overview per i dettagli di implementazione nella panoramica Caratteristiche per i dettagli di implementazione in Caratteristiche, Comportamento dell'aggiornamento per i dettagli di implementazione in Comportamento dell'aggiornamento, e Tipi di Aggiornamento per i dettagli di implementazione in Tipi di Aggiornamento.