Migrare da AppFlow a Capgo

Copia un prompt di configurazione con i passaggi 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 attuale di AppFlow

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

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

Ecco fatto. Capgo raggruppa i nativi code sia per iOS che per 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 è:

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: Titolo 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-versione
`maxVersions`	Abilitato di default	Configurato centralmente (1 mese di default, 24 mesi max)
`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 nasconde lo schermo di benvenuto manualmente. Capgo esegue quelle azioni nativamente. È necessario 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.

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

Opzionale: 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.
Capgo: abilitato di default. Nessun JavaScript richiesto.

Sempre aggiornato

AppFlow: aggiungi un App.addListener('resume') manuale che scarica e ricarica.
CapgoSottosezione intitolata “Aggiornamento automatico”

: l'aggiornamento automatico esegue già il riavvio. Aggiungi il manuale solo se desideri un finestra di timing personalizzata.

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

Copia negli appunti

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 delle chiamate a notifyAppReady()Metodo AppFlow

Step 5 – Mapping API calls

È gestito automaticamente	Section titled “Step 5 – Mapping Capgo calls”	AppFlow method
`LiveUpdates.sync()`	__CAPGO_KEEP_0__ equivalent	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 i 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 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 venga bloccato durante la pubblicazione.
Pubblica metriche di latenza per 18 regioni globali in status.capgo.app/history.

Plugin enterprise Ionic

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

Domande frequenti

Perché AppFlow sta smettendo di fornire aggiornamenti in tempo reale?

Ionic sta interrompendo i prodotti commerciali, tra cui 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 di OTA nativa dedicata.

Quanto tempo richiede la migrazione?

La maggior parte delle squadre completa il passaggio in meno di un giorno. 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 un prezzo basato sull'uso che scende a circa $0.001 per utente attivo mensileAcquistando Capgo, guadagni inoltre l'encryption, 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 all'innovazione Capgo in corso. Consigliamo di passare quando si adatta al tuo calendario di rilascio. Il nostro team di ingegneria ti aiuterà a pianificare il cambio in modo che il tuo CI/CD e le tue distribuzioni continuino a funzionare.

Risorse aggiuntive

Guida per la versione di destinazione - Profondità in AppFlow-style version matching strategie
Modifiche di versione - Gestione degli aggiornamenti di versione principale con 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 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 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 Ionic. Alternative di Capgo 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.