Vai al contenuto

Migrazione da AppFlow a Capgo

🚦 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.

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”
Finestra del terminale
npm uninstall @capacitor/live-updates
npm install @capgo/capacitor-updater
npx cap sync

Fatto. 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 è:

capacitor.config.ts
import { CapacitorConfig } from '@capacitor/cli'
const config: CapacitorConfig = {
plugins: {
CapacitorUpdater: {
autoUpdate: true,
autoDeletePrevious: true,
},
},
}
export default config
Impostazione Ionic AppFlowEquivalente di CapgoÈ necessario impostarla?
appIdGestito dalla dashboard di CapgoFornito automaticamente alla creazione del progetto
channel / defaultChannelRegole dei canali nella dashboard/APIOverride opzionale; i default arrivano dal server. Vedi Targeting delle versioni per strategie multi-versione
autoUpdateMethodautoUpdate: trueAbilitato di default
maxVersionsPolitica di retentionConfigurata centralmente (default 1 mese, max 24 mesi)
enabledNon richiestoCapgo 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:

  • AppFlow: configura autoUpdateMethod = background, chiama sync() manualmente.
  • Capgo: abilitato di default. Nessun JavaScript richiesto.
  • 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 })
}
})
  • AppFlow: mostra un prompt all'utente e chiama reload().
  • Capgo: contrassegna il bundle come “obbligatorio” nel dashboard, poi ascolta l'evento majorAvailable evento (emesso dopo notifyAppReady()) to prompt or force users inside your app.
Metodo AppFlowEquivalente di CapgoDo you need it?
LiveUpdates.sync()Gestito automaticamenteL'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:

Finestra del terminale
capgo login # authenticate once
capgo bundle upload \
--path dist \
--channel production # automatically tags platform/version

Se devi targeting versioni native specifiche (simile al version locking nativo di AppFlow):

Finestra del terminale
# 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

Guarda 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.

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.

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.

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.

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.

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.

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.

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.