Migrare da AppFlow a Capgo

🚦 Ioni ha annunciato che i prodotti commerciali di AppFlow, comprese le aggiornamenti in tempo reale, stanno cessando la loro attività. I progetti esistenti possono continuare a funzionare fino al 31 dicembre 2027, but no new customers are accepted and no new features are planned. This guide walks you through the actions required to migrate to Capgo and highlights the native automation you gain.

Panoramica della migrazione

Capgo handles channels, bundle retention, rollbacks, analytics, and CLI uploads for you. Migration boils down to installing the plugin, calling CapacitorUpdater.notifyAppReady()e, se desiderato, configurare controlli manuali facoltativi. Le sezioni che seguono guidano attraverso ogni compito direttamente.

Versione Targeting Come AppFlow

Se si è affidati alla versione automatica di AppFlow (che fornisce aggiornamenti compatibili in base alla versione nativa), Capgo offre la stessa capacità con un controllo migliorato. Consultare il Versione Targeting Guida per strategie dettagliate sulla gestione degli aggiornamenti su più versioni di app.

Passo 0 – Cattura la tua configurazione corrente di AppFlow

• Nota l'ID App di AppFlow ID App di AppFlow, canali esistenti e chiavi di firma.
• Esporta la storia dei bundle che desideri archiviare.
• If stai utilizzando GitHub Actions o un altro provider CI, mantieni quelle pipeline—funzioneranno ancora con Capgo.

Passo 1 – Sostituisci l'SDK AppFlow con Capgo

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

È tutto. Capgo bundle le librerie native code per iOS e Android; non sono necessari aiuti 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	Hai bisogno di impostarlo?
appId	Gestito nel dashboard Capgo	Fornito automaticamente quando si crea il progetto
channel / defaultChannel	Regole del canale nel dashboard/API	Override facoltativo; i valori di default provengono dal server. Vedi Targeting della versione context: Pagina/area: Pagina di marketing delle soluzioni Capgo. Ruolo: Intestazione di sezione o pagina. Visualizzato in: pagina soluzioni/version-targeting.astro. Chiave di messaggio `solutions_version_targeting_title` (Titolo del targeting della versione delle soluzioni). | Pagina/area: Pagina di marketing delle soluzioni Capgo. Ruolo: Etichetta di UI breve o elemento di navigazione. Visualizzato in: pagina soluzioni/version-targeting.astro. Chiave di messaggio `solutions_version_targeting` (Targeting della versione delle soluzioni).
autoUpdateMethod	autoUpdate: true	per strategie multi-versione
maxVersions	Abilitato di default	Configurato centralmente (1 mese di default, 24 mesi massimo)
enabled	Non richiesto	Capgo attiva la disponibilità per canale

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

In Ionic’s guide si collega sync, download, e reload, poi nascondi lo schermo di splash manualmente. Capgo esegue quelle azioni nativamente. Hai solo bisogno di confermare che l'app è pronta:

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

CapacitorUpdater.notifyAppReady()

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

Sono finiti—Capgo gestisce le verifiche in background, la visibilità dello schermo di splash e i ripristini per te.

Facoltativo: eseguire 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 – Strategie di aggiornamento tradotte

I documenti di AppFlow descrivono tre strategie. Ecco come si mappano a Capgo:

Background (predefinito)

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

Sempre aggiornato

• AppFlow: aggiungi un App.addListener('resume') : caricamento e ricarica automatico.
• Capgo: l'aggiornamento automatico esegue già il riavvio. Aggiungi il caricamento e ricarica solo se desideri un finestra di timing personalizzata.

Facoltativo: controllo di riavvio 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 })
  }
})

Aggiorna forzatamente

• AppFlow: sollecita l'utente e chiama reload().
• : Capgo: segnala il bundle come “obbligatorio” nella dashboard, quindi ascolta per l' majorAvailable evento (emesso dopo notifyAppReady()) per sollecitare o costringere gli utenti all'interno della tua app.

