Auto Update

Questa documentazione spiegherà come eseguire il proprio server di aggiornamento automatico.

Servi il tuo pacchetto

Assicurati che il tuo pacchetto sia servito su HTTPS e che il server abbia i giusti header CORS per consentire all'app di scaricare l'aggiornamento. e.g. https://myserver.com/app/updates/updates.json

Se sei sconosciuto con il servizio di un pacchetto, ti consigliamo di provare Capgo Cloud o di vedere un esempio qui:

Servire un Pacchetto

Configurazione

Aggiungi un updateUrl al tuo capacitor.config.json.

{
  "plugins": {
    "CapacitorUpdater": {
      "updateUrl": "https://myserver.com/app/updates/updates.json",
    }
  }
}

Attenzione

Quando stai eseguendo un aggiornamento self-hosted, assicurati di non utilizzare l'endpoint “HTTP” poiché è contro le politiche di sicurezza degli app Android, per scopi di testing puoi permeterlo.

Aggiorna API

Il plugin eseguirà una chiamata POST al tuo API ogni volta che l'app è aperta, con il seguente corpo:

interface AppInfos {
    "platform": "ios" | "android" | "electron",
    "device_id": "UUID_of_device_unique_by_install",
    "app_id": "APPID_FROM_CAPACITOR_CONFIG",
    "custom_id": "your_custom_id_set_on_runtime",
    "plugin_version": "PLUGIN_VERSION",
    "version_build": "VERSION_NUMBER_FROM_NATIVE_CODE",
    "version_code": "VERSION_CODE_FROM_NATIVE_CODE",
    "version_name": "LAST_DOWNLOADER_VERSION" | "builtin"
    "version_os": "VERSION_OF_SYSTEM_OS",
    "is_emulator": boolean,
    "is_prod": boolean,
}

Il server API dovrebbe rispondere, in formato JSON, al plugin capacitor-aggiornatore. Con i dati di risposta se è necessario un aggiornamento:

{
"version": "1.2.3",
"url": "https://myserver.com/app/updates/my-new-app-2.0.0.zip",
"checksum": "sha256_checksum_of_bundle"
}

In modalità di aggiornamento automatico il server dovrebbe confrontare le versioni e restituire quella corretta, se presente la chiave URL, il plugin avvia il processo di download.

Se aggiungi le chiavi “message” e “error”, la versione non verrà impostata e il messaggio verrà visualizzato nei log al suo posto.

version La chiave dovrebbe essere in semver format.

Il file zip dovrebbe avere index.html come un file nella radice, o solo una cartella nella radice con index.html all'interno.

Puoi utilizzare il comando di CLI per creare un file zip del tuo bundle:

Crea un bundle con i tuoi file da servire dal tuo server

npx @capgo/cli bundle zip --path [/path/to/my/bundle]

Genera checksum del bundle

Importante: Devi utilizzare il Capgo CLI per creare il file zip del tuo bundle. Il plugin Capgo richiede un formato e una struttura zip specifici che sono garantiti solo quando si utilizza lo strumento ufficiale CLI. Le utility zip standard possono creare archivi incompatibili.

Per generare il checksum del tuo bundle, utilizza il comando Capgo CLI zip con --json flag:

Crea un bundle con informazioni sul checksum

npx @capgo/cli bundle zip [appId] --json

Questa riga di comando farà:

• Crea un file zip formato correttamente compatibile con il plugin Capgo
• Genera il checksum SHA256 per la verifica dell'integrità
• Stampa le informazioni del bundle in formato JSON

Esempio di output:

{
  "version": "1.2.3",
  "checksum": "a1b2c3d4e5f6789...",
  "size": 1234567
}

Utilizza il checksum valore di questo output nella tua risposta API per assicurarti che il plugin possa verificare l'integrità del bundle prima dell'installazione.

Continua da Auto Update

Se stai utilizzando Auto Update per pianificare la migrazione e le operazioni aziendali, connettilo con Utilizzando @capgo/capacitor-aggiornatore per la capacità nativa in Utilizzando @capgo/capacitor-aggiornatore Capgo per l'azienda per il workflow del prodotto in Capgo Enterprise, Alternativi per il Plugin Enterprise Ionic Per il workflow del prodotto nelle alternative del plugin Enterprise di Ionic. Capgo Alternative soluzioni per il workflow del prodotto in Capgo Alternative e Capgo consulenza esterna per il flusso di lavoro del prodotto in Capgo Consulting.