Migrate from AppFlow a Capgo

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

Panoramica della migrazione

Capgo gestisce i canali, la conservazione dei pacchetti, le annullazioni, le analisi e le CLI caricature per te. 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.

Versionamento come AppFlow

Se hai dipinto sul flusso di AppFlow automatico di versione (distribuendo aggiornamenti compatibili in base alla versione nativa), Capgo fornisce la stessa capacità con un controllo migliorato. Vedi il Guida alla versione di destinazione per strategie dettagliate sulla gestione degli aggiornamenti su più versioni di app.

Passo 0 – Cattura la tua configurazione corrente di AppFlow

• Nota il tuo 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—saranno ancora funzionanti 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 crea i pacchetti nativi code 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 di 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	Sovrapposizione 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 max)
enabled	Non richiesto	Capgo attiva la disponibilità per canale

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

In Guida di Ionic si collega sync, download, e reload, quindi 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 fa rotolare automaticamente il pacchetto.

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

Facoltativo: esegui logica prima che lo schermo di splash 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

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

Antefatto (predefinito)

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

Sempre aggiornato

• AppFlow: aggiungi un App.addListener('resume') manipolatore che scarica e ricarica.
• Capgo: gli aggiornamenti automatici si eseguono già alla ripresa. Aggiungi il manipolatore solo se desideri una finestra di timing personalizzata.

Optional: controllo di ripresa 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'evento (emesso dopo majorAvailable ) per invitare o costringere gli utenti all'interno della tua app. notifyAppReady()Passo 5 – Mappatura delle chiamate __CAPGO_KEEP_0__

Sottosezione intitolata “Passo 5 – Mappatura delle chiamate API”

Corrispettivo di __CAPGO_KEEP_0__	Capgo equivalent	Trattato automaticamente
LiveUpdates.sync()	__CAPGO_KEEP_0__’s aggiornamento auto-aggiornamento nativo funziona senza una chiamata di sincronizzazione manuale	Capgo’s native auto-update runs without a manual sync call
LiveUpdates.download()	CapacitorUpdater.download()	Facoltativo; i pulsanti della dashboard gestiscono gli aggiornamenti obbligatori
LiveUpdates.reload()	CapacitorUpdater.set()	__CAPGO_KEEP_0__
LiveUpdates.getVersion()	CapacitorUpdater.current()	Diagnosi facoltative

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 ciò 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

Deployamenti specifici della versione (come AppFlow)

Se hai bisogno di mirare a 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 Guida per la definizione del target per strategie complete.

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 bursta per assicurarsi che non si venga bloccati durante la pubblicazione.
• Pubblica metriche di latenza per 18 regioni globali a status.capgo.app/storia.

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.

• Plugin enterprise Ionic
• 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, compreso AppFlow, per concentrarsi sul loro framework open-source. Gli utenti esistenti possono continuare ad utilizzare le aggiornamenti in tempo reale fino al 31 dicembre 2027, ma non sono accettati nuovi feature o utenti. 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. 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 e chiamare notifyAppReady()Esegui l'upload del tuo primo bundle.

Salveremo denaro?

Sì. Le aggiornamenti live di AppFlow iniziano da 499,00 $/mese. Capgo inizia da 14,00 $/mese con un prezzo a consumo che scende a circa 0,001 $ per utente attivo al mese. Inoltre, avrai anche la crittografia, i rollback automatici e il monitoraggio della latenza in tutto il mondo.

Quando dobbiamo migrare?

Poiché AppFlow è ora in modalità di manutenzione, l'aggiornamento più presto ti darà accesso all'innovazione in corso Capgo. Raccomandiamo di passare quando si adatta al tuo calendario di rilascio. Il nostro team di ingegneria ti aiuterà a pianificare il passaggio affinché i tuoi CI/CD e le distribuzioni continuino a funzionare.

Risorse aggiuntive

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

Hai bisogno di aiuto?

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

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

Continua da Migrate from AppFlow a Capgo

Se stai utilizzando Migrate from 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, Alternative per l'plugin di Ionic Enterprise per il flusso di lavoro del prodotto in Alternative per l'plugin di Ionic Enterprise, Alternative per Capgo per il flusso di lavoro del prodotto in Alternative per Capgo, Consultazione di Capgo per il flusso di lavoro del prodotto in Consultazione di Capgo, e Supporto Premium di Capgo per il flusso di lavoro del prodotto in Supporto Premium di Capgo.