Passo 5 – Mappatura delle chiamate a API

Metodo AppFlow	Corrispettivo di Capgo	Avrai bisogno di esso?
LiveUpdates.sync()	È gestito automaticamente	Capgo's native auto-update runs without a manual sync call
LiveUpdates.download()	CapacitorUpdater.download()	Facoltativo per flussi personalizzati
LiveUpdates.reload()	CapacitorUpdater.set()	Facoltativo; i pulsanti del pannello di controllo gestiscono gli aggiornamenti obbligatori
LiveUpdates.getVersion()	CapacitorUpdater.current()	Diagnostica facoltativa

Passo 6 – Distribuisci utilizzando il Capgo CLI o API

Completa la migrazione caricando pacchetti con il Capgo CLI o API. Il flusso di lavoro riproduce quello che avresti potuto scrivere prima, ma ora include misure di sicurezza native:

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

Deployamenti specifici della versione (come AppFlow)

Se hai bisogno di targettizzare versioni native specifiche (simili al blocco di versione 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 il Guida per la versione di destinazione 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 esplosione per assicurarsi che non si venga bloccati durante la pubblicazione.
• Pubblica metriche di latenza per 18 regioni globali a status.capgo.app/history.

Plugin di Ionic enterprise

Se il tuo stack Ionic utilizza anche plugin enterprise, segui le guide di migrazione personalizzate riportate di seguito. Ogni guida consiglia il rimpiazzo Capgo e i passaggi successivi.

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

Domande frequenti

Perché AppFlow sta interrompendo le aggiornamenti live?

Ionic sta interrompendo i prodotti commerciali, inclusa AppFlow, per concentrarsi sul loro framework open-source. I clienti esistenti possono continuare ad utilizzare gli aggiornamenti live fino al 31 dicembre 2027, ma non sono accettati nuovi feature o clienti. Capgo colma questo vuoto con una piattaforma nativa OTA dedicata.

Quanto tempo richiede la migrazione?

La maggior parte delle squadre completa il trasferimento 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 pratico. In molti casi, basta installare il plugin, chiamare notifyAppReady()e caricare il tuo primo pacchetto.

Saveremo denaro?

Sì. Le aggiornamenti live di AppFlow iniziano da $499/mo. Capgo inizia da $14/mo con prezzi basati sull'uso che scendono a circa $0.001 per utente attivo mensile. Acquisisci anche la crittografia, i rollback automatici e la monitoraggio della latenza in tutto il mondo.

Quando dobbiamo migrare?

Poiché AppFlow è ora in modalità di manutenzione, migrare prima ti dà accesso alle innovazioni in corso di Capgo. Raccomandiamo 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 tuo CI/CD e le tue distribuzioni continuino a funzionare.

Risorse aggiuntive

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

Avete bisogno di aiuto?

• Prendete un appuntamento per una sessione di migrazione: book.capgo.app/demo
• Unitevi alla community: Capgo Discord
• Seguite gli issue / richiedete funzionalità: github.com/Cap-go/capacitor-aggiornatore

Capgo è progettato per le aziende che hanno bisogno di aggiornamenti delta nativi, pacchetti crittografati e innovazione continua. Una volta migrati potete eliminare il glue di AppFlow code, affidarvi all'automazione nativa e continuare a distribuire senza interruzioni.

Continuate da Migrate from AppFlow a Capgo

Se state utilizzando Migrate from AppFlow to Capgo per pianificare la migrazione e le operazioni aziendali, connettilo con Capgo Enterprise per il flusso di lavoro del prodotto in Capgo Enterprise, Alternative per Plugin Enterprise Ionic per il flusso di lavoro del prodotto nelle alternative del plugin Enterprise di Ionic Capgo Alternative soluzioni per il flusso di lavoro del prodotto in Capgo Alternative Capgo consulenza per il workflow del prodotto in Capgo Consulting, e Capgo Supporto Premium per il workflow del prodotto in Capgo Supporto Premium.