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, le annullazioni, le analisi e CLI carica i file natively. Utilizza questa guida per eseguire i passaggi minimi richiesti per la migrazione e, facoltativamente, ricreare qualsiasi comportamento personalizzato di cui hai ancora bisogno.

Panoramica

Raccogli le tue configurazioni Cloud Capawesome esistenti (ID App, canali, chiavi di firma, token CLI) per poterle archiviare o verificare in seguito.
Installa il plugin Capgo, elimina Capawesome SDK e chiama CapacitorUpdater.notifyAppReady().
Configura il comportamento facoltativo (download manuali, pinning dei pacchetti, ricarichi) se dipendi da quei flussi oggi.

Con Capgo hai bisogno di installare solo il nostro plugin e chiamare CapacitorUpdater.notifyAppReady(). Tutti gli altri aspetti — canali, pulizia del pacchetto, rollback, analisi e CLI automatizzazione — vengono gestiti 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/cliSe hai l'intenzione di inviare bundle da CI/CD.

Step 1 – Installa Capgo e elimina il plugin Capawesome SDK

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

Quello è lo scambio obbligatorio. Il nativo di Capgo fornisce il plugin con il proprio code; non sono necessarie ulteriori funzioni di aiuto JavaScript.

Step 2 – Configurazione minima

La precedente configurazione 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

Ogni opzione di Capawesome elencata come flag manuale (defaultChannel, autoDeleteBundlesecc.) è gestita 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	Corrispettivo di Capgo	Hai bisogno di impostarlo?
`appId`	Dal Capgo dashboard una volta creato un progetto	Solo se si utilizzano più progetti in un binario
`defaultChannel`	Regole del canale gestite nel dashboard/API	Optional; most teams set this server-side
`autoDeleteBundles`	`autoDeletePrevious: true` (di default)	Già abilitato
`publicKey`	Gestito nel Capgo console	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)

La vecchia procedura 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()

Questo conferma che l'app è stata avviata con successo. Se la conferma non arriva mai, Capgo effettua automaticamente il rollback del bundle – senza bisogno di codice aggiuntivo.

Ecco fatto—Capgo gestisce controlli di background, visibilità dello splash e rollback natiamente.

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ù facoltative)

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

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

Se mantenete il comportamento di aggiornamento auto-nativo, potete cancellare interamente il codice JavaScript di Capawesome.

Esempi di controllo manuale

Scaricate 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 pacchetto

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 pacchetto 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

Flusso di lavoro precedente: aggiungi un App.resume ascoltatore, chiama download, quindi set.
CapgoLa verifica di aggiornamento automatica di background è già eseguita dopo il ripristino. Se desideri un intervallo personalizzato, hai bisogno di un ascoltatore manuale.

Verifica di ripristino facoltativa

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

Aggiornamento forzato

Flusso precedente: logica di promemoria e rilascio obbligatorio.
: CapgoSegnala il bundle come “obbligatorio” nella dashboard, quindi ascolta per majorAvailable evento (emesso dopo) notifyAppReady()Per richiedere agli utenti di aggiornare all'interno della tua app.

Passo 6 – Distribuzione dei bundle

Se hai precedentemente dipinto da capawesome live-update deploy, Capgo offre un flusso di lavoro simile CLI e puoi anche automatizzare le distribuzioni interamente tramite 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.
Ritenzione automatica (un mese di default) con limiti configurabili fino a 24 mesi.
Metriche di latenza in tempo reale a status.capgo.app/storia.

Timeline di migrazione

Inventory & installazione: 10 minuti (npm install: rimuovi vecchi plugin).
Configurazione & prontezza: 5 minuti (notifyAppReady).
Verifiche di sistema: 15 minuti (test manuali facoltativi o ascoltatori).
Prima distribuzione10 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.

Sostegno Capgo

Supporto __CAPGO_KEEP_0__Sezione intitolata “Supporto __CAPGO_KEEP_0__” book.capgo.app/demo.
CommunityUnisciti Capgo Discord.
Raccolta issue: github.com/Cap-go/capacitor-aggiornatore/issues.

Capgo è progettato per una lunga durata: aggiornamenti delta nativi, pacchetti crittografati, rollback automatico 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 Migra da Capawesome Cloud a Capgo

Se stai utilizzando Migra 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 workflow del prodotto in Capgo Build nativi Capgo Integrazioni per il workflow del prodotto in Capgo Integrazioni Integrazione CI/CD per i dettagli di implementazione in Integrazione CI/CD, e GitHub Azioni di integrazione per i dettagli di implementazione in GitHub Azioni di integrazione.