Dal V2 al V3

Questa documentazione spiegherà come procedere all'aggiornamento alla versione 3 dell'auto-aggiornamento.

Prima migrare al tooling più recente:

npm remove -g capgo
npm remove capacitor-updater

npm i @capgo/cli
npm i @capgo/capacitor-updater@3
npx cap sync

Eliminare tutte le configurazioni precedenti:

{
  CapacitorUpdater: {
      autoUpdateURL: "https...",
      ...
  },
}

Per lasciare solo questo:

{
  "CapacitorUpdater": {
    "autoUpdate": true
  }
}

⚠️ Se stavi utilizzando il tuo server, con autoUpdateURL, tiaggerò presto una guida aggiornata. Nel frattempo, prenditi un attimo per esplorare la nuova opzione di caricamento external che consente di inviare solo il link del vostro zip, non il code in Capgo cloud. Questo è stato fatto per le aziende con politiche di privacy rigorose. In modalità esterna, il code non atterrerà mai sul Capgo server, li archiviamo solo la URL e la inviamo al dispositivo, che la scaricherà direttamente. In modo standard, il code viene compresso e archiviato sul nostro server, ma non lo apriremo mai o lo utilizzeremo.

Cosa è cambiato

Tutte le configurazioni diventano server-side per l'aggiornamento automatico, per darvi più controllo su come inviare un aggiornamento agli utenti.

Questo ci consente di ripristinare, anche di distribuire solo a un utente con i canali! Questi impostazioni vengono riaggiunte nella interfaccia web:

• disabilita il ripristino sotto nativo
• disabilita l'aggiornamento sopra maggiore

⚠️ Saranno veri di default per tutti i canali

Questo eliminerà anche la necessità di aggiornare spesso il plugin, la maggior parte degli aggiornamenti saranno fatti server-side, e li riceverete senza alcuna modifica sul vostro lato.

⚠️ Ripristina quando un aggiornamento diventa il default, se preferite non eliminare tutte le versioni di download quando si aggiorna dal negozio, fate questo:

{
  "CapacitorUpdater": {
    "autoUpdate": true,
    "resetWhenUpdate": false
  }
}

Aggiorna il tuo code

Infine, aggiorna tutte le tue importazioni in JS da:

import { CapacitorUpdater } from 'capacitor-updater'

to

import { CapacitorUpdater } from '@capgo/capacitor-updater'

Poi costruisci nuovamente il tuo code npm run build e copia nuovamente gli asset npx cap copy.

Ora dovresti essere in grado di testare il sistema di aggiornamento automatico

Inviare la tua versione con:

npx @capgo/cli@latest bundle upload

al posto di

npx capgo upload

Evoluzione futura

Per ora solo il primo canale pubblico è in uso, in futuro, il pubblico cambierà per i canali pubblici multipli, se ne sono impostati più di uno.

Problemi comuni:

• Il problema di costruzione dopo l'aggiornamento: se hai già aperto il codice sorgente code del plugin in Android Studio o Xcode, a volte il sincronizzazione non li elimina, e questo è la causa del problema. Apri l'IDE nativo e elimina capacitor-updater manualmente e npx cap sync questo dovrebbe risolvere.

Continua da qui: da V2 a V3

Se stai utilizzando Da V2 a V3 per pianificare la consegna di aggiornamenti in tempo reale, connettilo con Capgo Live Updates for the product workflow in Capgo Live Updates, Panoramica per i dettagli di implementazione in 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.