Migrare da Capawesome Cloud a Capgo

Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.

⚡️ Capgo automatizza i canali, la pulizia dei pacchetti, i rollback, le analisi e CLI gli upload nativi. Utilizzare questa guida per eseguire i passaggi minimi richiesti per la migrazione e, facoltativamente, ricreare qualsiasi comportamento personalizzato che ancora serve.

Panoramica

Raccogliere la configurazione Cloud di Capawesome esistente (ID dell'applicazione, canali, chiavi di firma, CLI token) in modo da poterla archiviare o auditare in seguito.
Installare il plugin Capgo, rimuovere Capawesome SDK e chiamare CapacitorUpdater.notifyAppReady().
Configurare il comportamento facoltativo (download manuali, pinning dei pacchetti, ricarichi) se si dipende da quei flussi oggi.

Con Capgo è necessario installare solo il nostro plugin e chiamare CapacitorUpdater.notifyAppReady()Tutto il resto—canali, pulizia dei pacchetti, rollback, analisi e CLI automatizzazione—è gestito nativamente. Le sezioni che seguono guidano attraverso ogni compito direttamente.

Prima di iniziare

Assicurati che il tuo progetto stia già utilizzando Capacitor 5 o successivo.
Installa il Capgo CLI (npm install -g @capgo/cli) se hai l'intenzione di inviare pacchetti da CI/CD.

Passo 1 – Installa Capgo e rimuovi il plugin Capawesome SDK

npm uninstall @capawesome/capacitor-live-update
npm install @capgo/capacitor-updater
npx cap sync

That is the only mandatory swap. Capgo’s native code ships with the plugin; no extra JavaScript helpers are required.

Passo 2 – Configurazione minima

The previous setup richiedeva la mappatura di decine di opzioni in capacitor.config Capgo riconosce automaticamente il tuo progetto, quindi la configurazione minima assomiglia a questo:

import { CapacitorConfig } from '@capacitor/cli'

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      autoDeletePrevious: true,
      periodCheckDelay: 10 * 60 * 1000, // optional: check every 10 minutes
    },
  },
}

export default config

Tutto ciò che Capawesome elenca come flag manuali (defaultChannel, autoDeleteBundles, politiche di conservazione, ecc.) è gestito tramite il dashboard di Capgo o API. Hai bisogno di sovrascrivere solo queste chiavi se desideri un comportamento diverso dalle impostazioni predefinite di Capgo.

Riferimento rapido alla configurazione

Opzione di Capawesome	Capgo equivalente	Hai bisogno di impostarlo?
`appId`	Tratto dalla dashboard di Capgo non appena crei un progetto	Se usi più progetti in un unico binario
`defaultChannel`	Regole del canale gestite nel dashboard/API	Facoltativo; la maggior parte delle squadre lo configura in modo server-side
`autoDeleteBundles`	`autoDeletePrevious: true` (di default)	Già abilitato
`publicKey`	Gestito nel console Capgo	Sei se ruoti manualmente le chiavi
`maxVersions` / retention	Politica di conservazione del bundle	Configurato centralmente in Capgo (1 mese di default, 24 mesi di massimo)

