Migrate von Capawesome Cloud zu Capgo

Eine Einrichtungsvorlage mit den Installationsanweisungen und der vollständigen Markdown-Dokumentation für diesen Plugin kopieren.

⚡️ Capgo automatisiert Kanäle, Bundle-Aufräumung, Rollbacks, Analytics und CLI-Uploads natively.

Übersicht

Sammeln Sie Ihre bestehende Capawesome Cloud-Konfiguration (App-ID, Kanäle, Signierungsschlüssel, CLI-Tokens) so dass Sie sie später archivieren oder überprüfen können.
Installieren Sie das Capgo-Plugin, entfernen Sie das Capawesome SDK und rufen Sie CapacitorUpdater.notifyAppReady().
Konfigurieren Sie optionalen Verhalten (manuelle Downloads, Pinning von Bundles, Reloads) wenn Sie sich auf diese Flows heute noch verlassen.

Mit Capgo benötigen Sie nur unsere Plugin-Installation und Aufruf CapacitorUpdater.notifyAppReady()Alles andere—Kanäle, Bundle-Aufräumung, Rollbacks, Analytics und CLI-Automatisierung—wird natively gehandhabt.

Bevor Sie beginnen

Stellen Sie sicher, dass Ihr Projekt bereits Capacitor 5 oder später verwendet.
Installieren Sie den Capgo CLI (npm install -g @capgo/cli) wenn Sie beabsichtigen, Bundles aus CI/CD zu pushen.

Schritt 1 – Installieren Sie Capgo und entfernen Sie den Capawesome SDK

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

Das ist der einzige erforderliche Austausch. Capgo’s native code ist mit dem Plugin geliefert; keine zusätzlichen JavaScript-Hilfsfunktionen sind erforderlich.

Schritt 2 – Minimaler Konfiguration

Die vorherige Konfiguration erforderte das Mappen von Dutzenden von Optionen in capacitor.config. Capgo erkennt Ihr Projekt automatisch, daher sieht die minimale Konfiguration wie folgt aus:

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

Alle von Capawesome als manuelle Flags aufgelisteten Einstellungen (defaultChannel, autoDeleteBundles, Retentionspolitiken usw.) werden über das Capgo-Dashboard oder API verwaltet. Sie müssen diese Schlüssel nur überschreiben, wenn Sie ein Verhalten wollen, das sich von den Standards von Capgo unterscheidet.

Konfigurations-Übersicht

__CAPGO_KEEP_0__-Äquivalent	Capgo equivalent	Wird aus dem __CAPGO_KEEP_0__-Dashboard abgerufen, sobald ein Projekt erstellt wurde
`appId`	Taken from the Capgo dashboard once you create a project	Kanalregeln im Dashboard/__CAPGO_KEEP_0__ verwaltet
`defaultChannel`	Channel rules managed in the dashboard/API	Optional; die meisten Teams setzen dies serverseitig
`autoDeleteBundles`	`autoDeletePrevious: true` (Standard)	Bereits aktiviert
`publicKey`	Verwaltet in Capgo-Konsole	Nur wenn Sie die Schlüssel manuell rotieren
`maxVersions` / Aufbewahrungsdauer	Bundle-Aufbewahrungspolitik	Zentral in Capgo konfiguriert (1 Monat Standard, 24 Monate maximal)

Schritt 3 – Aufruf `notifyAppReady()` (der einzige erforderliche Hook)

Die alte Workflow führte benutzerdefinierte Listener eincheckForUpdates(), retryDownload()Versteckt die Willkommensseite usw. Capgo führt diese Schritte native aus. Die einzige API die du aufrufen musst ist:

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

CapacitorUpdater.notifyAppReady()

Das bestätigt, dass die App erfolgreich gestartet wurde. Wenn die Bestätigung nie eintrifft, Capgo rollt automatisch die Bundle zurück – kein zusätzliches JavaScript erforderlich.

Das ist alles – Capgo handhabt Hintergrundprüfungen, Willkommensseite-Versteckung und Rollbacks native.

Optional: Ausführen von benutzerdefinierten Logik vor der Versteckung der Willkommensseite

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

