Migrate von Capawesome Cloud zu Capgo

Einen Einrichtungsprompt mit den Installationsanweisungen und der vollständigen Markdown-Guideline für diesen Plugin kopieren.

⚡️ Capgo automatisiert Kanäle, Bundle-Verwaltung, 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-Plugin 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 müssen Sie nur unser Plugin installieren und rufen Sie CapacitorUpdater.notifyAppReady()Alles andere—Kanäle, Bundle-Verwaltung, Rollbacks, Analytics und CLI-Automatisierung—wird natively gehandhabt. Die folgenden Abschnitte gehen auf jeden Schritt direkt ein.

Bevor Sie beginnen

Stellen Sie sicher, dass Ihr Projekt bereits Capacitor 5 oder später verwendet.
Installieren Sie die 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-Hilfsmittel sind erforderlich.

Schritt 2 – Minimaler Konfiguration

Die vorherige Konfiguration erforderte das Zuordnen von Dutzenden von Optionen 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

Alles, was Capawesome als manuelle Flags (defaultChannel, autoDeleteBundles, Retentionspolitiken usw.) auflistet, wird über das Capgo-Dashboard oder API verwaltet. Sie müssen diese Schlüssel nur überschreiben, wenn Sie Verhaltensweisen wollen, die sich von den Standards von Capgo unterscheiden.

Konfigurations-Quick-Referenz

Capawesome-Option	Capgo-Äquivalent	Müssen Sie es einstellen?
`appId`	Wird aus dem Capgo-Dashboard abgerufen, sobald ein Projekt erstellt wurde	Nur wenn Sie mehrere Projekte in einem Binärdatei verwenden
`defaultChannel`	Kanalregeln werden im Dashboard/API verwaltet	Optional; die meisten Teams setzen dies serverseitig
`autoDeleteBundles`	`autoDeletePrevious: true` (Standard)	Bereits aktiviert
`publicKey`	In Capgo Console verwaltet	Nur wenn Sie die Schlüssel manuell rotieren
`maxVersions` / Rücksichtslosigkeit	Bundle-Retentionspolitik	Zentral in Capgo konfiguriert (1 Monat Standard, 24 Monate maximal)

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

The alte Workflow führte benutzerdefinierte Listener (checkForUpdates(), retryDownload()) ein, die das Splash-Screen versteckten usw. Capgo führt diese Schritte nativ aus. Die einzige API die du aufrufen musst ist:

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

CapacitorUpdater.notifyAppReady()

Dies bestätigt, dass die App erfolgreich gestartet wurde. Wenn die Bestätigung nie eintrifft, führt Capgo automatisch eine Rollback der Bundle durch – kein zusätzliches JavaScript erforderlich.

Das ist alles – Capgo handhabt Hintergrundprüfungen, Splash-Sichtbarkeit und Rollbacks nativ.

Optional: Ausführen von benutzerdefinierten Logik vor dem Verstecken des Splash-Screens

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 haben möchtest.

Capawesome Cloud	Capgo-Äquivalent	Brauchen Sie es?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	Nur bei der Implementierung Ihres eigenen Download-Workflows
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	Optional: Die native Auto-Update-Funktion lädt bereits
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Optional: Die Dashboard-Übersicht pinnt die Bundles automatisch
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Optional; Capgo erzwingt nach `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	Optional Diagnose

Wenn Sie sich an die native Auto-Update-Voreinstellung halten, 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')
  }
}

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

Gespeicherten 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 sie handhabt

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

Hintergrundaktualisierungen

Vorheriger Workflow: in code konfigurieren und herunterladen, sobald erforderlich.
Capgo: aktiviert durch Standard (autoUpdate: true). Keine zusätzliche code erforderlich.

Immer aktuell

Zuvoriger Workflow: ein App.resume : Listener hinzufügen, aufrufen download, dann set.
Capgo: Hintergrund-Auto-Update führt den Check bereits nach dem Wiederaufnehmen durch. Sie benötigen den manuellen Listener nur, wenn Sie ein benutzerdefiniertes Intervall möchten.

Optional: Manueller Wiederaufnahmecheck

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

Zwangsupdate

Zuvoriger Workflow: Logik für die Anforderung von Prompt und Neuladen implementieren.
Capgo: mark the Bundle als „verpflichtend“ im Dashboard an, dann auf das Ereignis (emittiert nach majorAvailable ) hören, um Benutzern innerhalb Ihrer App ein Upgrade aufzudrängen. notifyAppReady()Schritt 6 – Bereitstellung von Bundles

Abschnitt mit dem Titel „Schritt 6 – Bereitstellung von Bundles“

, __CAPGO_KEEP_0__ bietet ein ähnliches __CAPGO_KEEP_1__-Workflow an, und Sie können auch die Bereitstellung vollständig über __CAPGO_KEEP_2__ automatisieren. 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__
Automatische Aufbewahrung (ein Monat Standard, konfigurierbare Grenzen bis zu 24 Monaten).
Echtzeit-Latenzmesswerte bei status.capgo.app/history.

Abschnitt mit dem Titel „Migrationsgeschichte“

: 10 Minuten (, alte Plugin entfernen).npm installKonfiguration & Bereitschaft
: 5 Minuten (SanitätsprüfungennotifyAppReady).
: 15 Minuten (optional manuelle Tests oder Hörer).status.__CAPGO_KEEP_0__.app/history
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 langfristige Zuverlässigkeit konzipiert: native Delta-Updates, verschlüsselte Pakete, automatische Rollbacks und Analysen, die keine benutzerdefinierte JavaScript-Code erfordern. Sobald Sie migriert haben, können Sie die aufwändige Wartung entfernen und lassen das Platform Updates automatisch durchführen.

Weitermachen von Migrieren Sie von Capawesome Cloud zu Capgo

Wenn Sie __CAPGO_KEEP_0__ verwenden Migrieren Sie 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 CI/CD-Integration, und GitHub Actions-Integration für die Implementierungsdetails in GitHub Actions-Integration.