Migrare da AppFlow a Capgo

🚦 Ionic ha annunciato che i prodotti commerciali di AppFlow, tra cui le Aggiornamenti in tempo reale, stanno smettendo di funzionare. I progetti esistenti possono continuare a funzionare fino al 31 dicembre 2027, ma non sono accettati nuovi clienti e non sono previste nuove funzionalità. Questa guida vi guida attraverso le azioni necessarie per migrare a Capgo e mette in evidenza l'automazione nativa che guadagnate.

Panoramica della migrazione

Capgo gestisce i canali, la conservazione dei pacchetti, i rollback, le analisi e le CLI upload per voi. La migrazione si riduce all'installazione del plugin, alla chiamata CapacitorUpdater.notifyAppReady(), e se desiderato—alla configurazione dei controlli manuali facoltativi. Le sezioni che seguono guidano attraverso ogni compito direttamente.

Versione di Riferimento Come AppFlow

Se hai dipinto sulla versione automatica di AppFlow (che invia aggiornamenti compatibili in base alla versione nativa), Capgo offre la stessa capacità con un controllo migliorato. Vedi il Versione di Riferimento Guida per strategie dettagliate per gestire gli aggiornamenti su diverse versioni dell'applicazione.

Passo 0 – Cattura la tua configurazione corrente di AppFlow

• Nota la tua AppFlow ID App, canali esistenti e chiavi di firma.
• Esporta qualsiasi storia di bundle che desideri archiviare.
• Se stai utilizzando GitHub Actions o un altro provider CI, conserva quelle pipeline—continueranno a funzionare con Capgo.

Passo 1 – Sostituisci l'AppFlow SDK con Capgo

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

Ecco fatto. Capgo pacchetta il code nativo per iOS e Android; non sono necessarie aiuto JavaScript aggiuntivi.

Passo 2 – Configurazione minima (nessun campo manuale)

La sezione di configurazione esistente è estesa. 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 AppFlow di Ionic	Capgo equivalente	Avete bisogno di impostarlo?
appId	Gestito nel dashboard Capgo	Fornito automaticamente quando si crea il progetto
channel / defaultChannel	Regole del canale nel dashboard/API	Sostituzione facoltativa; i valori di default provengono dal server. Vedi Versione di destinazione per strategie multi-versione
autoUpdateMethod	autoUpdate: true	Abilitato di default
maxVersions	Politica di conservazione	Configurato centralmente (1 mese di default, 24 mesi massimi)
enabled	Non richiesto	Capgo abilita o disabilita la disponibilità per canale

Passo 3 – Chiamata notifyAppReady() (l'unico hook richiesto)

Nel guide di Ionic si collega sync, download, e reload, quindi nascondi lo schermo di benvenuto manualmente. Capgo esegue quelle azioni nativamente. Devi solo confermare che l'app è pronta:

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Se la conferma non arriva mai, Capgo ripiega automaticamente il bundle.

Ecco—Capgo gestisce le verifiche in background, la visibilità dello schermo di benvenuto e i ripieghi per te.

Facoltativo: esegui logica prima che lo schermo di benvenuto si nasconda

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()

Passo 4 – Aggiorna le strategie tradotte

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

Background (predefinito)

• AppFlow: configurare autoUpdateMethod = background: chiamare sync() manualmente.
• Capgo: abilitato di default. Non richiede JavaScript.

Sempre l'ultima versione

• AppFlow: aggiungi App.addListener('resume') un gestore che scarica e ricarica.
• Capgo: l'aggiornamento automatico si esegue già al ripristino. Aggiungi il gestore solo se desideri un finestra di timing personalizzata.

Opzionale: controllo di ripristino manuale

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 })
  }
})

Forza aggiornamento

• AppFlow: sollecita l'utente e chiama reload().
• CapgoprotectedTokens: ["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"] majorAvailable texts: ["__CAPGO_KEEP_0__",": segnala il bundle come “obbligatorio” nella dashboard, quindi ascolta per l'","evento (emesso dopo",") per sollecitare o costringere gli utenti all'interno della tua app.","Step 5 – Mappatura dei chiamate __CAPGO_KEEP_0__","Sezione intitolata “Step 5 – Mappatura dei chiamate __CAPGO_KEEP_0__”","AppFlow method","__CAPGO_KEEP_0__ equivalente","Hai bisogno di esso?","Gestito automaticamente","__CAPGO_KEEP_0__’s native auto-update esegue senza una chiamata di sincronizzazione manuale","Facoltativo per flussi personalizzati"] notifyAppReady()__CAPGO_KEEP_0__

