Migrieren Sie von AppFlow zu Capgo
Eine Setup-Vorlage mit den Installationsanweisungen und der vollständigen Markdown-Dokumentation für diesen Plugin kopieren.
🚦 Ionic gab bekannt, dass AppFlows kommerzielle Produkte, 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
Abschnitt mit dem Titel „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 direkt auf jeden Schritt ein.
Schritt 0 – Erfassen Sie Ihre aktuelle AppFlow-Konfiguration
Abschnitt mit dem Titel ‘Schritt 0 – Erfassen Sie Ihre aktuelle AppFlow-Konfiguration’- Hinweis auf Ihre AppFlow App-IDexistierende Kanäle und Signaturschlüssel.
- Exportieren Sie alle Bundle-Historien, die Sie archivieren möchten.
- If Sie GitHub Actions 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
Abschnitt mit dem Titel „Schritt 1 – Ersetzen Sie den AppFlow SDK durch Capgo“npm uninstall @capacitor/live-updatesnpm install @capgo/capacitor-updaternpx cap syncDas 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)
Abschnitt mit dem Titel „Schritt 2 – Minimaler Konfiguration (keine manuellen Felder)“Die bestehende Konfigurationsblöcke sind umfangreich. Capgo detektiert automatisch Ihr Projekt und Kanäle, sodass die minimale Konfiguration ist:
import { CapacitorConfig } from '@capacitor/cli'
const config: CapacitorConfig = { plugins: { CapacitorUpdater: { autoUpdate: true, autoDeletePrevious: true, }, },}
export default configKonfigurations-Quick-Referenz
Abschnitt mit dem Titel “Konfigurations-Quick-Referenz”| Ionics 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 | Optional überlagert; Standards kommen vom Server. Siehe Zielversionierung zur Unterstützung mehrerer Versionsstrategien |
autoUpdateMethod | autoUpdate: true | Standardmäßig aktiviert |
maxVersions | Rückhalteregel | Zentral konfiguriert (1 Monat Standard, 24 Monate max.) |
enabled | Nicht erforderlich | Capgo schaltet die Verfügbarkeit pro Kanal ein/aus |
Schritt 3 – Aufruf notifyAppReady() Der einzige erforderliche Hook
Abschnitt mit dem Titel "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, Capgo rollt die Bundle automatisch zurück.
Das ist es – Capgo übernimmt die Hintergrundprüfungen, die Splash-Sichtbarkeit und die Rollbacks für Sie.
Optional: Ausführen von Logik vor dem Verstecken 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
Sektion mit Titel “Schritt 4 – Strategien aktualisiert”AppFlow beschreibt drei Strategien. Hier ist, wie sie sich zu Capgo mappen:
Hintergrund (Standard)
Sektion mit Titel “Hintergrund (Standard)”- AppFlow: konfigurieren
autoUpdateMethod = background, aufrufensync()manuell. - Capgo: aktiviert durch Standard. Kein JavaScript erforderlich.
Immer aktuell
Abschnitt mit dem Titel „Immer aktuell“- AppFlow: fügen Sie ein
App.addListener('resume')Handler hinzu, 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 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 }) }})Zwangsaktualisierung
Abschnitt mit dem Titel „Zwangsaktualisierung“- AppFlow: den Benutzer auffordern und aufrufen
reload(). - : Capgo: Das Bundle als "Pflicht" im Dashboard markieren, dann auf das Ereignis (emittiert nach ) lauschen, um den Benutzern innerhalb Ihrer App zu promptieren oder sie zwingen zu lassen.
majorAvailableSchritt 5 – Mapping von __CAPGO_KEEP_0__ AufrufennotifyAppReady()Schritt 5 – Mapping von __CAPGO_KEEP_0__ Aufrufen
Step 5 – Mapping API calls
API-Äquivalent| Benötigen Sie es? | Capgo equivalent | __CAPGO_KEEP_0__ |
|---|---|---|
LiveUpdates.sync() | : den Benutzer auffordern und aufrufen | 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
Sektion mit dem Titel „Schritt 6 – Bereitstellung mit dem Capgo CLI oder API“Beenden Sie die Migration, 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 oncecapgo bundle upload \ --path dist \ --channel production # automatically tags platform/versionVersionsspezifische Bereitstellungen (wie AppFlow)
Sektion mit dem Titel „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 metadatacapgo bundle upload \ --path dist \ --channel production \ --min-update-version "2.0.0"
# Use channels for different major versionscapgo bundle upload --channel v2 # for app version 2.xcapgo bundle upload --channel v3 # for app version 3.xSiehe das Leitfaden zur Zielversion 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
Abschnitt mit dem Titel “Ionic-Unternehmensplugins”Wenn Ihr Ionic-Stack auch Unternehmensplugins verwendet, folgen Sie den unten aufgeführten migrierten Anleitungen. 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
Abschnitt mit dem Titel “Häufig gestellte Fragen”Wieso schließt AppFlow Live-Updates ab?
Abschnitt mit dem Titel “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 einer dedizierten nativen OTA-Plattform.
How lange dauert die Migration?
Abschnitt mit dem Titel “Wie lange dauert die Migration?”Die meisten Teams schaffen den Umzug in weniger als einen 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 Sie __CAPGO_KEEP_0__ auf und laden Sie Ihr erstes Bundle hoch. notifyAppReady()Werden wir Geld sparen?
Abschnitt mit dem Titel “Werden wir Geld sparen?”
Ja. AppFlow live Updates beginnen bei499 $/Monat . __CAPGO_KEEP_0__ beginnt bei. Capgo starts at mit einer Nutzungsbasierten Preismodell, das auf etwa 0,001 $/MAU $499/moSie erhalten auch Verschlüsselung, automatische Rollbacks und weltweite Latenzüberwachung.
Wann sollten wir migrieren?
Abschnitt mit dem Titel “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
Abschnitt mit dem Titel “Zusätzliche Ressourcen”- Zielgruppenorientierte Versionen - Tiefere Einführung in Strategien zur Versionsabstimmung im AppFlow-Stil
- Änderungen - Verwaltung von Updates auf Hauptversionen mit Kanälen
- Kanalverwaltung - Vollständige Referenz für die Kanalkonfiguration
Benötigen Sie Hilfe?
Abschnitt mit der Überschrift “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, auf native Automatisierung vertrauen und ohne Unterbrechung weiterliefern.
Fortsetzen Sie von Migrate from AppFlow zu Capgo
Abschnitt mit der Überschrift “Fortsetzen Sie von Migrate from AppFlow zu Capgo”Wenn Sie AppFlow verwenden Migrate from AppFlow to Capgo zum Plan der Migration und der 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 das 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.