Migrare da Capawesome Cloud a Capgo

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

Panoramica

1. Raccogli la tua configurazione Cloud di Capawesome (ID dell'app, 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, pin dei pacchetti, ricarichi) se dipendi da quei flussi oggi.

Con Capgo avrai bisogno di installare solo il nostro plugin e chiamare CapacitorUpdater.notifyAppReady()Tutto il resto—canali, pulizia del pacchetto, annullamenti, analisi e CLI automatizzazione—is gestito nativamente. Le sezioni di seguito guidano attraverso ogni compito direttamente.

Prima di iniziare

• Assicurati che il tuo progetto stia già utilizzando Capacitor 5 o una versione successiva.
• 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

È l'unica sostituzione obbligatoria. Capgo dispone di un code nativo che viene fornito con il plugin; non sono richiesti aiuti JavaScript aggiuntivi.

Passo 2 – Configurazione minima

Il precedente setup richiedeva la mappatura di decine di opzioni in 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, autoDeleteBundlespolitiche 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 Capawesome	Corrispondente di Capgo	Avete bisogno di impostarlo?
appId	Prelevato dalla dashboard Capgo una volta creato un progetto	Solo se si utilizzano più progetti in un binario
defaultChannel	Regole del canale gestite nella dashboard/API	Facoltativo; la maggior parte delle squadre imposta questo server-side
autoDeleteBundles	autoDeletePrevious: true (di default)	Già abilitato
publicKey	Gestito nella console Capgo	Solo se si ruota manualmente le chiavi
maxVersions / retention	Politica di conservazione del bundle	Configurato centralmente in Capgo (1 mese di default, 24 mesi massimo)

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

Il vecchio workflow ha introdotto ascoltatori personalizzati (checkForUpdates(), retryDownload(), nascondere 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 bundle—nessun codice aggiuntivo necessario.

È tutto—Capgo gestisce i controlli 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; rimangono disponibili le API manuali se desideri avere il controllo completo.

Capawesome Cloud	Capgo equivalente	Hai bisogno di esso?
LiveUpdate.fetchLatestBundle()	CapacitorUpdater.getLatest()	Solo quando implementi il tuo proprio flusso di download
LiveUpdate.downloadBundle()	CapacitorUpdater.download()	Facoltativo: l'aggiornamento automatico nativo scarica già
LiveUpdate.setNextBundle()	CapacitorUpdater.next()	Facoltativo: il pannello di controllo pina automaticamente i pacchetti
LiveUpdate.reload()	CapacitorUpdater.reload()	Facoltativo; Capgo impone i pacchetti obbligatori dopo notifyAppReady()
LiveUpdate.getCurrentBundle()	CapacitorUpdater.current()	Facoltativo i diagnostici

Se mantieni il comportamento di aggiornamento automatico nativo puoi cancellare interamente il JavaScript di Capawesome.

Esempi di controllo manuale

Scarica l'ultima bundle

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 la prossima bundle

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 immediatamente la bundle scaricata

Capgo

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

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

Cloud di Capawesome

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

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

Passo 5 – Strategie di aggiornamento: come Capgo le gestisce

I documenti di Capawesome descrivono tre strategie. Ecco come si traducono:

Aggiornamenti in background

• Flusso di lavoro precedente: configurare in code e pianificare i download manualmente.
• Capgocontexto: frammento di testo HTML da una stringa di UI Capgo più lunga (chiave padre `submitting_a_pr_to_capgo`). Pagina/area: Sito web di marketing Capgo. Ruolo: Testo del sito web. Visualizzato in: pagina contributing.astro. Preservare esattamente i termini del prodotto/marca e del developer Capgo. Chiave del messaggio `submitting_a_pr_to_capgo` (Invio di un PR a Capgo).autoUpdate: true. Nessun ulteriore code richiesto.

Sempre aggiornato

• Flusso di lavoro precedente: aggiungi un App.resume ascoltatore, chiama download, quindi set.
• Capgocontexto: testo HTML da una stringa di Capgo UI più lunga (chiave padre `submitting_a_pr_to_capgo`). Pagina/area: Sito web di marketing di Capgo. Ruolo: Copia del sito web. Visto in: pagina contributing.astro. Preservare esattamente i termini del prodotto e della marca Capgo e i termini dei developer.

: l'aggiornamento automatico di background esegue già il controllo dopo il ripristino. Hai bisogno dell'ascoltatore manuale solo se desideri un intervallo personalizzato.

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

Copia negli appunti

• Flusso di lavoro precedente: logica di promemoria a filo e imponi il riavvio.
• Capgo: segnala il bundle come “obbligatorio” nella dashboard, quindi ascolta l'evento (emesso dopo majorAvailable ) per richiedere agli utenti di aggiornare all'interno dell'applicazione. notifyAppReady()Passo 6 – Distribuzione dei bundle

Sezione intitolata “Passo 6 – Distribuzione dei bundle”

, __CAPGO_KEEP_0__ offre un flusso di lavoro simile di __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

Poiché Capgo monitora automaticamente la salute del pacchetto, ottieni anche:

• Log di audit a livello di dispositivo per ogni installazione.
• Ritiro automatico (un mese di default) con limiti configurabili fino a 24 mesi.
• Metriche di latenza in tempo reale a status.capgo.app/storia.

Cronologia della migrazione

• Inventario & installazione10 minuti (npm installrimuovi vecchio plugin).
• Configurazione & prontezza: 5 minuti (notifyAppReady).
• Verifiche di base: 15 minuti (test manuali facoltativi o ascoltatori).
• Prima distribuzione: 10 minutes with Capgo CLI or CI integration.

: 10 minuti con __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ o integrazione di CI.

Capgo support

• Sezione intitolata “__CAPGO_KEEP_0__ supporto”Concierge di migrazione book.capgo.app/demo.
• : prenotate una sessione a book.__CAPGO_KEEP_0__.app/demo. (tradotto da Community, visto nel footer del sito di marketing di Capgo. Pagina/area: sito di marketing di Capgo. Ruolo: etichetta UI breve o elemento di navigazione. Messaggio chiave `community` (Community).: unisciti a Capgo Discord.
• Segnalazione issue: github.com/Cap-go/capacitor-updater/issues.

Capgo è progettato per una affidabilità 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 from Capawesome Cloud a Capgo

Se stai utilizzando Migrate from Capawesome Cloud a Capgo per pianificare l'automazione del flusso di lavoro 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 Integrazioni Integrazione CI/CD per la dettaglio di implementazione in Integrazione CI/CD, e GitHub Integrazione azioni per la dettaglio di implementazione in GitHub Integrazione azioni