Migration von AppFlow zu Capgo

🚦 Ionic gab bekannt, dass AppFlow's kommerzielle Produkte, einschließlich Live-Updates, bis Ende 2027 laufen werden. Bestehende Projekte können bis zum 31. Dezember 2027laufen, aber keine neuen Kunden werden akzeptiert und keine neuen Funktionen sind geplant. Diese Anleitung führt Sie durch die erforderlichen Schritte zur Migration zu Capgo und hebt die native Automatisierung hervor, die Sie gewinnen.

Migrationsübersicht

Capgo verwalten Kanäle, Bundle-Retention, Rollbacks, Analytics und CLI-Uploads für Sie. Die Migration reduziert sich auf die Installation des Plugins, die Aufrufung von CapacitorUpdater.notifyAppReady(), und – wenn gewünscht – die Konfiguration optionaler manueller Steuerungen. Die folgenden Abschnitte gehen auf jeden Schritt direkt ein.

Versionziel wie AppFlow

Wenn Sie sich auf AppFlows automatische Versionsanpassung (Kompatibilitätsaktualisierungen basierend auf der nativen Version) verlassen haben, bietet Capgo dieselbe Funktion mit erweiterter Kontrolle. Siehe die Versionziel-Leitfaden Versionziel-Leitfaden

Schritt 0 – Erfassen Sie Ihre aktuelle AppFlow-Konfiguration

• Haben Sie sich Ihre AppFlow-Konfiguration notiert App-IDexistierende Kanäle und Signatur-Schlüssel.
• Exportieren Sie alle Bundle-Historien, die Sie archivieren möchten.
• Wenn Sie GitHub Actions oder einen anderen CI-Anbieter verwenden, behalten Sie diese Pipelines bei – sie werden mit Capgo weiterhin funktionieren.

Schritt 1 – Ersetzen Sie den AppFlow SDK durch Capgo

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

Das ist alles. Capgo verpackt die nativen code für beide iOS und Android; keine zusätzlichen JavaScript-Hilfsmittel sind erforderlich.

Schritt 2 – Minimaler Konfiguration (keine manuellen Felder)

Die bestehende Konfigurationsblöcke sind umfangreich. Capgo detektiert automatisch Ihr Projekt und Kanäle, daher ist die minimale Konfiguration:

capacitor.Konfiguration.ts

import { CapacitorConfig } from '@capacitor/cli'

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

export default config

Konfigurations-Quick-Referenz

Ionic AppFlow-Einstellung	Capgo-Äquivalent	Müssen Sie es einstellen?
appId	Verwaltet im Capgo-Dashboard	Automatisch bereitgestellt, wenn Sie das Projekt erstellen
channel / defaultChannel	Kanalregeln im Dashboard/API	Optional überschreiben; Standards kommen vom Server. Siehe Zielversionierung Für Strategien mit mehreren Versionen
autoUpdateMethod	autoUpdate: true	Standardmäßig aktiviert
maxVersions	Rückgabepolitik	Zentral konfiguriert (1 Monat Standard, max. 24 Monate)
enabled	Keine Anforderung	Capgo schaltet die Verfügbarkeit pro Kanal ein

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

In Ions Anleitung verbinden Sie sync, download, und reload, dann verbergen Sie die Splash-Schaltfläche manuell. Capgo führt diese Aktionen nativ durch. Sie müssen nur bestätigen, dass die App bereit ist:

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

CapacitorUpdater.notifyAppReady()

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

Das ist alles—Capgo übernimmt die Hintergrundprüfungen, die Sichtbarkeit des Splash-Screens und die Rollbacks für dich.

Optional: Ausführung von Logik vor dem Verschwinden des Splash-Screens

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 – Strategien aktualisiert

AppFlow dokumentiert drei Strategien. Hier ist, wie sie sich zu Capgo mappen:

Hintergrund (Standard)

• AppFlow: konfigurieren autoUpdateMethod = backgroundrufen Sie an sync() manuell.
• CapgoImmer aktuell

Abschnitt mit dem Titel „Immer aktuell“

• : Hinzufügen Sie einenHandler, der herunterlädt und neu lädt. App.addListener('resume') __CAPGO_KEEP_0__
• CapgoOptional: Manuelle Wiederaufnahmeprobe

Optional: Manuelle Wiederaufnahmeprobe

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

Zwangsaktualisierung

• AppFlow: fordert den Benutzer auf und ruft reload().
• Capgo: markiert das Bundle als „Pflicht“ im Dashboard an, dann hört man auf das majorAvailable Ereignis (emittiert nach notifyAppReady()) und fordert oder zwingt Benutzer innerhalb Ihrer App auf.

Schritt 5 – Zuweisung von API-Aufrufen

