Da V2 a V3

Questa documentazione spiegherà come aggiornare 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, Aggiornerò presto questa guida per te. Nel frattempo, prendi in considerazione l'opzione di caricamento nuova external che ti consente di inviare solo il link del tuo 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, conserviamo solo l'URL e lo inviamo al dispositivo, che lo scaricherà direttamente. In modo standard, il code viene zippato e conservato sul nostro server, ma non lo apriremo mai o lo utilizzeremo.

What change

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

Questo ci consente di ripristinare, anche di distribuire solo a un utente con canali! Queste impostazioni vengono aggiunte nuovamente all'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 riceverai senza alcuna modifica sul tuo lato.

⚠️ Riavvia quando un aggiornamento diventa il default, quindi se preferisci non eliminare tutte le versioni di download quando si aggiorna dal negozio, fai questo:

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

Aggiorna il tuo code

Infine, aggiorna tutti gli import in JS da:

import { CapacitorUpdater } from 'capacitor-updater'

a

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

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

Dovresti essere ora in grado di testare l'ultimo sistema di aggiornamento automatico

Invia la tua versione con:

npx @capgo/cli@latest bundle upload

invece di

npx capgo upload

Evoluzione futura

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

Problemi comuni:

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

Continua da V2 a V3

Se stai utilizzando Da V2 a V3 per pianificare la consegna di aggiornamenti live, connettilo con Capgo Live Updates for the product workflow in Capgo Live Updates, Panoramica per il dettaglio di implementazione in Panoramica, Caratteristiche per il dettaglio di implementazione in Caratteristiche, Comportamento dell'aggiornamento per il dettaglio di implementazione in Comportamento dell'aggiornamento, e Tipi di aggiornamento per il dettaglio di implementazione in Tipi di aggiornamento.