Migration von AppFlow zu Capgo

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

Migrationsoverview

Capgo verarbeitet 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.

Versionierung Ziele wie AppFlow

Wenn Sie sich auf die automatische Versionsabstimmung von AppFlow (Kompatibilitätsaktualisierungen auf der Grundlage der nativen Versionsnummer) verlassen haben, bietet Capgo dieselbe Funktion mit erweiterter Kontrolle. Siehe das Versionierung Ziele Guide für detaillierte Strategien zum Verwalten von Aktualisierungen über mehrere Anwendungsversionen.

Schritt 0 – Erfassen Sie Ihre aktuelle AppFlow-Konfiguration

• Notieren Sie Ihre AppFlow-Konfiguration App-ID, bestehende Kanäle und Signatur-Schlüssel.
• Exportieren Sie jede Bundle-Geschichte, die Sie archivieren möchten.
• Wenn Sie GitHub-Aktionen oder einen anderen CI-Anbieter verwenden, behalten Sie diese Pipelines bei – 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-Hilfsmittel sind erforderlich.

Schritt 2 – Minimaler Konfiguration (keine manuellen Felder)

Die bestehende Konfigurationsblock ist umfangreich. Capgo erkennt automatisch Ihr Projekt und Kanäle, sodass die minimale Konfiguration ist:

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	In der Capgo-Oberfläche verwaltet	Automatisch bereitgestellt, wenn Sie das Projekt erstellen
channel / defaultChannel	Kanalregeln in der Oberfläche/API	Optionaler Überschreibung; Standards kommen vom Server. Siehe Version-Zielsetzung für Strategien für mehrere Versionen
autoUpdateMethod	autoUpdate: true	Standardmäßig aktiviert
maxVersions	Rückgabepolitik	Zentral konfiguriert (1 Monat Standard, 24 Monate max)
enabled	Not erforderlich	Capgo steuert die Verfügbarkeit pro Kanal

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, 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 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 aktualisieren

AppFlow beschreibt drei Strategien. Hier ist, wie sie mit Capgo übereinstimmen:

Hintergrund (Standard)

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

Immer aktuell

• AppFlow: Hinzufügen Sie einen App.addListener('resume') Handler, der herunterlädt und neu lädt.
• Capgo: Die automatische Aktualisierung läuft bereits bei Wiederaufnahme auf. Fügen Sie den Handler nur hinzu, wenn Sie eine benutzerdefinierte Zeitfensterzeit 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 })
  }
})

Zwangsaktualisierung

• AppFlow: Benutze bitte und rufe reload().
• Capgo: Markiere das Bundle als „Pflicht“ im Dashboard an, dann höre auf das majorAvailable ereignis (emittiert nach notifyAppReady()) um Benutzer innerhalb deiner App zu bitten oder zu zwingen.

Schritt 5 – Mapping API Aufrufe

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

Schritt 6 – Bereitstellung 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 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)

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 den Richtlinien für Zielversionen 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 nie während einer Veröffentlichung blockiert werden.
• Veröffentlicht Latenzmetriken für 18 globale Regionen bei status.capgo.app/history.

Ionic-Unternehmensplugins

Wenn Ihr Ionic-Stack auch Unternehmens-Plugins verwendet, folgen Sie den unten angegebenen Zielmigration-Dokumenten. 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

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.

Wird uns Geld gespart?

Ja. AppFlow live Updates beginnen bei $499/mo. Capgo beginnt bei $14/mo mit einer Nutzungsbasierten Abrechnung, die auf etwa $0.001 pro MAU sinkt. 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 unterstützt Sie bei der Planung der Änderung, damit Ihre CI/CD- und Bereitstellungsprozesse weiterlaufen.

Zusätzliche Ressourcen

• Leitfaden zur Zielversion - Tiefgang in Strategien zur Versionsabgleichsverfolgung im AppFlow-Stil
• Änderungen - Verwaltung von Updates auf Hauptversionen mit Kanälen
• Kanalverwaltung - Vollständige Referenz zur Kanalkonfiguration

Hilfe benötigen?

• Ein Migrations-Session buchen: book.capgo.app/demo
• Zur Gemeinschaft beitreten: Capgo Discord
• Aufrufe verfolgen / 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-Glue code löschen, auf native Automatisierung vertrauen und ohne Unterbrechung weiterliefern.

Fortsetzen von Migrate from AppFlow zu Capgo

Wenn Sie AppFlow verwenden Fortsetzen von Migrate from AppFlow zu Capgo für die Planung der Migration und Unternehmensoperationen, verbinden Sie es mit Capgo-Unternehmen für den Produktworkflow in Capgo-Unternehmen Alternativen zum Ionic Enterprise Plugin für den Produktworkflow in Alternativen zum Ionic Enterprise Plugin Capgo-Alternativen für den Produktworkflow in Capgo-Alternativen Capgo-Beratung für den Produktworkflow in Capgo-Beratung und Capgo-Premium-Unterstützung für den Produktworkflow in Capgo-Premium-Unterstützung.