Migrare da Capawesome Cloud a Capgo

⚡️ Capgo automatizza i canali, la pulizia dei pacchetti, i rollback, le analisi e CLI le pubblicazioni native. Utilizza questa guida per eseguire i passaggi minimi richiesti per la migrazione e, facoltativamente, ricreare qualsiasi comportamento personalizzato di cui hai ancora bisogno.

Panoramica

1. Raccogli la tua configurazione Cloud Capawesome esistente (ID dell'applicazione, canali, chiavi di firma, CLI token) in modo da poterla archiviare o auditare in seguito.
2. Installa il plugin Capgo, elimina il Capawesome SDK, e chiama CapacitorUpdater.notifyAppReady().
3. Configura il comportamento facoltativo (download manuali, pinning dei pacchetti, ricarichi) se dipendi da quei flussi oggi.

Con Capgo hai bisogno solo di installare il nostro plugin e chiamare CapacitorUpdater.notifyAppReady()Tutto il resto—canali, pulizia dei pacchetti, rollback, analisi e CLI automatizzazione—viene 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 bundle da CI/CD.

Passo 1 – Installa Capgo e rimuovi il Capawesome SDK

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

Quella è l'unica sostituzione obbligatoria. Il Capgo nativo ha il suo code integrato; non sono richiesti aiuti JavaScript aggiuntivi.

Passo 2 – Configurazione minima

La configurazione precedente richiedeva la mappatura di decine di opzioni capacitor.config. Capgo riconosce automaticamente il tuo progetto, quindi la configurazione minima assomiglia a questo:

capacitor.config.ts

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 attraverso 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	Corrispettivo di Capgo	Hai bisogno di impostarlo?
appId	Prelevato dal dashboard di Capgo una volta creato il progetto	Solo se utilizzi più progetti in un unico binario
defaultChannel	Regole del canale gestite nel pannello di controllo/API	Facoltativo; la maggior parte delle squadre lo configura in modo server-side
autoDeleteBundles	autoDeletePrevious: true (impostazione predefinita)	Già abilitato
publicKey	Gestito nel console Capgo	Solo se si ruota manualmente le chiavi
maxVersions / conservazione	Politica di conservazione del bundle	Configurato centralmente in Capgo (1 mese predefinito, 24 mesi massimo)

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

The vecchio workflow introduceva gli ascoltatori personalizzati (checkForUpdates(), retryDownload(), nascondendo lo schermo di benvenuto, ecc.). Capgo esegue quei passaggi nativamente. L'unico API che devi chiamare è:

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

CapacitorUpdater.notifyAppReady()

Questa conferma che l'app è avviata con successo. Se la conferma non arriva mai, Capgo effettua automaticamente il rollback del pacchetto—nessun JavaScript aggiuntivo 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 a API (per lo più facoltativo)

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

Cloud di Capawesome	equivalente di Capgo	Avete bisogno di questo?
LiveUpdate.fetchLatestBundle()	CapacitorUpdater.getLatest()	Solo quando si implementa il proprio workflow di download
LiveUpdate.downloadBundle()	CapacitorUpdater.download()	Facoltativo: l'aggiornamento auto-nativo scarica già
LiveUpdate.setNextBundle()	CapacitorUpdater.next()	Facoltativo: il pannello di controllo pina i bundle automaticamente
LiveUpdate.reload()	CapacitorUpdater.reload()	Facoltativo; Capgo impone i bundle obbligatori dopo notifyAppReady()
LiveUpdate.getCurrentBundle()	CapacitorUpdater.current()	Diagnostics facoltativi

Se si aderisce al comportamento di aggiornamento auto-nativo, si può cancellare interamente il JavaScript Capawesome.

Esempi di controllo manuale

Scaricate il bundle più recente

Capgo

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)
  }
}

Capawesome Cloud

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 bundle successivo

Capgo

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

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

Capawesome Cloud

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

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

Applica il bundle scaricato immediatamente

Capgo

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

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

Capawesome Cloud

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 ulteriore code richiesto.

Sempre aggiornato

• Flusso di lavoro precedente: aggiungi un App.resume ascoltatore, chiama download, poi set.
• Capgo: l'aggiornamento automatico in background esegue già il controllo dopo il ripristino. Hai bisogno dell'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: collega la logica di promemoria e imponi il reload.
• Capgo: segnala il bundle come “obbligatorio” nella dashboard, poi ascolta per l'evento (emesso dopo majorAvailable ) per richiedere agli utenti di aggiornare all'interno dell'app. notifyAppReady()Step 6 – Distribuzione dei bundle

Sottosezione intitolata “Step 6 – Distribuzione dei bundle”

, __CAPGO_KEEP_0__ offre un flusso di lavoro simile a __CAPGO_KEEP_1__ e puoi anche automatizzare le distribuzioni interamente tramite __CAPGO_KEEP_2__. 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:

• __CAPGO_KEEP_1__
• Ritenzione automatica (un mese di default) con limiti configurabili fino a 24 mesi.
• Metriche di latenza in tempo reale a cronologia del servizio.capgo.app.

cronologia del servizio

• Inventory e installazione: 10 minuti (npm install, rimuovi vecchio plugin).
• Configurazione e prontezza: 5 minuti (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 i canali e le liste dei dispositivi per voi.

Capgo supporto

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

Capgo è progettato per la durata a lungo termine: aggiornamenti delta nativi, pacchetti crittografati, rollback automatici e analisi che non richiedono JavaScript personalizzato. Una volta migrato, puoi cancellare 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, Capgo Integrazioni per il flusso di lavoro del prodotto in Capgo Integrations, Integrazione CI/CD per la dettaglio di implementazione in Integrazione CI/CD, e GitHub Azioni di integrazione per la dettaglio di implementazione in GitHub Azioni di integrazione.