Von Capawesome Cloud zu Capgo migrieren

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

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

Benutzbarer Leitfaden

Sammeln Sie Ihre bestehende Capawesome Cloud-Konfiguration (App-ID, Kanäle, Signierungsschlüssel, CLI-Tokens) so dass Sie es 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 Flüsse heute noch verlassen.

Mit Capgo benötigen Sie nur die Installation unseres Plugins und das Aufrufen von CapacitorUpdater.notifyAppReady()Alles andere—Kanäle, Bundle-Aufräumung, Rollbacks, Analytics und CLI-Automatisierung—wird natively gehandhabt. Die folgenden Abschnitte gehen direkt auf jeden Auftrag 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 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 – Minimalisierung der 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 ein Verhalten wollen, das sich von den Standards von Capgo unterscheidet.

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 verwaltet/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` / Aufbewahrungsfrist	Bundle-Aufbewahrungsrichtlinie	Zentral im Capgo (1 Monat Standard, 24 Monate maximal) konfiguriert

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

Die alte Workflow führte benutzerdefinierte Listener (checkForUpdates(), retryDownload(), die Splash-Schaltfläche versteckt, usw.). Capgo führt diese Schritte natively durch. 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, Capgo rollt automatisch die Bundle zurück—kein zusätzliches JavaScript erforderlich.

Das ist alles—Capgo handhabt Hintergrundprüfungen, Splash-Sichtbarkeit und Rollbacks natively.

Optional: Ausführen von benutzerdefinierten Logik vor der Versteckung der Splash-Schaltfläche

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 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 wenn Sie Ihren eigenen Download-Workflow implementieren
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	Optional: Native Auto-Update lädt bereits herunter
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Optional: Das Dashboard pinnt Bundel automatisch
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Optional; Capgo erzwingt nachdrückliche Bundel 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.

Beispiele für manuelles Kontrollieren

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

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

Wende das heruntergeladene Bundle sofort an

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

Vorheriger Workflow: ein App.resume Hörer hinzufügen, aufrufen download, dann set.
Capgo: Hintergrund-Auto-Update führt den Check bereits nach Wiederanfang durch. Sie benötigen den manuellen Hörer nur, wenn Sie einen benutzerdefinierten Intervall möchten.

Optional: manueller Wiederanfangscheck

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

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

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

, zählte __CAPGO_KEEP_0__ 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 24 Monate)
Echtzeit-Latenzmesswerte bei status.capgo.app/history.

Migrationstabelle

Bestand & Installation: 10 Minuten (npm install: 5 Minuten (
Sanheitsprüfungen: 15 Minuten (optional manuelle Tests oder Hörer).notifyAppReady).
Konfiguration & BereitschaftEntferne alte Plugin
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

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

Capgo ist für Langzeiterfolge 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 des Glücks löschen und lassen das Plattform die Updates automatisch durchführen.

Weitermachen 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 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.