Migrazione da AppFlow a Capgo
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
🚦 Ionic ha annunciato che i prodotti commerciali di AppFlow—inclusi Live Updates—verranno dismessi. I progetti esistenti potranno continuare fino al 31 dicembre 2027, ma non verranno accettati nuovi clienti e non sono previste nuove funzionalità. Questa guida illustra i passaggi necessari per migrare a Capgo e mette in evidenza l'automazione nativa che ottieni.
Panoramica della migrazione
Sezione intitolata “Panoramica della migrazione”Capgo gestisce per te canali, retention dei bundle, rollback, analytics e l'upload di CLI. La migrazione consiste nell'installare il plugin e chiamare CapacitorUpdater.notifyAppReady(), e—se lo desideri—configurare i controlli manuali opzionali. Le sezioni seguenti illustrano ogni attività nel dettaglio.
Passaggio 0 – Annota il tuo setup AppFlow attuale
Sezione intitolata “Passaggio 0 – Annota il tuo setup AppFlow attuale”- Prendi nota del tuo AppFlow ID dell'app, dei canali esistenti e delle chiavi di firma.
- Esporta la cronologia dei bundle che desideri archiviare.
- Se utilizzi GitHub Actions o un altro provider CI, mantieni quelle pipeline: continueranno a funzionare con Capgo.
Passaggio 1 – Sostituisci la SDK di AppFlow con Capgo
Sezione intitolata “Passaggio 1 – Sostituisci la SDK di AppFlow con Capgo”npm uninstall @capacitor/live-updatesnpm install @capgo/capacitor-updaternpx cap syncFatto. Capgo include i code nativi sia per iOS che per Android; non servono helper JavaScript aggiuntivi.
Passaggio 2 – Configurazione minima (senza campi manuali)
Sezione intitolata “Passo 2 – Configurazione minima (senza campi manuali)”Il blocco di configurazione esistente è molto esteso. Capgo rileva automaticamente progetto e canali, quindi la configurazione minima è:
import { CapacitorConfig } from '@capacitor/cli'
const config: CapacitorConfig = { plugins: { CapacitorUpdater: { autoUpdate: true, autoDeletePrevious: true, }, },}
export default configRiferimento rapido alla configurazione
Sezione intitolata “Riferimento rapido alla configurazione”| Impostazione Ionic AppFlow | Equivalente di Capgo | È necessario impostarla? |
|---|---|---|
appId | Gestito dalla dashboard di Capgo | Fornito automaticamente alla creazione del progetto |
channel / defaultChannel | Regole dei canali nella dashboard/API | Override opzionale; i default arrivano dal server. Vedi Targeting delle versioni per strategie multi-versione |
autoUpdateMethod | autoUpdate: true | Abilitato di default |
maxVersions | Politica di retention | Configurata centralmente (default 1 mese, max 24 mesi) |
enabled | Non richiesto | Capgo attiva/disattiva la disponibilità per canale |
Fase 3 – Chiamata notifyAppReady() (l'unico hook richiesto)
Sezione intitolata “Passaggio 3 – Chiama notifyAppReady() (l’unico hook richiesto)”Nella guida di Ionic colleghi sync, download, e reload, quindi nascondi manualmente la splash screen. Capgo esegue queste azioni nativamente. Devi solo confermare che l’app sia pronta:
import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()Se la conferma non arriva, Capgo effettua automaticamente il rollback del bundle.
Fatto! Capgo gestisce automaticamente i controlli in background, la visibilità della splash screen e i rollback.
Opzionale: esegui della logica prima che la splash screen venga nascosta
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()Passaggio 4 – Strategie di aggiornamento tradotte
Sezione intitolata “Passaggio 4 – Strategie di aggiornamento tradotte”AppFlow documenta tre strategie. Ecco come si mappano su Capgo:
Background (predefinito)
Sezione intitolata “Background (default)”- AppFlow: configura
autoUpdateMethod = background, chiamasync()manualmente. - Capgo: abilitato di default. Nessun JavaScript richiesto.
Sempre l'ultima versione
Sezione intitolata “Sempre l'ultima versione”- AppFlow: aggiungi un
App.addListener('resume')handler che scarica e ricarica. - Capgo: l'auto-update viene già eseguito al resume. Aggiungi l'handler solo se vuoi una finestra temporale personalizzata.
Opzionale: check manuale al resume
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 }) }})Aggiornamento forzato
Sezione intitolata “Aggiornamento forzato”- AppFlow: mostra un prompt all'utente e chiama
reload(). - Capgo: contrassegna il bundle come “obbligatorio” nel dashboard, poi ascolta l'evento
majorAvailableevento (emesso doponotifyAppReady()) to prompt or force users inside your app.
Passaggio 5 – Mapping delle chiamate API
Sezione intitolata “Passo 5 – Mappatura delle chiamate API”| Metodo AppFlow | Equivalente di Capgo | Do you need it? |
|---|---|---|
LiveUpdates.sync() | Gestito automaticamente | L'auto-update nativo di Capgo funziona senza una chiamata di sync manuale |
LiveUpdates.download() | CapacitorUpdater.download() | Opzionale per flussi personalizzati |
LiveUpdates.reload() | CapacitorUpdater.set() | Opzionale; le toggle della dashboard gestiscono gli aggiornamenti forzati |
LiveUpdates.getVersion() | CapacitorUpdater.current() | Diagnostica opzionale |
Passaggio 6 – Deploy tramite Capgo CLI o API
Sezione intitolata “Passo 6 – Deploy con Capgo CLI o API”Completa la migrazione caricando i bundle con Capgo CLI o API. Il workflow riflette ciò che potresti aver già scriptato in precedenza, ma ora include protezioni native:
capgo login # authenticate oncecapgo bundle upload \ --path dist \ --channel production # automatically tags platform/versionDeploy specifici per versione (come AppFlow)
Sezione intitolata “Deploy per versione specifica (come AppFlow)”Se devi targeting versioni native specifiche (simile al version locking nativo di AppFlow):
# 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.xGuarda il Guida al Version Targeting per strategie complete.
Capgo automaticamente:
- Mantiene i log di audit a livello di dispositivo per ogni installazione.
- Invia email proattive quando ti avvicini ai limiti del piano.
- Fornisce crediti burst per non bloccarti mai a metà release.
- Pubblica le metriche di latenza per 18 regioni globali su stato.capgo.app/history.
Plugin Ionic Enterprise
Sezione intitolata “Plugin Ionic enterprise”Se il tuo stack Ionic utilizza anche plugin enterprise, segui i documenti di migrazione mirati di seguito. Ogni guida consiglia la sostituzione Capgo e i prossimi passi.
- Migrazione da Ionic Secure Storage
- Migrazione da Ionic Auth Connect
- Migrazione da Ionic Identity Vault
Frequently asked questions
Sezione intitolata “Domande frequenti”Perché AppFlow sta chiudendo i live updates?
Sezione intitolata “Perché AppFlow sta chiudendo i live updates?”Ionic sta dismetteno i prodotti commerciali, incluso AppFlow, per concentrarsi sul proprio framework open source. I clienti esistenti possono continuare a utilizzare live updates fino 31 dicembre 2027, ma non vengono accettate nuove funzionalità né nuovi clienti. Capgo colma questo vuoto con una piattaforma OTA nativa dedicata.
Quanto tempo richiede la migrazione?
Sezione intitolata “Quanto tempo richiede la migrazione?”La maggior parte dei team completa il passaggio in meno di un giorno. Concetti come canali, deployment e regole di rilascio corrispondono direttamente, e il nostro team fornisce documentazione oltre a supporto pratico. In molti casi basta semplicemente installare il plugin, chiamare notifyAppReady(), e caricare il primo bundle.
Risparmieremo sui costi?
Sezione dal titolo “Risparmieremo denaro?”Sì. I live update di AppFlow partono da $499/mese. Capgo parte da $14/mese con un pricing basato sull'uso che scende a circa $0,001 per MAU. Avrai inoltre crittografia, rollback automatici e monitoraggio della latenza a livello globale.
Quando dovremmo migrare?
Sezione dal titolo “Quando dovremmo migrare?”Poiché AppFlow è ora in modalità manutenzione, migrare subito ti permette di accedere alle continue innovazioni di Capgo. Consigliamo il passaggio quando si adatta al tuo calendario di rilascio. Il nostro team di ingegneria ti aiuterà a pianificare il cambio, così che CI/CD e deployment continuino a funzionare.
Risorse aggiuntive
Sezione “Risorse aggiuntive”- Guida al Version Targeting - Approfondimento sulle strategie di corrispondenza delle versioni in stile AppFlow
- Breaking changes - Gestione degli aggiornamenti di versione principale con i canali
- Gestione dei canali - Riferimento completo alla configurazione dei canali
- Prenota una sessione di migrazione: libro.capgo.app/demo
- Unisciti alla community: Discord di Capgo
- Segnala problemi / richiedi funzionalità: github.com/Cap-go/capacitor-updater
Capgo è progettato per le aziende che necessitano di aggiornamenti delta nativi, bundle crittografati e innovazione continua. Una volta completata la migrazione, puoi eliminare il codice di collegamento AppFlow code, affidarti all'automazione nativa e continuare a rilasciare senza interruzioni.
Continua da Migrare da AppFlow a Capgo
Sezione intitolata “Continua: migra da AppFlow a Capgo”Se stai usando Migrazione da AppFlow a Capgo per pianificare la migrazione e le operazioni enterprise, collegalo a Capgo Enterprise per il workflow del prodotto in Capgo Enterprise, Alternative ai plugin Ionic Enterprise per il workflow del prodotto nelle alternative ai plugin Ionic Enterprise, Alternative a Capgo per il workflow del prodotto in Capgo Alternatives, Consulenza Capgo per il workflow di prodotto in Capgo Consulting, e Supporto Premium Capgo per il workflow di prodotto in Capgo Premium Support.