Da V2 a V3

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

Prima migrare all'ultima tooling:

npm remove -g capgo
npm remove capacitor-updater

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

Elimina tutte le tue 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 un'occhiata all'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.

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 canali! Queste impostazioni vengono aggiunte nuovamente all'interfaccia web:

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

⚠️ Saranno veri di default per tutti i canali

Ciò eliminerà anche la necessità di aggiornare spesso il plugin, la maggior parte degli aggiornamenti verrà fatta server-side, e riceverete senza alcuna modifica sul vostro lato.

⚠️ Riavvia quando un aggiornamento diventa il default, quindi 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, aggiornate tutte le vostre importazioni in JS da:

import { CapacitorUpdater } from 'capacitor-updater'

a

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

Ri-costruisci poi 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

al posto di

npx capgo upload

Evoluzione futura

For 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:

• Il problema di costruzione dopo l'aggiornamento: se hai già aperto la fonte 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 elimina 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 Aggiornamenti in Tempo Reale per il flusso di lavoro del prodotto in Capgo Aggiornamenti in tempo reale, Panoramica per la dettagliata implementazione in Panoramica, Caratteristiche per la dettagliata implementazione in Caratteristiche, Comportamento dell'aggiornamento per la dettagliata implementazione in Comportamento dell'aggiornamento, e Tipi di aggiornamento per la dettagliata implementazione in Tipi di aggiornamento.