Migra da AppFlow a Capgo

🚦 Ionic ha annunciato che i prodotti commerciali di AppFlow — inclusi Live Updates — verranno dismessi. I progetti esistenti rimarranno attivi fino a 31 dicembre 2027, ma non verranno accettati nuovi clienti né pianificate nuove feature. Questa guida ti accompagnerà nei passaggi necessari per migrare a Capgo e ti mostrerà l'automazione nativa che otterrai.

Panoramica della migrazione

Capgo gestisce per te canali, retention dei bundle, rollback, analytics e gli upload di CLI. La migrazione consiste nell'installare il plugin, chiamare CapacitorUpdater.notifyAppReady(), e—se desiderato—configurare i controlli manuali opzionali. Le sezioni seguenti spiegano ogni task nel dettaglio.

Targeting delle versioni come AppFlow

Se facevi affidamento sul version matching automatico di AppFlow (per distribuire update compatibili in base alla versione nativa), Capgo offre la stessa funzionalità con un controllo maggiore. Consulta la Guida al Version Targeting per strategie dettagliate sulla gestione degli update su più versioni dell'app.

Passaggio 0 – Configurazione AppFlow attuale

• Annota il tuo AppFlow ID App, i canali esistenti e le 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 il SDK di AppFlow con Capgo

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

Fatto. Capgo gestisce i bundle nativi code sia per iOS che per Android; non servono altri helper JavaScript.

Passaggio 2 – Configurazione minima (nessun campo manuale)

Il blocco di configurazione esistente è molto esteso. Capgo rileva automaticamente il tuo progetto e i 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

Riferimento rapido alla configurazione

Impostazione Ionic AppFlow	Equivalente Capgo	È necessario impostarlo?
appId	Gestito nella dashboard di Capgo	Fornito automaticamente alla creazione del progetto
channel / defaultChannel	Regole del canale 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	Policy di retention	Configurato centralmente (default 1 mese, max 24 mesi)
enabled	Non richiesto	Capgo gestisce la disponibilità per canale

Passaggio 3 – Call notifyAppReady() (l'unico hook richiesto)

Nella guida di Ionic, devi collegare sync, download, e reload, quindi nascondere la splash screen manualmente. 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 esegue 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 di nascondere la splash screen

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 update convertite

AppFlow documenta tre strategie. Ecco come si mappano su Capgo:

Sfondo (predefinito)

• AppFlow: configura autoUpdateMethod = background, chiama sync() manualmente.
• Capgo: abilitato di default. Nessun JavaScript richiesto.

Sempre l'ultima versione

• AppFlow: aggiungi un App.addListener('resume') handler che scarica e ricarica.
• Capgo: l'auto-update è già attivo al resume. Aggiungi l'handler solo se desideri una finestra temporale personalizzata.

Opzionale: controllo 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

• AppFlow: mostra un prompt all'utente e chiama reload().
• Capgo: segna il bundle come “mandatory” nella dashboard, poi ascolta l' majorAvailable event (emesso dopo notifyAppReady()) to prompt or force users inside your app.

Passaggio 5 – Mapping delle chiamate API

Metodo AppFlow	Equivalente Capgo	Do you need it?
LiveUpdates.sync()	Gestito automaticamente	L'auto-update nativo di Capgo funziona senza chiamate di sync manuali
LiveUpdates.download()	CapacitorUpdater.download()	Opzionale per workflow personalizzati
LiveUpdates.reload()	CapacitorUpdater.set()	Opzionale; gli switch nel dashboard gestiscono gli update forzati
LiveUpdates.getVersion()	CapacitorUpdater.current()	Diagnostica opzionale

Passaggio 6 – Deploy tramite Capgo CLI o API

Completa la migrazione caricando i bundle con Capgo CLI o API. Il workflow è simile a quello che avevi già impostato, ma ora include protezioni native:

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

Deploy specifici per versione (come AppFlow)

Se hai bisogno di puntare a versioni native specifiche (simile al native version locking di AppFlow):

# 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

Vedi la Guida al Version Targeting per strategie complete.

Capgo in automatico:

• 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 durante un rilascio.
• Pubblica metriche di latenza per 18 regioni globali su stato di capgo.app/history.

Plugin Ionic Enterprise

Se il tuo stack Ionic usa anche plugin enterprise, segui la documentazione di migrazione dedicata qui sotto. Ogni guida consiglia il sostituto Capgo e i prossimi passi.

• Migra da Ionic Secure Storage
• Migra da Ionic Auth Connect
• Migra da Ionic Identity Vault

Frequently asked questions

Perché AppFlow sta chiudendo i live updates?

Ionic interromperà i prodotti commerciali, incluso AppFlow, per concentrarsi sul proprio framework open source. I clienti attuali potranno continuare a usare i Live Update fino al 31 dicembre 2027, ma non vengono accettati nuovi clienti né nuove funzionalità. Capgo colma questa lacuna con una piattaforma OTA nativa dedicata.

Quanto tempo richiede la migrazione?

La maggior parte dei team completa il passaggio in meno di un giorno. Concetti come channel, deployment e regole di release si mappano direttamente, e il nostro team fornisce documentazione e supporto pratico. In molti casi basta installare il plugin, chiamare notifyAppReady(), e fare l'upload del primo bundle.

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

Quando dovremmo migrare?

Poiché AppFlow è ora in modalità maintenance, migrare subito ti permette di accedere alle continue innovazioni di Capgo. Consigliamo il passaggio in base al tuo piano di rilascio. Il nostro team engineering ti aiuterà a pianificare il cambio per non interrompere CI/CD e deployment.

Risorse aggiuntive

• Guida al Version Targeting - Analisi approfondita delle strategie di version matching stile AppFlow
• Modifiche critiche - Gestione degli aggiornamenti di major version tramite i canali
• Gestione dei canali - Riferimento completo alla configurazione dei canali

Need help?

• Prenota una sessione di migrazione: prenota capgo.app/demo
• Unisciti alla community: Discord di Capgo
• Segnala bug / richiedi feature: github.com/Cap-go/capacitor-updater

Capgo è progettato per le aziende che necessitano di delta update native, bundle criptati e innovazione continua. Una volta migrato, potrai eliminare il middleware di AppFlow code, affidarti all'automazione nativa e continuare a rilasciare aggiornamenti senza interruzioni.

Torna a: Migrazione da AppFlow a Capgo

Se stai usando Migra 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 in Alternative ai plugin Ionic Enterprise, Alternative a Capgo per il workflow di prodotto in Capgo Alternatives, Consulenza su Capgo per il workflow di prodotto in Capgo Consulting, e Supporto Premium Capgo per il workflow di prodotto in Capgo Premium Support.