Migrate from AppFlow to Capgo

🚦 Ionic hat bekannt gegeben, dass die kommerziellen Produkte von AppFlow, einschließlich Live Updates, eingestellt 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 verwalte 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 von optionalen manuellen Kontrollen. Die Abschnitte unten gehen direkt auf jeden Auftrag ein.

Version-Zielsetzung wie bei AppFlow

Wenn Sie sich auf AppFlows automatische Versionsanpassung (Kompatibilitätsaktualisierungen basierend auf nativer Version) verlassen haben, bietet Capgo dieselbe Funktion mit erweiterter Kontrolle. Siehe die Version-Zielsetzungsanleitung Für detaillierte Strategien zum Verwalten von Updates über mehrere App-Versionen.

Schritt 0 – Erfassen Sie Ihre aktuelle AppFlow-Konfiguration

• Hinweis auf AppFlow App-IDbestehende Kanäle und Signaturschlü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 funktionieren weiterhin mit Capgo.

Schritt 1 – Ersetzen Sie die AppFlow SDK durch Capgo

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

Das ist alles. Capgo verpackt die native 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	Muss es gesetzt werden?
appId	Verwaltet im Capgo-Dashboard	Automatisch bereitgestellt, wenn Sie das Projekt erstellen
channel / defaultChannel	Channel rules in the dashboard/API	Optionaler Übertrag; Standards kommen vom Server. Siehe Versionen anpassen für Mehrfach-Versionen-Strategien
autoUpdateMethod	autoUpdate: true	Versionen anpassen
maxVersions	für Strategien mit mehreren Versionen	Eingerichtet zentral (1 Monat Standard, max. 24 Monate)
enabled	Rückgabepolitik	Capgo aktiviert die Verfügbarkeit pro Kanal

nicht erforderlich notifyAppReady() __CAPGO_KEEP_0__ schaltet die Verfügbarkeit pro Kanal ein/aus

Im Leitfaden von Ionic verdrahten 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 eintritt, Capgo rollt die Bundle automatisch zurück.

Das ist alles—Capgo übernimmt die Hintergrundprüfungen, die Sichtbarkeit der Splash-Schaltfläche und die Rollbacks für Sie.

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

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 – Aktualisierungsstrategien übersetzt

Die AppFlow-Dokumente beschreiben drei Strategien. Hier ist, wie sie sich auf Capgo abbilden:

Hintergrund (Standard)

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

Immer aktuell

• AppFlow: hinzufügen App.addListener('resume') Handler, der herunterlädt und neu lädt.
• Capgo: Auto-Update läuft bereits bei Wiedereinsteigen. Fügen Sie den Handler nur hinzu, wenn Sie eine benutzerdefinierte Zeitfensterzeit möchten.

Zur Zwischenablage kopieren

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

Zwangsupdate

• AppFlow: fragen Sie den Benutzer und rufen Sie reload().
• CapgoMelden Sie das Bundle als „verpflichtend“ im Dashboard an, dann hören Sie auf das Ereignis. majorAvailable Wiederanlaufprüfung notifyAppReady()) um Benutzer innerhalb Ihrer App aufzufordern oder zu zwingen.

Schritt 5 – Zuordnen von API-Aufrufen

AppFlow-Methode	Capgo-Äquivalent	Benötigen Sie es?
LiveUpdates.sync()	Automatisch bearbeitet	Capgo-native Auto-Update läuft ohne manuelle Synchronisierungsaufgabe
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 – Bereitstellung mit der Capgo CLI oder API

Beenden Sie die Migration, indem Sie Pakete mit dem Capgo CLI oder API hochladen. Der Workflow spiegelt das, was Sie 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

Versionsspezifische 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
# 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 das Leitfaden für Versionenziel zur umfassenden Strategie.

Capgo automatisch:

• Behä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/Geschichte.

Ionische Unternehmensplugins

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

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

Fragen und Antworten

Warum schließt AppFlow Live-Updates ab?

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

Wie lange dauert die Migration?

Die meisten Teams schaffen den Wechsel in weniger als einem Tag. Konzepte wie Kanäle, Bereitstellungen und Release-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()und laden Ihr erstes Bundle hoch.

Können wir Geld sparen?

Ja. AppFlow-Live-Updates beginnen bei $499/mo. Capgo beginnt bei 14 $/Monat with usage-based pricing that drops to roughly $0.001 pro MAUsenkt. Sie erhalten außerdem Verschlüsselung, automatische Rollbacks und weltweite Latenzüberwachung.

Wann sollten wir migrieren?

Da AppFlow nun in der Wartungsphase ist, gibt es durch eine frühere Migration Zugriff auf die laufende Capgo-Innovation. Wir empfehlen, den Wechsel zu planen, wenn es in Ihrem Release-Schema passt. Unser Engineering-Team hilft Ihnen bei der Planung der Änderung, damit Ihre CI/CD- und Deployments weiterhin reibungslos laufen.

Zusätzliche Ressourcen

• Versionziel-Leitfaden - Tiefere Einführung in Strategien zur Versionsübereinstimmung im AppFlow-Stil
• Folgende Änderungen - Verwaltung von Updates auf Hauptversionsebene mit Kanälen
• Kanalverwaltung - Vollständige Referenz zur Kanalkonfiguration

Need help?

• Abschnitt mit dem Titel “Brauchen Sie Hilfe?” buch.capgo.app/demo
• book.__CAPGO_KEEP_0__.app/demo Capgo Discord
• Probleme verfolgen / Funktionen anfragen: 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 die AppFlow-Verbindung code löschen, auf native Automatisierung vertrauen und ohne Unterbrechung weiterliefern.

Fortfahren von Migrate from AppFlow zu Capgo

Wenn Sie Appflow verwenden Migrate from AppFlow zu Capgo zum Plan der Migration und Unternehmensoperationen, verbinden Sie es mit 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 Beratung Für den Produktworkflow in Capgo Consulting und Capgo Premium Support Für den Produktworkflow in Capgo Premium Support.