Migriere von Capawesome Cloud zu Capgo

Kopieren Sie eine Einrichtungsanweisung mit den Installationsanweisungen und der vollständigen Markdown-Guideline für diesen Plugin.

⚡️ Capgo automatisiert Kanäle, Bundle-Aufräumung, Rollbacks, 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, 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 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 das Capgo CLI (npm install -g @capgo/cliWenn Sie Pläne sind, Bundle 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 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

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

Konfigurations-Quick-Referenz

__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, die im Dashboard/__CAPGO_KEEP_0__ verwaltet werden
`defaultChannel`	Channel rules managed in the dashboard/API	Standardwert
`autoDeleteBundles`	`autoDeletePrevious: true` Konfigurations-Quick-Referenz	Bereits aktiviert
`publicKey`	Verwaltet in Capgo-Konsole	Nur wenn Sie die Schlüssel manuell rotieren
`maxVersions` / Rückerstattung	Bundle-Rückhalteregelung	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 (checkForUpdates(), retryDownload(), Verstecken des Splash-Screens usw.) 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()

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

Das ist alles—Capgo handhabt Hintergrundprüfungen, Splash-Visibilität und Rollbacks nativ.

Optional: Führen Sie benutzerdefinierte Logik vor dem Verschwinden der Splash-Schleife 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 (meist optional)

In Capgo lassen Sie normalerweise den Auto-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 herunter
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Optional: Dashboard-Pins Pakete automatisch
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Optional; Capgo verpflichtet Pakete nach `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	Optional Diagnose

Wenn Sie sich an das native Auto-Update-Verhalten halten, können Sie den Capawesome-JavaScript-Code vollständig löschen.

Beispiel für manuelle Kontrolle

Laden Sie das neueste Paket 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ächstes Paket 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 handhabt sie

Capawesome beschreibt 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). Kein zusätzliches code erforderlich.

Immer aktuell

Vorheriger Workflow: Fügen Sie einen App.resume Hörer hinzu, rufen Sie downloadHierzu set.
Capgo: Hintergrundaktualisierung läuft bereits nach dem Wiederauffrischen ab. Sie benötigen den manuellen Listener nur, wenn Sie ein benutzerdefiniertes Intervall wünschen.

Optional: Manueller Wiederauffrischungscheck

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

Vorherige Workflow: Funktionalität für die Anweisung und Zwangsladung implementieren.
Capgo: Markieren Sie das Bundle als “Pflicht” im Dashboard und hören Sie dann auf das majorAvailable ereignis (emitiert nachdem notifyAppReady()fordern Sie den Benutzern, dass sie sich innerhalb Ihrer App aktualisieren.

Schritt 6 – Bereitstellung von Bundeln

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 Bundelgesundheit 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/history.

Migrationszeitplan

Bestand und Installation: 10 Minuten (npm install, alte Plugin entfernen).
Konfiguration und Bereitschaft: 5 Minuten (notifyAppReady).
Sinnvollkeitsprü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-Projektinformationen bereitstellen, können wir sogar Kanäle und Gerätelisten importieren.

Capgo Unterstützung

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 gebaut: 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 des Verbindungsstücks löschen und lassen das Plattform Updates automatisch durchführen.

Migrieren Sie weiterhin von Capawesome Cloud zu Capgo

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