Migrate from AppFlow to Capgo

🚦 Ionic gab bekannt, dass AppFlows kommerzielle Produkte, einschließlich Live-Updates, eingestellt werden. Bestehende Projekte können bis zum 31. Dezember 2027, aber keine neuen Kunden werden akzeptiert und keine neuen Funktionen sind geplant. Diese Anleitung führt Sie durch die erforderlichen Schritte, um auf Capgo zu migrieren, 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 und die Aufrufung CapacitorUpdater.notifyAppReady()und—wenn gewünscht—die optionalen manuellen Kontrolle einrichten. Die folgenden Abschnitte gehen jeden Schritt direkt durch.

Versionziel wie AppFlow

Wenn Sie sich auf AppFlows automatische Versionsabstimmung (Kompatible Updates basierend auf der nativen Version liefern) verlassen haben, bietet Capgo dieselbe Funktion mit erweiterter Kontrolle. Siehe die Versionziel-Leitfaden für detaillierte Strategien zum Verwalten von Updates über mehrere App-Versionen.

Schritt 0 – Erfassen Sie Ihre aktuelle AppFlow-Konfiguration

• Hinweis auf Ihre AppFlow App-ID, bestehende Kanäle und Signaturzertifikate.
• Exportieren Sie alle Bundle-Geschichte, die Sie archivieren möchten.
• Wenn Sie GitHub Actions oder einen anderen CI-Anbieter verwenden, lassen Sie diese Pipelines, sie funktionieren weiterhin mit Capgo.

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-Hilfsfunktionen sind erforderlich.

Schritt 2 – Minimaler Konfiguration (keine manuellen Felder)

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

capacitor.config.ts

import { CapacitorConfig } from '@capacitor/cli'

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

export default config

Konfigurations-Quick-Referenz

Ionische AppFlow-Einstellung	Capgo-Äquivalent	Benötigen Sie eine Einstellung?
appId	Gesteuert im Capgo-Dashboard	Automatisch bereitgestellt, wenn Sie das Projekt erstellen
channel / defaultChannel	Kanalregeln im Dashboard/API	Optionaler Übertrag; Standards kommen vom Server. Siehe Zielversionierung context:Seite/Bereich: Capgo-Lösungen-Marketingseite. Rolle: Abschnitt oder Seiteüberschrift. Gesehen in: Seite Lösungen/Zielversionierung.astro. Nachrichtenschlüssel `solutions_version_targeting_title` (Lösungen-Zielversionierungstitel). | Seite/Bereich: Capgo-Lösungen-Marketingseite. Rolle: Kurze Benutzeroberflächenebene oder Navigationselement. Gesehen in: Seite Lösungen/Zielversionierung.astro. Nachrichtenschlüssel `solutions_version_targeting` (Lösungen-Zielversionierung).
autoUpdateMethod	autoUpdate: true	zur Strategie für mehrere Versionen
maxVersions	Standardmäßig aktiviert	Zentral konfiguriert (1 Monat Standard, 24 Monate max)
enabled	Nicht erforderlich	Capgo schaltet die Verfügbarkeit pro Kanal ein/aus

Schritt 3 – Aufrufen 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 eintritt, Capgo rollt die Bundle automatisch zurück.

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

Optional: Ausführen Sie Logik, bevor die Splash-Schaltfläche sich versteckt

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

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

Hintergrund (Standard)

• AppFlow: konfigurieren autoUpdateMethod = background, aufrufen sync() manuell.
• Capgo: aktiviert durch Standard. Kein JavaScript erforderlich.

Immer aktuell

• AppFlow: fügen Sie ein App.addListener('resume') Händler hinzu, der herunterlädt und neu lädt.
• Capgo: Die automatische Aktualisierung läuft bereits bei der Wiederaufnahme auf. Fügen Sie den Händler nur hinzu, wenn Sie einen benutzerdefinierten Zeitfenster möchten.

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

Zwingende Aktualisierung

• AppFlow: prompt the user and call reload().
• Capgo__CAPGO_KEEP_0__ majorAvailable : markieren Sie das Bundle als „Pflicht“ im Dashboard, dann hören Sie auf das Ereignis (emittiert nach notifyAppReady()) und fordern Sie die Benutzer innerhalb Ihrer App auf oder zwingen Sie sie dazu.

Step 5 – Mapping API calls

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

Führen Sie die Migration ab, indem Sie Pakete mit dem Capgo CLI oder API hochladen. Der Workflow spiegelt das, was Sie möglicherweise vorher geskriptet haben, wider, aber jetzt umfasst 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 Versionsverriegelung):

# 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 Versionsziele für umfassende Strategien.

Capgo automatisch:

• Bewahrt Geräteebene Audit-Protokolle für jeden Installationsvorgang.
• 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 bitte die unten angegebenen Zielmigration-Dokumente. Jeder Leitfaden empfiehlt die Capgo-Ersatzung und die nächsten Schritte.

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

Häufig gestellte Fragen

Wieso schließt AppFlow Live-Updates ab?

Ionic beendet die kommerziellen Produkte, einschließlich AppFlow, um sich auf ihr Open-Source-Framework zu konzentrieren. Bestehende Kunden können Live-Updates bis zum 31. Dezember 2027, 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 Umzug in weniger als einen Tag. Konzepte wie Kanäle, Bereitstellungen und Freigaberegeln 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.

Wird uns Geld gespart?

Ja. AppFlow live Updates beginnen bei $499/mo. Capgo beginnt bei $14/mo mit einer Nutzungsbasierten Preisgestaltung, die 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 planen, 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

• Versionierungsziel-Leitfaden - Tiefere Einführung in Strategien zur Versionsübereinstimmung im AppFlow-Stil
• Veränderungen mit Auswirkungen auf die Kompatibilität - Verwaltung von Updates auf Hauptversionen mit Kanälen
• Kanalverwaltung - Vollständige Referenz zur Kanal-Konfiguration

Benötigen Sie Hilfe?

• Buchen Sie eine Migrationsitzung: book.capgo.app/demo
• Joinen Sie sich der Gemeinschaft: Capgo Discord
• Verfolgen Sie Probleme / fordern Sie Funktionen an: 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-Glase code löschen, sich auf native Automatisierung verlassen und ohne Unterbrechung weiterliefern.

Fortsetzen Sie von Migrate from AppFlow zu Capgo

Wenn Sie AppFlow verwenden Migrate from AppFlow to Capgo zum Planen der Migration und Unternehmensoperationen, verbinden Sie es mit Capgo Enterprise für den Produktworkflow in Capgo Enterprise, Ionic Enterprise Plugin Alternativen für das 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.