Zum Inhalt springen

Migration von AppFlow zu Capgo

🚦 Ionic hat angekündigt, dass die kommerziellen Produkte von AppFlow – einschließlich Live Updates – eingestellt werden. Bestehende Projekte können noch bis zum 31. Dezember 2027laufen, es werden jedoch keine neuen Kunden mehr akzeptiert und keine neuen Features geplant. Dieser Leitfaden führt Sie durch die erforderlichen Schritte zur Migration zu Capgo und hebt die nativen Automatisierungsfunktionen hervor, die Sie dadurch erhalten.

Capgo übernimmt Channels, Bundle-Retention, Rollbacks, Analytics und CLI-Uploads für Sie. Die Migration besteht im Wesentlichen darin, das Plugin zu installieren, CapacitorUpdater.notifyAppReady()aufzurufen und – falls gewünscht – optionale manuelle Steuerungen zu konfigurieren. Die folgenden Abschnitte gehen direkt auf jede Aufgabe ein.

  • Notiere deine AppFlow App-ID, bestehende Channels und Signing Keys.
  • Exportiere die Bundle-Historie, die du archivieren möchtest.
  • Wenn du GitHub Actions oder einen anderen CI-Provider nutzt, behalte diese Pipelines bei – sie funktionieren weiterhin mit Capgo.
Terminalfenster
npm uninstall @capacitor/live-updates
npm install @capgo/capacitor-updater
npx cap sync

Das war's. Capgo bündelt das native code für iOS und Android; zusätzliche JavaScript-Helfer sind nicht erforderlich.

Schritt 2 – Minimale Konfiguration (keine manuellen Felder)

Abschnitt mit dem Titel „Schritt 2 – Minimale Konfiguration (keine manuellen Felder)“

Der vorhandene Konfigurationsblock ist umfangreich. Capgo erkennt Ihr Projekt und Ihre Kanäle automatisch, daher lautet die minimale Konfiguration:

capacitor.config.ts
import { CapacitorConfig } from '@capacitor/cli'
const config: CapacitorConfig = {
plugins: {
CapacitorUpdater: {
autoUpdate: true,
autoDeletePrevious: true,
},
},
}
export default config
Ionic AppFlow-EinstellungCapgo-ÄquivalentMuss das konfiguriert werden?
appIdVerwaltet im Capgo-DashboardWird beim Erstellen des Projekts automatisch bereitgestellt
channel / defaultChannelChannel-Regeln im Dashboard/APIOptionaler Override; Standardwerte kommen vom Server. Siehe Version-Targeting für Multi-Version-Strategien
autoUpdateMethodautoUpdate: trueStandardmäßig aktiviert
maxVersionsRetention-PolicyZentral konfiguriert (Standard: 1 Monat, max. 24 Monate)
enabledNicht erforderlichCapgo steuert die Verfügbarkeit pro Channel

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

Abschnitt mit dem Titel „Schritt 3 – notifyAppReady() aufrufen (der einzige erforderliche Hook)“

In der Ionic-Anleitung verknüpfst du sync, download, und reload, und blendest den Splash Screen manuell aus. Capgo übernimmt diese Schritte nativ. Du musst nur bestätigen, dass die App bereit ist:

import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()

Falls die Bestätigung nie eintrifft, rollt Capgo das Bundle automatisch zurück.

Das war's schon – Capgo übernimmt die Hintergrundprüfungen, die Sichtbarkeit des Splashscreens und die Rollbacks für dich.

Optional: Logik ausführen, bevor der Splash Screen ausgeblendet wird
import { CapacitorUpdater } from '@capgo/capacitor-updater'
import { SplashScreen } from '@capacitor/splash-screen'
CapacitorUpdater.addListener('appReady', () => {
// Log diagnostics or run custom code if needed
SplashScreen.hide()
})
CapacitorUpdater.notifyAppReady()

AppFlow dokumentiert drei Strategien. So lassen sie sich auf Capgo übertragen:

  • AppFlow: manuell autoUpdateMethod = background, rufe sync() konfigurieren.
  • Capgo: standardmäßig aktiviert. Kein JavaScript erforderlich.
  • AppFlow: hinzufügen App.addListener('resume') Handler, der herunterlädt und neu lädt.
  • Capgo: Auto-Update läuft bereits beim Resume. Füge den Handler nur hinzu, wenn du ein benutzerdefiniertes Zeitfenster möchtest.
