Vai al contenuto
Capgo

Aggiornamento automatico

Questa modalità consente agli sviluppatori di utilizzare capacitor-updater in modalità di aggiornamento automatico e inviare aggiornamenti tramite i canali Capgo o equivalenti

Prerequisiti

Assicurati che la versione della tua app utilizzi https://semverorg/ prima di utilizzare l’aggiornamento automatico Capgo

Questa è la convenzione che utilizza per gestire le versioni in Capgo

Ci sono due modi per impostare la versione nella tua app:

Nuovo modo: Usa il campo version nel tuo file capacitorconfigjson

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true, // Abilita l'aggiornamento automatico, true per default
      "appId": "comexampleapp", // Usato per identificare l'app nel server
      "version": "100" // Usato per controllare gli aggiornamenti
    }
  }
}

Queste opzioni verranno utilizzate dal plugin per controllare gli aggiornamenti e dalla CLI per caricare la versione

Vecchio modo: In 3 file nel tuo progetto:

  • packagejson in version
  • android/app/buildgradle in versionName
  • ios/App/Appxcodeproj/projectpbxproj in CURRENT_PROJECT_VERSION

Tutorial

Configura la tua app in 5 minuti

Aggiorna le tue app Capacitor senza problemi usando capacitor updater

Configura il tuo CI in 5 minuti

Build e rilascio automatico con GitHub actions

Installazione

Terminal window
npm install @capgo/capacitor-updater
npx cap sync

Introduzione

Clicca su registrati per creare il tuo account

Il server ti permette di gestire canali, versioni e molto altro

autoUpdate utilizzerà i dati da capacitorconfig per identificare il server Capgo

Validare la versione

Quando l’aggiornamento automatico è configurato, devi notificare da JS che la tua app è attiva e pronta

Questo può essere fatto chiamando all’interno della tua app notifyAppReady

Fallo il prima possibile

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


CapacitorUpdaternotifyAppReady()

Flusso utente

  • L’utente apre l’app, l’app chiama il server per controllare gli aggiornamenti, se ne vengono trovati verranno scaricati in background
  • L’utente chiude l’app, la nuova versione viene impostata come attiva
  • L’utente riapre l’app, carichiamo la nuova versione attiva e la impostiamo come predefinita
  • Se viene chiamato notifyAppReady(), quando l’utente chiude l’app, la versione precedente viene eliminata
  • L’utente continua il normale flusso dell’app fino al prossimo ciclo di aggiornamento

Flusso di sviluppo

Quando sviluppi nuove funzionalità, assicurati di bloccare autoUpdate, poiché capgo sovrascriverà costantemente il tuo lavoro con l’ultimo bundle di aggiornamento Imposta autoUpdate su false nella tua configurazione Se per qualche motivo sei bloccato su un aggiornamento, puoi eliminare l’app e reinstallarla Assicurati di impostare autoUpdate su false nella tua configurazione prima di farlo E poi ricompilala di nuovo con Xcode o Android studio

Per caricare la versione ad ogni commit configura CI/CD con questa guida

Build e rilascio automatico con GitHub actions

Evento Major Available

Quando disableAutoUpdateBreaking è impostato su true, puoi ascoltare l’evento per sapere quando l’app rifiuta di fare un aggiornamento major breaking

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


CapacitorUpdateraddListener('majorAvailable', (info: any) => {
  consolelog('majorAvailable è stato attivato', infoversion)
})