Migrate from AppFlow to Capgo

Copia un prompt di configurazione con le istruzioni di installazione e la guida markdown completa per questo plugin.

🚦 Ioni ha annunciato che i prodotti commerciali di AppFlow, comprese le aggiornamenti in tempo reale, stanno chiudendo. 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.

Passo 0 – Cattura la tua configurazione corrente di AppFlow

Nota l'ID dell'applicazione di AppFlow ID dell'applicazione, 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 il flusso di AppFlow SDK con Capgo

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

È tutto. Capgo compila i nativi code per iOS e Android; non sono necessarie aiuto JavaScript aggiuntive.

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

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 breve di UI 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-versioni
`maxVersions`	Abilitato di default	Configurato centralmente (1 mese predefinito, 24 mesi massimo)
`enabled`	Non richiesto	Capgo attiva la disponibilità per canale

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

In Ionic, nella guida, si collega sync, download, e reload, poi 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 ripristina automaticamente il bundle.

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

Facoltativo: eseguire logica prima che la schermata 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.
Capgoabilitato di default. Nessun JavaScript richiesto.

Sempre aggiornato

AppFlowSottosezione intitolata “AppFlow” App.addListener('resume') aggiungi un
Capgo__CAPGO_KEEP_0__

Sottosezione intitolata “Forza l'aggiornamento”

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

Opzionale: controllo di riavvio manuale

AppFlow: sollecita l'utente e chiama reload().
: Capgo: segnala il bundle come "obbligatorio" nella dashboard, quindi ascolta l'evento (emesso dopo ) per sollecitare o costringere gli utenti all'interno dell'applicazione. majorAvailable Step 5 – Mappatura dei __CAPGO_KEEP_0__ notifyAppReady()Metodo AppFlow

Corrispettivo di API

È gestito automaticamente	Capgo equivalent	Step 5 – Mappatura dei __CAPGO_KEEP_0__ calls
`LiveUpdates.sync()`	AppFlow method	Capgo's native auto-update esegue senza una chiamata di sincronizzazione manuale
`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()`	Diagnosi facoltative

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 potresti aver scritto prima, ma ora include misure di sicurezza 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 targettare 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 e-mail proattive quando si avvicina ai limiti del piano.
Fornisce crediti di esplosione per assicurarsi che non venga bloccato durante la pubblicazione.
Pubblica metriche di latenza per 18 regioni globali a status.capgo.app/history.

plugin di Ionic enterprise

Se il proprio stack Ionic utilizza anche plugin enterprise, seguire le guide di migrazione specifiche riportate di seguito. Ogni guida consiglia la sostituzione con Capgo e i passaggi successivi.

Domande frequenti

Perché AppFlow sta interrompendo le aggiornamenti in tempo reale?

Ionic sta interrompendo i prodotti commerciali, compreso AppFlow, per concentrarsi sul proprio framework open-source. I clienti esistenti possono continuare ad utilizzare gli aggiornamenti in tempo reale 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 passaggio in meno di un giorno. I concetti come canali, distribuzioni e regole di rilascio si mappano direttamente, e il nostro team fornisce documentazione e supporto pratico. In molti casi, basta installare il plugin, chiamare notifyAppReady()e caricare il tuo primo bundle.

Saveremo denaro?

Sì. Le aggiornamenti live di AppFlow iniziano da $499/mo. Capgo inizia da $14/mo con un prezzo basato sull'uso che scende a circa $0.001 per utente attivo mensileAcquistando Capgo, guadagni anche l'accesso all'encryption, ai rollback automatici e alla 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 passaggio in modo che il tuo CI/CD e le tue distribuzioni continuino a funzionare.

Risorse aggiuntive

Guida per la versione di destinazione - Profonda analisi delle strategie di matching delle versioni AppFlow-style
Modifiche significative - Gestione degli aggiornamenti delle versioni principali con i canali
Gestione dei canali - Riferimento completo alla configurazione dei canali

Avete bisogno di aiuto?

Prenotate una sessione di migrazione: book.capgo.app/demo
Unitevi alla community: Capgo Discord
Segnalate gli errori / richiedete nuove funzionalità: github.com/Cap-go/capacitor-aggiornatore

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

Continuate da Migrate from AppFlow a Capgo

Se stai utilizzando Migra da AppFlow a Capgo per pianificare la migrazione e le operazioni aziendali, connettilo con Capgo Enterprise per il flusso di lavoro del prodotto in Capgo Enterprise Ilternative per Plugin Enterprise di Ionic per il flusso di lavoro del prodotto in Ilternative per Plugin Enterprise di Ionic Capgo Alternatives per il flusso di lavoro del prodotto in Capgo Alternatives Capgo Consulting per il flusso di lavoro del prodotto in Capgo Consulting, e Capgo Supporto Premium per il flusso di lavoro del prodotto in Capgo Supporto Premium.