Optional: manueller Resume-Check
import { App } from '@capacitor/app'
import { CapacitorUpdater } from '@capgo/capacitor-updater'
App.addListener('resume', async () => {
const bundle = await CapacitorUpdater.download()
if (bundle) {
await CapacitorUpdater.set({ id: bundle.id })
}
})
  • AppFlow: Nutzer abfragen und aufrufen reload().
  • Capgo: das Bundle im Dashboard als „mandatory“ markieren und dann auf das majorAvailable Event (ausgelöst nach notifyAppReady()) um Nutzer in deiner App zu prompten oder zu zwingen.
AppFlow-MethodeCapgo-ÄquivalentBrauchst du das?
LiveUpdates.sync()Automatisch erledigtDas native Auto-Update von Capgo läuft ohne manuellen Sync-Aufruf
LiveUpdates.download()CapacitorUpdater.download()Optional für Custom Flows
LiveUpdates.reload()CapacitorUpdater.set()Optional; Dashboard-Toggles steuern erzwungene Updates
LiveUpdates.getVersion()CapacitorUpdater.current()Optionale Diagnose

Schließe die Migration ab, indem du Bundles mit Capgo CLI oder API hochlädst. Der Workflow entspricht dem, was du zuvor möglicherweise skriptgesteuert ausgeführt hast, enthält jetzt aber native Schutzmechanismen:

Terminalfenster
capgo login # authenticate once
capgo bundle upload \
--path dist \
--channel production # automatically tags platform/version

Wenn du bestimmte native Versionen ansprechen musst (ähnlich wie das native Version Locking in AppFlow):

Terminalfenster
# Only deliver to devices on native version 2.0.0 or higher
# Channel must use metadata strategy: --disable-auto-update metadata
capgo bundle upload \
--path dist \
--channel production \
--min-update-version "2.0.0"
# Use channels for different major versions
capgo bundle upload --channel v2 # for app version 2.x
capgo bundle upload --channel v3 # for app version 3.x

Siehe den Version Targeting Guide für umfassende Strategien.

Capgo übernimmt automatisch:

  • Speichert Audit-Logs auf Geräteebene für jede Installation.
  • Sendet proaktive E-Mails, wenn du dich den Plan-Limits näherst.
  • Bietet Burst-Credits, damit du mitten im Release nie blockiert wirst.
  • Veröffentlicht Latenz-Metriken für 18 globale Regionen unter Status von capgo.app/history.

Falls Ihr Ionic-Stack auch Enterprise-Plugins nutzt, folgen Sie bitte den untenstehenden Migrationsanleitungen. Jeder Guide empfiehlt den passenden Capgo Ersatz sowie die nächsten Schritte.

Ionic stellt kommerzielle Produkte, einschließlich AppFlow, ein, um sich auf sein Open-Source-Framework zu konzentrieren. Bestehende Kunden können Live Updates bis zum 31. Dezember 2027weiterhin nutzen, es werden jedoch keine neuen Funktionen oder Kunden mehr akzeptiert. Capgo schließt diese Lücke mit einer dedizierten nativen OTA-Plattform.

Die meisten Teams schaffen den Umzug in weniger als einem Tag. Konzepte wie Channels, Deployments und Release-Regeln lassen sich direkt übertragen, und unser Team stellt Dokumentation sowie praktische Unterstützung bereit. In vielen Fällen installieren Sie einfach das Plugin und rufen notifyAppReady(), und lade dein erstes Bundle hoch.

Ja. AppFlow Live Updates beginnen bei 499 $/Monat. Capgo beginnt bei 14 $/Monat mit nutzungsbasierter Abrechnung, die auf etwa 0,001 $ pro MAUsinkt. Außerdem erhältst du Verschlüsselung, automatische Rollbacks und weltweite Latenzüberwachung.

Da AppFlow im Wartungsmodus ist, ermöglicht ein früherer Umzug den Zugang zu fortlaufender Capgo-Innovation. Wir empfehlen den Wechsel, wenn er in Ihren Release-Zeitplan passt. Unser Engineering-Team hilft Ihnen bei der Planung des Wechsels, damit Ihre CI/CD-Pipelines und Deployments weiterlaufen.

Capgo wurde für Unternehmen entwickelt, die native Delta-Updates, verschlüsselte Bundles und kontinuierliche Innovation benötigen. Nach der Migration kannst du den AppFlow-Glue-Code code löschen, auf native Automatisierung setzen und ohne Unterbrechung weiter deployen.

Wenn du es nutzt Migration von AppFlow zu Capgo um Migration und Enterprise-Betrieb zu planen, verbinde es mit Capgo Enterprise für den Produkt-Workflow in Capgo Enterprise, Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow in Ionic Enterprise Plugin-Alternativen, Capgo Alternativen für den Produkt-Workflow in Capgo Alternativen, Capgo Beratung für den Produkt-Workflow in Capgo Consulting und Capgo Premium-Support für den Produkt-Workflow in Capgo Premium Support.