Dal V2 al V3

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

Prima migrare all'ultima strumentazione:

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, tiaggerò presto una nuova guida per te. Nel frattempo, prenditi 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 modalità 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 darti più controllo su come inviare un aggiornamento agli utenti.

Questo ci consente di ripristinare, anche di distribuire solo a un utente con canali! Questi impostazioni vengono aggiunte nuovamente all'interfaccia web:

• disabilitare il ripristino nativo
• disabilitare l'aggiornamento sopra la versione maggiore

⚠️ Saranno veri di default per tutti i canali

Questo eliminerà anche la necessità di aggiornare spesso il plugin, la maggior parte degli aggiornamenti verranno fatti in modalità server-side, e li riceverai senza alcuna modifica sul tuo lato.

⚠️ Ripristina 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 tutte le tue importazioni in JS da:

import { CapacitorUpdater } from 'capacitor-updater'

a

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

Costruisci quindi il tuo code nuovamente 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

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

Problemi comuni:

• Costruzione del problema 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 elimina capacitor-updater rimuovi a mano npx cap sync questo dovrebbe risolvere.

Prosegui da V2 a V3

Se stai utilizzando Da V2 a V3 per pianificare la consegna di aggiornamenti in tempo reale, connettilo con Capgo Aggiornamenti in Tempo Reale per il flusso di lavoro del prodotto in Capgo Aggiornamenti in Tempo Reale, Panoramica per i dettagli di implementazione in Panoramica, Caratteristiche per i dettagli di implementazione in Caratteristiche, Comportamento di Aggiornamento per i dettagli di implementazione in Comportamento di Aggiornamento, e Tipi di Aggiornamento per i dettagli di implementazione in Tipi di Aggiornamento.