Schritt 4 – Abbilden von API Aufrufen (meist optional)

In Capgo lässt du normalerweise den Auto-Updater laufen; manuelle APIs bleiben verfügbar, wenn du vollständige Kontrolle benötigst.

Capawesome Cloud	Capgo-Äquivalent	Benötigst du es?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	Nur wenn Sie Ihren eigenen Download-Workflow implementieren
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	Optional: Native Auto-Update lädt bereits automatisch
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Optional: Das Dashboard pinnt Bundles automatisch
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Optional; Capgo erzwingt nach `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	Optional Diagnose

Wenn Sie sich bei der native Auto-Update-Voreinstellung entscheiden, können Sie den Capawesome-JavaScript-Code vollständig löschen.

Beispiel für manuelle Kontrolle

Laden Sie das neueste Bundle herunter

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

Den nächsten Bundle festlegen

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

Den heruntergeladenen Bundle sofort anwenden

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

Schritt 5 – Aktualisierungsstrategien: Wie Capgo damit umgeht

Capawesome dokumentiert drei Strategien. Hier ist, wie sie übersetzt werden:

Hintergrundaktualisierungen

Vorheriger Workflow: Konfigurieren Sie in code und laden Sie die Downloads manuell an.
Capgo: aktiviert durch Standard (autoUpdate: true) Keine zusätzliche code erforderlich.

Immer aktuell

Vorheriger Workflow: Hinzufügen eines App.resume Listener, aufrufen download, dann set.
Capgo: Hintergrund-Auto-Update führt bereits die Überprüfung nach dem Wiederaufleben durch. Sie benötigen den manuellen Listener nur, wenn Sie ein benutzerdefiniertes Intervall wünschen.

Optional: Manuelle Wiederauflebensüberprüfung

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

Zwangsaktualisierung

Vorheriger Workflow: Funklogik anbinden und Neuladen durchsetzen.
Capgo: mark the bundle als "zwingend" im Dashboard an, dann auf das Ereignis (emittiert nach majorAvailable Step 6 – Bereitstellung von Bundeln notifyAppReady()Abschnitt mit dem Titel „Step 6 – Bereitstellung von Bundeln“

Wenn Sie sich zuvor auf

Terminalfenster 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:

event (emitted after
Step 6 – Deploying bundles
Echtzeit-Latenzmesswerte bei status.capgo.app/history.

Migrationstabelle

Bestand & Installation: 10 Minuten (npm install, alte Plugin entfernen).
Konfiguration & Bereitschaft: 5 Minuten (notifyAppReady).
Sanitätsprüfungen: 15 Minuten (optional manuelle Tests oder Hörer).
Erste Bereitstellung: 10 Minuten mit Capgo CLI oder CI-Integration.

In der Praxis schaffen Teams das in weniger als einer Stunde. Wenn Sie Capawesome-Projekt-Daten bereitstellen, können wir sogar Kanäle und Geräte-Listen für Sie importieren.

Capgo-Support

Migration-Konziere: Buchen Sie eine Sitzung bei book.capgo.app/demo.
Community: Beitritt zum Capgo-Discord.
Issue-Tracker: github.com/Cap-go/capacitor-Updater/issues.

Capgo ist für Langzeitzuverlässigkeit konzipiert: native Delta-Updates, verschlüsselte Bundles, automatische Rollbacks und Analytics, die keine benutzerdefinierte JavaScript-Code erfordern. Sobald Sie migriert haben, können Sie die aufwändige Wartung des Glücks löschen und lassen das Plattform Updates automatisch durchführen.

Weitermachen von Migrate von Capawesome Cloud zu Capgo

Wenn Sie Migrate von Capawesome Cloud zu Capgo um die CI/CD-Automatisierung zu planen, verbinden Sie es mit Capgo CI/CD für den Produktworkflow in Capgo CI/CD, Capgo Native Builds für den Produktworkflow in Capgo Native Builds, Capgo Integrations für den Produktworkflow in Capgo Integrations, CI/CD Integration für die Implementierungsdetails in der CI/CD Integration, und GitHub Aktionen Integration für die Implementierungsdetails in GitHub Aktionen Integration.