Da V2 a V3

Questa documentazione spiega come aggiornare alla versione 3 di auto-update.

Per prima cosa migra 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

Rimuovi tutta la tua configurazione precedente:

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

per lasciare solo questo:

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

⚠️ Se stavi usando il tuo server, con autoUpdateURL, aggiornerò presto questa guida per te. Nel frattempo, dai un'occhiata alla nuova opzione di upload external che ti permette di inviare solo il link del tuo zip, senza il code nel cloud Capgo. È stata pensata per le aziende con policy di privacy rigorose. In modalità esterna, il code non arriverà mai sul server Capgo, noi memorizziamo solo l'URL e lo inviamo al dispositivo, che lo scaricherà direttamente. In modalità standard, il code viene zippato e salvato sul nostro server, ma non lo apriremo né lo useremo mai.

Cosa cambia

Tutte le configurazioni per l'auto-update diventano server-side, per darti più controllo su come invii un update agli utenti.

Questo ci permette di fare il rollback, o persino deployare su un singolo utente tramite i channel! Queste impostazioni sono state riaggiunte all'interfaccia web:

• disabilita revert sotto native
• disabilita update sopra major

⚠️ Diventeranno true di default per tutti i canali

Questo eliminerà anche la necessità di aggiornare spesso il plugin: la maggior parte degli update avverrà lato server e li riceverai senza dover modificare nulla lato tuo.

⚠️ Si resetta quando un update diventa il default; se preferisci non rimuovere tutte le versioni scaricate quando aggiorni dallo store, fai così:

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

Aggiorna il tuo code

Infine, aggiorna tutti i tuoi import JS da:

import { CapacitorUpdater } from 'capacitor-updater'

a

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

Poi builda di nuovo il tuo code npm run build e copia di nuovo gli asset npx cap copy.

Ora dovresti poter testare l'ultimo sistema di auto-update

Invia la tua versione con:

npx @capgo/cli@latest bundle upload

invece di

npx capgo upload

Evoluzione futura

Per ora viene utilizzato solo il primo canale pubblico; in futuro, "public" passerà a gestire più canali pubblici, se ne viene impostato più di uno.

Problemi comuni:

• Problema di build dopo l'upgrade: se hai già aperto in Android Studio o Xcode il code sorgente del plugin, a volte la sincronizzazione non lo rimuove ed è questa la causa del problema. Apri l'IDE nativo e rimuovilo capacitor-updater a mano e poi npx cap sync questo dovrebbe risolvere.

Keep going from From V2 to V3

Se stai usando Da V2 a V3 per pianificare la distribuzione di live update, collegalo a Live Updates di Capgo per il workflow del prodotto in Capgo Live Updates, Panoramica per i dettagli di implementazione nell'Overview, Funzionalità per i dettagli implementativi in Features, Comportamento degli aggiornamenti per i dettagli implementativi in Update Behavior, e Tipi di aggiornamento per i dettagli di implementazione in Tipi di aggiornamento.