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 laufen noch bis 31. Dezember 2027, aber es werden keine neuen Kunden mehr aufgenommen und keine neuen Features mehr geplant. Dieser Guide zeigt dir alle Schritte für die Migration zu Capgo und die Vorteile der nativen Automatisierung.

Migrationsübersicht

Capgo kümmert sich für dich um Channels, Bundle-Aufbewahrung, Rollbacks, Analytics und CLI-Uploads. Die Migration beschränkt sich auf das Installieren des Plugins, den Aufruf CapacitorUpdater.notifyAppReady(), und – falls gewünscht – das Konfigurieren optionaler manueller Steuerungen. Die folgenden Abschnitte gehen jede Aufgabe direkt durch.

Schritt 0 – Aktuelles AppFlow-Setup erfassen

Notiere dein AppFlow App-ID, bestehende Channels und Signing Keys.
Exportiere die Bundle-Historie, die du archivieren möchtest.
Falls du GitHub Actions oder einen anderen CI-Provider nutzt, behalte diese Pipelines bei – sie funktionieren weiterhin mit Capgo.

Schritt 1 – Ersetze das AppFlow SDK durch Capgo

npm uninstall @capacitor/live-updates
npm install @capgo/capacitor-updater
npx cap sync

Das ist alles. Capgo bündelt das native code für iOS und Android; zusätzliche JavaScript-Helper sind nicht erforderlich.

Schritt 2 – Minimale Konfiguration (keine manuellen Felder)

Der bestehende Konfigurationsblock ist sehr umfangreich. Capgo erkennt dein Projekt und deine Channels automatisch, daher ist die minimale Konfiguration:

import { CapacitorConfig } from '@capacitor/cli'

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      autoDeletePrevious: true,
    },
  },
}

export default config

Konfigurations-Quick-Reference

Ionic AppFlow-Einstellung	Capgo Äquivalent	Musst du es setzen?
`appId`	Wird im Capgo Dashboard verwaltet	Wird bei der Projekterstellung 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 – Aufrufen `notifyAppReady()` (der einzige erforderliche Hook)

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

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Wenn 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 übertragen

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

Hintergrund (Standard)

AppFlow: konfigurieren autoUpdateMethod = background, aufrufen sync() manuell.
Capgo: standardmäßig aktiviert. Kein JavaScript erforderlich.

Immer aktuell

AppFlow: einen App.addListener('resume') Handler, der den Download und Reload durchführt.
Capgo: Auto-Update läuft bereits beim Resume. Füge den Handler nur hinzu, wenn du ein eigenes Zeitfenster nutzen 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

AppFlow: den User fragen und aufrufen reload().
Capgo: markiere das Bundle im Dashboard als „mandatory“, um dann auf das majorAvailable Event zu hören (wird nach ... ausgelöst) notifyAppReady()) um Nutzer direkt in deiner App zu prompten oder zu zwingen.

Schritt 5 – Mapping der API Aufrufe

AppFlow Methode	Capgo Äquivalent	Wird es benötigt?
`LiveUpdates.sync()`	Wird automatisch gehandhabt	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 Forced Updates
`LiveUpdates.getVersion()`	`CapacitorUpdater.current()`	Optionale Diagnosen

Schritt 6 – Deployment via Capgo CLI oder API

Schließe die Migration ab, indem du Bundles über Capgo CLI oder API hochlädst. Der Workflow ähnelt deinem bisherigen Skript, bietet aber jetzt native Sicherheitsmechanismen:

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

Versionsspezifische Deployments (wie bei AppFlow)

Wenn du gezielt bestimmte native Versionen ansteuern möchtest (ähnlich dem Native Version Locking von AppFlow):

# 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 die 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 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

Wenn dein Ionic-Stack auch Enterprise Plugins nutzt, folge den passenden Migrations-Docs unten. Jeder Guide empfiehlt den Capgo-Ersatz und die nächsten Schritte.

Häufig gestellte Fragen

Warum stellt AppFlow Live Updates ein?

Ionic stellt kommerzielle Produkte wie AppFlow ein, um sich auf ihr Open-Source-Framework zu konzentrieren. Bestehende Kunden können Live Updates noch bis zum 31. Dezember 2027nutzen, aber es werden keine neuen Features oder Kunden mehr aufgenommen. Capgo schließt diese Lücke mit einer spezialisierten Native OTA-Plattform.

Wie lange dauert die Migration?

Die meisten Teams schließen den Umstieg in weniger als einem Tag ab. Konzepte wie Channels, Deployments und Release Rules lassen sich direkt übertragen, und unser Team bietet Dokumentation sowie direkten Support. In vielen Fällen müssen Sie nur das Plugin installieren, notifyAppReady()aufrufen und Ihr erstes Bundle hochladen.

Können wir Kosten sparen?

Ja. AppFlow Live Updates starten bei $499/Monat. Capgo startet bei $14/Monat mit nutzungsbasierter Preisgestaltung, die auf etwa $0,001 pro MAUsinkt. Zudem profitierst du von Verschlüsselung, automatischen Rollbacks und weltweitem Latency-Monitoring.

Wann sollten wir migrieren?

Da AppFlow sich im Maintenance-Modus befindet, bietet eine frühere Migration Zugang zu stetigen Capgo Innovationen. Wir empfehlen den Wechsel passend zu deinem Release-Plan. Unser Engineering-Team unterstützt dich bei der Planung, damit deine CI/CD-Pipelines und Deployments reibungslos weiterlaufen.

Weitere Ressourcen

Version-Targeting-Guide - Tiefere Einblicke in Version-Matching-Strategien im AppFlow-Stil
Breaking Changes - Major-Version-Updates über Channels verwalten
Channel-Management - Vollständige Referenz zur Channel-Konfiguration

Brauchst du Hilfe?

Buche eine Migrations-Session: book.capgo.app/demo
Werde Teil der Community: 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 löschen, auf native Automatisierung setzen und ohne Unterbrechung weiter releasen.

Weiterlesen: Migration von AppFlow zu Capgo

Wenn Sie ... verwenden Migration von AppFlow zu Capgo Um Migration und Enterprise-Betrieb zu planen, verbinden Sie 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 Consulting für den Produkt-Workflow in Capgo Consulting, und Capgo Premium-Support für den Produkt-Workflow in Capgo Premium Support.