Migrieren Sie von Capawesome Cloud zu Capgo

Ein Setup-Prompt mit den Installations-Schritten und der vollständigen Markdown-Dokumentation für diesen Plugin kopieren.

⚡️ Capgo automatisiert Kanäle, Bundle-Aufräumung, Rollbacks, Analytics und CLI-Uploads natively. Verwenden Sie diese Anleitung, um die minimalen Schritte durchzuführen, die zum Migrieren erforderlich sind, und optional jedes benutzerdefinierte Verhalten, das Sie noch benötigen.

Ü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 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. Die folgenden Abschnitte gehen auf jeden Auftrag 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

The previous setup required mapping dozens of options 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 aufgelisteten Einstellungen (defaultChannel, autoDeleteBundles, Retentionspolitiken usw.) werden ü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	Brauchen Sie es einstellen?
`appId`	Übernommen aus dem Capgo-Dashboard, sobald Sie ein Projekt erstellt haben	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`	Verwaltet in Capgo-Konsole	Nur wenn Sie Schlüssel manuell rotieren
`maxVersions` / Aufbewahrungsfrist	Bundle-Aufbewahrungsrichtlinie	Zentral im Capgo (1 Monat Standard, 24 Monate maximal) konfiguriert

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

Die alte Workflow führte benutzerdefinierte Listener (checkForUpdates(), retryDownload(), das Verstecken des Splash-Screens usw. ein. Capgo führt diese Schritte nativ durch. Der einzige API , den 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 Rückschaltung des Bundles durch—kein zusätzliches JavaScript erforderlich.

Das ist es—Capgo handhabt Hintergrundprüfungen, Splash-Sichtbarkeit und Rückschaltungen nativ.

Optional: Führe benutzerdefinierte Logik vor dem Verstecken des Splash-Screens aus

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 – Karte API Aufrufe (zumeist optional)

In Capgo lässt du normalerweise den automatischen 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 beim Implementieren Ihres eigenen Download-Workflows
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	Optional: Die native Auto-Update-Funktion lädt bereits automatisch
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Optional: Die Dashboard-Pins laden die Bundles automatisch
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Optional; Capgo erzwingt nachhaltige Bundles 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')
  }
}

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

Die heruntergeladene 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.

Jedemal aktuell

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

Optional: Manuelle Wiederaufnahmeprobleme

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: Drahtfaden-Logik und erzwingen Sie einen Neustart.
Capgo: Markieren Sie das Bundle als „Pflicht“ im Dashboard an, und hören Sie dann auf das majorAvailable Ereignis (emittiert nach notifyAppReady()) um Benutzern innerhalb Ihrer App einen Upgrade aufzudrängen.

Schritt 6 – Bereitstellung von Bundles

Wenn Sie sich zuvor auf capawesome live-update deploy, Capgo bietet ein ähnliches CLI-Workflow an, 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 Bundle-Health automatisch verfolgt, erhalten Sie auch:

Geräteebene Auditprotokolle für jeden Installationsvorgang.
Automatische Aufbewahrung (ein Monat standardmäßig) mit konfigurierbaren Grenzen bis zu 24 Monaten.
Echtzeit-Verzögerungsdaten bei `status.__CAPGO_KEEP_0__.app/history`. status.capgo.app/history.

Abschnitt mit dem Titel „Migrationstabelle“

: 10 Minuten (, alte Plugin entfernen).npm installKonfiguration und Bereitschaft
: 5 Minuten (SanitätsprüfungennotifyAppReady).
Sanity checks: 15 Minuten (optional manuelle Tests oder Hörer).
Erste Bereitstellung: 10 Minuten mit Capgo CLI oder CI-Integration.

In der Praxis schaffen Teams es 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

Migrations-Konziere: Buchen Sie eine Sitzung bei buch.capgo.app/demo.
Gemeinschaft: Beitritt zum Capgo-Discord.
Problemtracker: github.com/Cap-go/capacitor-updater/issues.

Capgo ist für Langzeitzuverlä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 Sie das Plattform die Updates automatisch durchführen.

Geht weiter von Migrieren Sie von Capawesome Cloud zu Capgo

Wenn Sie Capawesome Cloud verwenden Migrieren Sie von Capawesome Cloud zu Capgo um die CI/CD-Automatisierung zu planen, verbinden Sie es mit Capgo CI/CD zur Produktworkflow in Capgo CI/CD, Capgo Native Builds zur 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.