Migration von AppFlow zu Capgo
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
🚦 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.
Migrationsübersicht
Abschnitt mit dem Titel „Migrationsübersicht“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.
Schritt 0 – Dein aktuelles AppFlow-Setup erfassen
Abschnitt mit dem Titel „Schritt 0 – Dein aktuelles AppFlow-Setup erfassen“- 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.
Schritt 1 – Ersetze AppFlow SDK durch Capgo
Abschnitt mit dem Titel „Schritt 1 – Ersetze AppFlow SDK durch Capgo“npm uninstall @capacitor/live-updatesnpm install @capgo/capacitor-updaternpx cap syncDas 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:
import { CapacitorConfig } from '@capacitor/cli'
const config: CapacitorConfig = { plugins: { CapacitorUpdater: { autoUpdate: true, autoDeletePrevious: true, }, },}
export default configKonfigurations-Schnellreferenz
Abschnitt mit dem Titel „Konfigurations-Schnellreferenz“| Ionic AppFlow-Einstellung | Capgo-Äquivalent | Muss das konfiguriert werden? |
|---|---|---|
appId | Verwaltet im Capgo-Dashboard | Wird beim Erstellen des Projekts automatisch bereitgestellt |
channel / defaultChannel | Channel-Regeln im Dashboard/API | Optionaler Override; Standardwerte kommen vom Server. Siehe Version-Targeting für Multi-Version-Strategien |
autoUpdateMethod | autoUpdate: true | Standardmäßig aktiviert |
maxVersions | Retention-Policy | Zentral konfiguriert (Standard: 1 Monat, max. 24 Monate) |
enabled | Nicht erforderlich | Capgo 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()Schritt 4 – Update-Strategien
Abschnitt mit dem Titel „Schritt 4 – Update-Strategien“AppFlow dokumentiert drei Strategien. So lassen sie sich auf Capgo übertragen:
Hintergrund (Standard)
Abschnitt mit dem Titel „Hintergrund (Standard)“- AppFlow: manuell
autoUpdateMethod = background, rufesync()konfigurieren. - Capgo: standardmäßig aktiviert. Kein JavaScript erforderlich.
Immer aktuell
Abschnitt mit dem Titel „Immer aktuell“- 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 }) }})Force Update
Abschnitt mit dem Titel „Force update“- AppFlow: Nutzer abfragen und aufrufen
reload(). - Capgo: das Bundle im Dashboard als „mandatory“ markieren und dann auf das
majorAvailableEvent (ausgelöst nachnotifyAppReady()) um Nutzer in deiner App zu prompten oder zu zwingen.
Schritt 5 – Mapping der API-Aufrufe
Abschnitt mit dem Titel „Schritt 5 – Mapping der API-Aufrufe“| AppFlow-Methode | Capgo-Äquivalent | Brauchst du das? |
|---|---|---|
LiveUpdates.sync() | Automatisch erledigt | Das 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 |
Schritt 6 – Deployment über Capgo CLI oder API
Abschnitt mit dem Titel „Schritt 6 – Deployment mit Capgo CLI oder API“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:
capgo login # authenticate oncecapgo bundle upload \ --path dist \ --channel production # automatically tags platform/versionVersionsspezifische Deployments (wie bei AppFlow)
Abschnitt mit dem Titel „Versionsbezogene Deployments (wie bei AppFlow)“Wenn du bestimmte native Versionen ansprechen musst (ähnlich wie das native Version Locking in AppFlow):
# Only deliver to devices on native version 2.0.0 or higher# Channel must use metadata strategy: --disable-auto-update metadatacapgo bundle upload \ --path dist \ --channel production \ --min-update-version "2.0.0"
# Use channels for different major versionscapgo bundle upload --channel v2 # for app version 2.xcapgo bundle upload --channel v3 # for app version 3.xSiehe 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.
Ionic Enterprise Plugins
Abschnitt mit dem Titel „Ionic Enterprise Plugins“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.
- Migration von Ionic Secure Storage
- Migration von Ionic Auth Connect
- Migration von Ionic Identity Vault
Häufig gestellte Fragen
Abschnitt mit dem Titel „Häufig gestellte Fragen“Warum stellt AppFlow Live Updates ein?
Abschnitt mit dem Titel „Warum stellt AppFlow Live Updates ein?“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.
Wie lange dauert die Migration?
Abschnitt mit dem Titel „Wie lange dauert die Migration?“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.
Können wir Kosten sparen?
Abschnitt mit dem Titel „Wird das Geld sparen?“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.
Wann sollten wir migrieren?
Abschnitt mit dem Titel „Wann sollten wir migrieren?“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.
Weitere Ressourcen
Abschnitt „Zusätzliche Ressourcen“- Guide zur Versionszielung - Vertiefte Analyse von AppFlow-artigen Versionsmatch-Strategien
- Breaking Changes - Verwaltung von Major-Version-Updates mit Channels
- Channel-Management - Vollständige Referenz zur Channel-Konfiguration
- Migrationssitzung buchen: book.capgo.app/demo
- Der Community beitreten: Capgo Discord
- Issues melden / Features anfragen: github.com/Cap-go/capacitor-updater
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.
Weiterlesen: Migration von AppFlow zu Capgo
Abschnitt mit dem Titel „Weiterlesen: Migration von AppFlow zu Capgo“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.