AppFlow-Methode	Capgo Äquivalent	Brauchen Sie es?
LiveUpdates.sync()	Wird automatisch bearbeitet	Capgo’s native auto-update läuft ohne manuelle Synchronisierungsauforderung
LiveUpdates.download()	CapacitorUpdater.download()	Optional für benutzerdefinierte Flüsse
LiveUpdates.reload()	CapacitorUpdater.set()	Optional; Dashboard-Schalter handhaben gezwungene Updates
LiveUpdates.getVersion()	CapacitorUpdater.current()	Optional Diagnose

Schritt 6 – Bereitstellen mit dem Capgo CLI oder API

Beenden Sie die Migration, indem Sie Bundles mit dem Capgo CLI oder API hochladen. Der Workflow spiegelt das, was Sie möglicherweise vorher geskriptet haben, wider, aber jetzt enthält er native Sicherheitsvorkehrungen:

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

Version-spezifische Bereitstellungen (wie AppFlow)

Wenn Sie spezifische native Versionen ansteuern müssen (ähnlich wie AppFlows native Versionssperre):

# Only deliver to devices on native version 2.0.0 or higher
capgo bundle upload \
  --path dist \
  --channel production \
  --native-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 das Version-Targeting-Leitfaden zur umfassenden Strategie.

Capgo automatisch:

• Hält Geräteebene Audit-Protokolle für jeden Installationsvorgang auf.
• Sendet proaktive E-Mails, wenn Sie die Grenzen Ihres Plans erreichen.
• Bietet Burst-Kredite, damit Sie während der Veröffentlichung nicht blockiert werden.
• Veröffentlicht Latenzmetriken für 18 globale Regionen bei status.capgo.app/history.

Ionic-Unternehmensplugins

Wenn Ihr Ionic-Stack auch Unternehmensplugins verwendet, folgen Sie den unten angegebenen Zielmigration-Dokumenten. Jeder Leitfaden empfiehlt die Capgo-Ersatzung und die nächsten Schritte.

• Migrieren von Ionic Secure Storage
• Migrieren von Ionic Auth Connect
• Migrieren von Ionic Identity Vault

Häufig gestellte Fragen

Warum schließt AppFlow live Updates ab?

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

Wie lange dauert die Migration?

Die meisten Teams schaffen den Umzug in weniger als einen Tag. Konzepte wie Kanäle, Bereitstellungen und Freigabe-Regeln werden direkt übersetzt, und unser Team bietet Dokumentation sowie persönliche Unterstützung. In vielen Fällen installieren Sie einfach den Plugin, rufen notifyAppReady()auf und laden Ihre erste Bundle hoch.

Können wir Geld sparen?

Ja. AppFlow-Live-Updates beginnen bei $499/mo. Capgo beginnt bei $14/mo mit einer Nutzungsabhängigen Preismodell, das sich auf etwa $0.001 pro MAU. Sie erhalten auch Verschlüsselung, automatische Rollbacks und weltweite Latenzüberwachung.

Wann sollten wir migrieren?

Da AppFlow nun in der Wartungsphase ist, bietet eine frühere Migration Zugriff auf laufende Capgo Innovationen. Wir empfehlen, den Wechsel zu machen, wenn es Ihrem Release-Schema entspricht. Unser Ingenieursteam hilft Ihnen bei der Planung der Änderung, damit Ihre CI/CD- und Bereitstellungsprozesse weiterlaufen.

Zusätzliche Ressourcen

• Leitfaden zur Zielversion - Tiefere Einführung in Strategien zur Versionsabgleichsverfahren nach AppFlow-Stil
• Veränderungen im Laufe der Zeit - Majorversion-Updates mit Kanälen verwalten
• Kanalverwaltung - Vollständige Referenz zur Kanalkonfiguration

Hilfe benötigen?

• Ein Migrationsworkshop buchen: book.capgo.app/demo
• Zur Community beitreten: Capgo Discord
• Fehler melden / Funktionen anfordern: github.com/Cap-go/capacitor-updater

Capgo ist für Unternehmen entwickelt, die native Delta-Updates, verschlüsselte Pakete und ständige Innovation benötigen. Sobald Sie migriert haben, können Sie das AppFlow-Verbindungsstück code löschen, auf native Automatisierung vertrauen und ohne Unterbrechung weiterliefern.

Weitermachen von Migrate von AppFlow zu Capgo

Wenn Sie AppFlow verwenden Migrate von AppFlow zu Capgo um die Migration und die Unternehmensoperationen zu planen und zu verbinden, Capgo Enterprise für den Produktworkflow in Capgo Enterprise Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen Capgo Alternativen für den Produktworkflow in Capgo Alternativen Capgo Consulting für den Produktworkflow in Capgo Consulting und Capgo Premium Support für den Produktworkflow in Capgo Premium Support.