Step 5 – Mappatura dei chiamate API

__CAPGO_KEEP_0__ equivalente	Capgo equivalent	Gestito automaticamente
LiveUpdates.sync()	__CAPGO_KEEP_0__’s native auto-update esegue senza una chiamata di sincronizzazione manuale	Capgo’s native auto-update runs without a manual sync call
LiveUpdates.download()	CapacitorUpdater.download()	Step 5 – Mappatura dei chiamate __CAPGO_KEEP_0__
LiveUpdates.reload()	CapacitorUpdater.set()	Facoltativo; interfacce di dashboard gestiscono aggiornamenti obbligatori
LiveUpdates.getVersion()	CapacitorUpdater.current()	Diagnosi facoltative

Passo 6 – Distribuisci utilizzando il Capgo CLI o API

Completa la migrazione caricando bundle con il Capgo CLI o API. Il workflow riproduce ciò che potresti aver scritto prima, ma ora include salvaguardie native:

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

Distribuzioni specifiche della versione (come AppFlow)

Se hai bisogno di targettizzare versioni native specifiche (simili alla bloccatura della versione nativa di AppFlow):

# 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

Vedi il Version Targeting Guide per strategie approfondite.

Capgo automaticamente:

• Conserva i registri di audit a livello di dispositivo per ogni installazione.
• Invia email proattive quando si avvicina ai limiti del piano.
• Fornisce crediti di burst per cui non sarai mai bloccato durante la pubblicazione.
• Pubblica metriche di latenza per 18 regioni globali a status.capgo.app/history.

Plugin enterprise Ionic

If your Ionic stack also uses enterprise plugins, follow the targeted migration docs below. Each guide recommends the Capgo replacement and the next steps.

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

Domande frequenti

Perché AppFlow sta interrompendo le aggiornamenti in tempo reale?

Ionic sta interrompendo i prodotti commerciali, inclusa AppFlow, per concentrarsi sul loro framework open-source. Gli utenti esistenti possono continuare ad utilizzare le aggiornamenti in tempo reale fino a 31 dicembre 2027, ma non sono accettati nuovi feature o utenti. Capgo colma questo vuoto con una piattaforma di OTA nativa dedicata.

Quanto tempo richiede la migrazione?

La maggior parte delle squadre completa il passaggio in meno di un giorno. I concetti come canali, distribuzioni e regole di rilascio si mappano direttamente, e il nostro team fornisce documentazione più supporto di tipo pratico. In molti casi basta semplicemente installare il plugin e chiamare notifyAppReady(), e caricare il tuo primo bundle.

Risparmieremo denaro?

Sì. Le aggiornamenti in tempo reale di AppFlow iniziano a __CAPGO_KEEP_0__. $499/moInizia a Capgo 14€/mese con l'abbonamento basato sulle prestazioni che scende a circa $0.001 per utente attivo mensileAcquistando Capgo, ottieni anche la crittografia, i rollback automatici e la monitoraggio della latenza in tutto il mondo.

Quando dobbiamo eseguire il migrazione?

Poiché AppFlow è ora in modalità di manutenzione, migrare prima ti dà accesso all'innovazione in corso Capgo. Consigliamo di passare quando si adatta al tuo calendario di rilascio. Il nostro team di ingegneria ti aiuterà a pianificare il cambio per assicurarti che il CI/CD e le distribuzioni continuino a funzionare.

Risorse aggiuntive

• Guida per la versione di destinazione - Approfondisci le strategie di matching delle versioni AppFlow-style
• Cambiamenti significativi - Gestione degli aggiornamenti di versione principale con canali
• Gestione dei canali - Riferimento completo di configurazione dei canali

Hai bisogno di aiuto?

• Prenota una sessione di migrazione: cal.com/team/capgo/demo
• Unisciti alla community: Capgo Discord
• Segui gli issue / richiedi funzionalità: github.com/Cap-go/capacitor-updater

Capgo è progettato per le aziende che necessitano di aggiornamenti delta nativi, pacchetti crittografati e innovazione continua. Una volta migrato, puoi eliminare il glue AppFlow code, affidarti all'automazione nativa e continuare a distribuire senza interruzioni.