Migrieren Sie von AppFlow zu Capgo

🚦 Ionic gab bekannt, 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 verwalten Sie 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 Steuerungen. Die Abschnitte unten gehen auf jeden Auftrag direkt ein.

Versionziel wie AppFlow

Wenn Sie sich auf AppFlows automatische Versionsanpassung (Kompatibilitätsaktualisierungen auf der Grundlage der nativen Version) verlassen haben, bietet Capgo dieselbe Funktion mit erweiterter Kontrolle. Siehe die Versionziel-Anleitung zur detaillierten Strategie zur Verwaltung von Updates über mehrere App-Versionen.

Schritt 0 – Erfassen Sie Ihre aktuelle AppFlow-Konfiguration

• Notieren Sie Ihre AppFlow-Konfiguration App-ID, bestehende Kanäle und Signaturschlüssel.
• Exportieren Sie alle Bundle-Geschichte, die Sie archivieren möchten.
• Wenn Sie GitHub-Aktionen oder einen anderen CI-Anbieter verwenden, behalten Sie diese Pipelines bei – sie werden weiterhin mit Capgo funktionieren.

Schritt 1 – Ersetzen Sie die AppFlow-Konfiguration SDK durch Capgo

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

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

Schritt 2 – Minimal-Konfiguration (keine manuellen Felder)

Die bestehende Konfigurationsblock ist umfangreich. Capgo detektiert automatisch Ihr Projekt und Kanäle, daher ist die Minimal-Konfiguration:

capacitor.config.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	Kanalregeln im Dashboard/API	Optionaler Vorrang; Standards kommen vom Server. Siehe Zielgruppenerfassung für Strategien für mehrere Versionen
autoUpdateMethod	autoUpdate: true	Standardmäßig aktiviert
maxVersions	Rückhalteregelung	Zentral konfiguriert (1 Monat Standard, 24 Monate max)
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 eintritt, führt Capgo den Bundle zurück automatisch.

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

Optional: Ausführen von 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 – Strategien übersetzt

AppFlow dokumentiert drei Strategien. Hier ist, wie sie sich auf Capgo abbilden:

Hintergrund (Standard)

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

Immer aktuell

• AppFlow: fügen Sie einen App.addListener('resume') Handler hinzu, der herunterlädt und neu lädt.
• Capgo: auto-update läuft bereits bei Wiederaufnahme. Fügen Sie den Handler nur hinzu, wenn Sie ein benutzerdefiniertes 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 })
  }
})

Zwangsupdate

• AppFlow: fragen Sie den Benutzer und rufen Sie reload().
• Capgo: markieren Sie das Bundle als „Pflicht“ im Dashboard und hören Sie dann auf das majorAvailable ereignis (emittiert nach notifyAppReady())

Schritt 5 – Zuweisung von API Aufrufen

AppFlow-Methode	Capgo-Äquivalent	Braucht es es?
LiveUpdates.sync()	Wird automatisch bearbeitet	Capgo’s native Auto-Update läuft ohne manuelle Synchronisierungskall
LiveUpdates.download()	CapacitorUpdater.download()	Optional für benutzerdefinierte Flüsse
LiveUpdates.reload()	CapacitorUpdater.set()	Optional; Dashboard-Toggle handhaben gezwungene Updates
LiveUpdates.getVersion()	CapacitorUpdater.current()	Optional Diagnose

Schritt 6 – Bereitstellung mit dem Capgo CLI oder API

Beenden Sie die Migration, indem Sie die Dateien mit den Capgo CLI oder API hochladen. Der Workflow spiegelt das, was Sie möglicherweise vorher geschrieben 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)

Terminal-Fenster

# 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

Version-Targeting-Leitfaden für umfassende Strategien. __CAPGO_KEEP_0__ wird automatisch:

Capgo automatically:

• 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_KEEP_0__.app/history". status.capgo.app/history.

Abschnitt mit dem Titel „Ionic-Unternehmensplugins“

If your Ionic stack also uses enterprise plugins, follow the targeted migration docs below. Each guide recommends the Capgo replacement and the next steps.

• Migrieren Sie von Ionic Auth Connect
• Migrieren Sie von Ionic Identity Vault
• Häufig gestellte Fragen

Häufig gestellte Fragen

Warum schließt AppFlow die 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 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 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.

Werden wir Geld sparen?

Ja. AppFlow live Updates beginnen bei $499/mo. Capgo beginnt bei $14/mo mit einer Nutzungsabhängigen Preisgestaltung, die auf etwa $0.001 pro MAUsinkt. 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 die laufende Capgo-Innovation. Wir empfehlen, den Wechsel zu planen, wenn es Ihrem Release-Schema entspricht. Unser Ingenieursteam wird Ihnen helfen, den Wechsel so zu planen, dass Ihre CI/CD und Ihre Bereitstellungen weiterlaufen.

Zusätzliche Ressourcen

• Versionziel-Leitfaden - Tiefere Einführung in Strategien zur Versionsabgleichsverfolgung nach AppFlow-Stil
• Änderungen im Hinblick auf die Kompatibilität - Verwalten von Updates auf Hauptversionen mit Kanälen
• Kanalverwaltung - Vollständige Referenz zur Kanalkonfiguration

Hilfe benötigt?

• Buchen Sie eine Migrations-Sitzung: book.capgo.app/demo
• Teilen Sie sich der Gemeinschaft an: Capgo Discord
• [Track issues / request features:] 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 setzen und ohne Unterbrechung weiterliefern.

Weitermachen von AppFlow zu Capgo

Wenn Sie AppFlow zu Capgo migrieren um die Migration und die Unternehmensoperationen zu planen und zu verbinden, 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 Beratung, und Capgo Premium Support für den Produktworkflow in Capgo Premium Support.