Passo 3 – Chiamata `notifyAppReady()` (l'unico hook richiesto)

Il vecchio workflow introdusse ascoltatori personalizzati (checkForUpdates(), retryDownload(), nascondendo lo schermo di benvenuto, ecc.). Capgo esegue quei passaggi nativamente. L’unica API che devi chiamare è:

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

CapacitorUpdater.notifyAppReady()

Questa conferma l'app è avviata con successo. Se la conferma non arriva mai, Capgo effettua automaticamente il rollback del pacchetto—nessun JavaScript extra necessario.

È tutto—Capgo gestisce le verifiche in background, la visibilità dello schermo di benvenuto e i rollback nativamente.

Facoltativo: eseguire logica personalizzata prima che lo schermo di benvenuto si nasconda

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

CapacitorUpdater.addListener('appReady', () => {
  // Run diagnostics or logging if you need to
  SplashScreen.hide()
})

CapacitorUpdater.notifyAppReady()

Passo 4 – Mappa le chiamate di API (perlopiù facoltative)

In Capgo normalmente lasci che l'aggiornatore automatico si esegua; le API manuali rimangono disponibili se desideri avere il controllo completo.

Cloud di Capawesome	Capgo equivalente	Hai bisogno di questo?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	Solo quando implementi il tuo workflow di download personalizzato
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	Facoltativo: l'aggiornamento auto-nativo scarica già i bundle
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Facoltativo: il dashboard pina automaticamente i bundle
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Facoltativo; Capgo impone i bundle obbligatori dopo `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	Facoltativo: diagnostica

Se si stick con il comportamento di aggiornamento auto-nativo, puoi cancellare interamente il Capawesome JavaScript.

Esempi di controllo manuale

Scarica il bundle più recente

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

const downloadUpdate = async () => {
  const latest = await CapacitorUpdater.getLatest()
  if (latest?.url) {
    const bundle = await CapacitorUpdater.download({
      url: latest.url,
      version: latest.version,
    })
    console.log('Bundle downloaded', bundle?.id)
  }
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const downloadUpdate = async () => {
  const result = await LiveUpdate.fetchLatestBundle()
  if (result.downloadUrl) {
    await LiveUpdate.downloadBundle({
      bundleId: result.bundleId,
      url: result.downloadUrl,
    })
    console.log('Bundle downloaded')
  }
}

Imposta il prossimo bundle

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

const setNextBundle = async () => {
  await CapacitorUpdater.next({ id: 'bundle-id-123' })
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const setNextBundle = async () => {
  await LiveUpdate.setNextBundle({ bundleId: 'bundle-id-123' })
}

Applica il bundle scaricato immediatamente

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

const applyUpdate = async () => {
  await CapacitorUpdater.reload()
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const applyUpdate = async () => {
  await LiveUpdate.reload()
}

Passo 5 – Strategie di aggiornamento: come Capgo le gestisce

Capawesome documenta tre strategie. Ecco come si traducono:

Aggiornamenti in background

Flusso di lavoro precedente: configurare in code e pianificare i download manualmente.
Capgo: abilitato di default (autoUpdate: true). Nessun code aggiuntivo richiesto.

Sempre aggiornato al più recente

Flusso di lavoro precedente: aggiungi App.resume un ascoltatore, chiama download, quindi set.
Capgo: l'aggiornamento automatico in background esegue già il controllo dopo il ripristino. Hai bisogno di un ascoltatore manuale solo se desideri un intervallo personalizzato.

Facoltativo: controllo di ripristino manuale

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

App.addListener('resume', async () => {
  const latest = await CapacitorUpdater.getLatest()
  if (latest?.url) {
    const downloaded = await CapacitorUpdater.download({
      url: latest.url,
      version: latest.version,
    })
    if (downloaded) {
      await CapacitorUpdater.next({ id: downloaded.id })
    }
  }
})

Aggiorna forzatamente

Flusso di lavoro precedente: impostare la logica di avvio a filo e richiedere il reload.
Capgo) per richiedere agli utenti di aggiornare all'interno dell'applicazione. majorAvailable Step 6 – Distribuzione dei bundle notifyAppReady()Sottosezione intitolata “Step 6 – Distribuzione dei bundle”

Se in precedenza hai dipenduto da

Fermata di terminale capawesome live-update deploy, Capgo offers a similar CLI workflow, and you can also automate deployments entirely via API.

# Authenticate once (stores a token in your CI environment)
capgo login

# Upload a new bundle (auto-detects platform/version)
capgo bundle upload --path dist --channel production

Because Capgo tracks bundle health automatically, you also get:

Registri di audit a livello di dispositivo per ogni installazione.
Ritenzione automatica (un mese di default) con limiti configurabili fino a 24 mesi.
Metriche di latenza in tempo reale a status.capgo.app/history.

Scheda intitolata “Timeline di migrazione”

: 10 minuti (, rimuovi vecchio plugin).npm installConfigurazione & prontezza
: 5 minuti (Verifiche di sanitànotifyAppReady).
Verifiche di sanità: 15 minuti (test manuali facoltativi o ascoltatori).
Prima distribuzione: 10 minuti con Capgo CLI o integrazione CI.

In pratica, le squadre terminano in meno di un'ora. Se fornite i dettagli del progetto Capawesome, possiamo anche importare canali e liste dispositivi per voi.

Capgo supporto

Concierge di migrazione: prenotate una sessione a book.capgo.app/demo.
Comunità: unitevi alla Capgo Discord.
Il registro degli issue: github.com/Cap-go/capacitor-aggiornatore degli issue.

Capgo è progettato per una durata a lungo termine: aggiornamenti delta nativi, pacchetti crittografati, rollback automatici e analisi che non richiedono JavaScript personalizzato. Una volta migrato, puoi eliminare il glue pesante per la manutenzione e lasciare che la piattaforma esegua gli aggiornamenti automaticamente.

Continua da Migrate da Capawesome Cloud a Capgo

Se stai utilizzando Migrate da Capawesome Cloud a Capgo per pianificare l'automazione CI/CD, connettilo con Capgo CI/CD per il flusso di lavoro del prodotto in Capgo CI/CD, Capgo Costruzioni native per il flusso di lavoro del prodotto in Capgo Costruzioni native Integrazioni Capgo per il workflow del prodotto in Integrazioni Capgo Integrazione CI/CD per i dettagli di implementazione in Integrazione CI/CD, e Integrazione GitHub Actions per i dettagli di implementazione in Integrazione GitHub Actions.