Migrate from Capawesome Cloud zu Capgo

Kopieren Sie einen Setup-Vorschlag mit den Installationsanweisungen und der vollständigen Markdown-Anleitung für diesen Plugin.

⚡️ Capgo automatisiert Kanäle, Bundle-Vernässung, Rollover, Analytics und CLI-Uploads natively. Verwenden Sie diese Anleitung, um die minimalen Schritte durchzuführen, um zu migrieren und optional jede benutzerdefinierte Funktion zu wiederherstellen, die Sie noch benötigen.

Übersicht

Sammeln Sie Ihre bestehende Capawesome Cloud-Konfiguration (App-ID, Kanäle, Signatur-Schlüssel, CLI-Tokens) , damit 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 Paketen, Neuladen) , wenn Sie sich auf diese Flüsse heute verlassen.

Mit Capgo müssen Sie nur unser Plugin installieren und rufen Sie CapacitorUpdater.notifyAppReady(). Alles andere—Kanäle, Bundle-Vernässung, Rollover, Analytics und CLI-Automatisierung—wird natively bearbeitet. Die Abschnitte unten gehen auf jeden Auftrag direkt ein.

Bevor Sie beginnen

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

Schritt 1 – Installieren Sie Capgo und entfernen Sie die 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 Abbilden von Dutzenden von Optionen in capacitor.configCapgo 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 (defaultChannel, autoDeleteBundles, Retentionspolitiken usw.) verwaltet werden, durch das Capgo-Dashboard oder API. Sie müssen diese Schlüssel nur überschreiben, wenn Sie ein Verhalten wollen, das sich von den Standards von Capgo unterscheidet.

Konfigurations-Quick-Referenz

Capawesome-Einstellung	Capgo-Äquivalent	Müssen Sie es einstellen?
`appId`	Zurückgenommen aus dem Capgo-Dashboard, sobald Sie ein Projekt erstellen	Nur, wenn Sie mehrere Projekte in einem Binary verwenden
`defaultChannel`	Kanalregeln verwaltet im Dashboard/API	Optional; die meisten Teams setzen dies serverseitig
`autoDeleteBundles`	`autoDeletePrevious: true` (default)	Bereits aktiviert
`publicKey`	Verwaltet im Capgo-Konsole	Nur wenn Sie die Schlüssel manuell rotieren
`maxVersions` / retention	Bundle-Retentionspolitik	Zentral in Capgo konfiguriert (1 Monat Standard, 24 Monate maximal)

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

Die alte Workflow führte benutzerdefinierte Hörer (checkForUpdates(), retryDownload()etc.) ein. Capgo führt diese Schritte nativ aus. Der einzige API , den Sie aufrufen müssen, 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 einen Rollback durch—kein zusätzliches JavaScript erforderlich.

Das ist alles—Capgo übernimmt Hintergrundprüfungen, Splash-Sichtbarkeit und Rollbacks nativ.

Optional: run custom logic before the splash screen hides

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 – API-Aufrufe abbilden (meistens optional)

In Capgo lassen Sie normalerweise den automatischen Updater laufen; manuelle APIs bleiben verfügbar, wenn Sie vollständige Kontrolle benötigen.

Capawesome Cloud	Capgo-Äquivalent	Brauchen Sie es?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	Nur bei der Implementierung Ihres eigenen Download-Workflows
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	Optional: native auto-update lädt bereits automatisch herunter
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Optional: Das Dashboard pinnt Bundles automatisch
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Optional; Capgo erzwingt nachfolgende verpflichtende Bundles nach `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	Optional Diagnose

Wenn Sie sich an die native auto-update Verhalten halten, können Sie den Capawesome JavaScript vollständig löschen.

Beispiel für manuelle Kontrolle

Herunterladen des neuesten Bundles

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

Setze das nächste Bundle

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

Anwenden Sie das heruntergeladene Bundle sofort

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’s wie sie übersetzt werden:

Hintergrundaktualisierungen

Vorheriger WorkflowKonfigurieren Sie in code und planen Sie die Downloads manuell an.
CapgoAktiviert standardmäßigautoUpdate: trueKein zusätzliches code erforderlich.

: Kein zusätzliches __CAPGO_KEEP_0__ erforderlich.

Vorheriger Workflowhinzufügen App.resume Hörer, Aufruf download, dann set.
CapgoHintergrund-Auto-Update führt die Überprüfung bereits nach dem Wiederanfang durch. Sie benötigen den manuellen Listener nur, wenn Sie ein benutzerdefiniertes Intervall wünschen.

Optional: manuelle Fortsetzung überprüfen

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

Zwischenablage kopieren

Abschnitt mit dem Titel „Zwangsaktualisierung“: Kabellose Promptlogik und Neuladen erzwingen.
Capgo: Drahtlose Logik für den Prompt und erzwinge einen Neuladen. majorAvailable ereignis (emittiert nachdem notifyAppReady()) um Benutzern innerhalb Ihrer App zu fordern, zu aktualisieren.

Schritt 6 – Bereitstellung von Paketen

Wenn Sie sich zuvor auf capawesome live-update deploy, Capgo bietet eine ähnliche CLI-Workflow und Sie können auch die Bereitstellung vollständig über API automatisieren.

# 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

Da Capgo die Paketgesundheit automatisch verfolgt, erhalten Sie auch:

Geräteebene Audit-Protokolle für jeden Installationsvorgang.
Automatische Aufbewahrung (ein Monat standardmäßig) mit konfigurierbaren Grenzen bis zu 24 Monaten.
Echtzeit-Verzögerungs-Metriken bei status.capgo.app/Geschichte.

Migrationszeitleiste

Bestand und Installation: 10 Minuten (npm install, alte Plugin entfernen).
Konfiguration und Bereitschaft: 5 Minuten (notifyAppReady).
Sanitätsprüfungen: 15 Minuten (optional manuelle Tests oder Hörer).
Erste Bereitstellung10 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

Migrationsbegleiter: Buchen Sie eine Sitzung bei buch.capgo.app/demo.
Gemeinschaft: treten Sie der Capgo Discord.
__CAPGO_KEEP_0__-Discord: github.com/Cap-go/capacitor-updater/issues.

Capgo is built for long-term reliability: native delta updates, encrypted bundles, automatic rollbacks, and analytics that do not require custom JavaScript. Once you migrate you can delete the maintenance-heavy glue and let the platform run updates automatically.

Weiter von Migrate from Capawesome Cloud zu Capgo

Wenn Sie __CAPGO_KEEP_0__ verwenden Migrate from Capawesome Cloud zu Capgo zur Planung der CI/CD-Automatisierung, mit ihr verbinden Capgo CI/CD für den Produktworkflow in Capgo Native Builds für den Produktworkflow in Capgo Integrations für den Produktworkflow in Capgo Integrations Capgo Integrations für den Produktworkflow in Capgo Integrations für den Produktworkflow in __CAPGO_KEEP_0__ Integrations für die Implementierungsdetails in der CI/CD-Integration und GitHub-Aktionen-Integration für die Implementierungsdetails in der GitHub-Aktionen-Integration.