Migrare da AppFlow a Capgo

🚦 Ioni ha annunciato che i prodotti commerciali di AppFlow, tra cui gli aggiornamenti in tempo reale, stanno chiudendo. I progetti esistenti possono continuare 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 gestisce canali, la conservazione dei bundle, i rollback, le analisi e le CLI upload per te. La migrazione si riduce all'installazione del plugin e 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 da AppFlow automatico versione di riferimento (distribuendo aggiornamenti compatibili in base alla versione nativa), Capgo fornisce la stessa capacità con un controllo migliorato. Vedi il Versione di Riferimento Guida per strategie dettagliate sulla gestione degli aggiornamenti su più versioni di app.

Passo 0 – Cattura la tua attuale configurazione AppFlow

• Nota il tuo AppFlow ID Appcanali esistenti e chiavi di firma.
• Esporta qualsiasi storia di bundle che desideri archiviare.
• Se stai utilizzando azioni di GitHub o un altro provider CI, mantieni 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 raggruppa le librerie native code per iOS e Android; non sono necessarie ulteriori funzioni JavaScript di aiuto.

Passo 2 – Configurazione minima (nessun campo manuale)

L'area 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

Impostazioni di Ionic AppFlow	equivalente di Capgo	Hai bisogno di impostarlo?
appId	Gestito nel dashboard di 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 Target di versione per strategie multi-versione
autoUpdateMethod	autoUpdate: true	per strategie multi-versione
maxVersions	Abilitato di default	Configurato centralmente (1 mese di default, 24 mesi massimo)
enabled	Not necessario	Capgo attiva la disponibilità per canale

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

In Ionic's guida si collega sync, download, and reload, nascondi quindi 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()

If the confirmation never arrives, Capgo rolls the bundle back automatically.

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

Eseguire logica opzionale 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. Non richiede JavaScript.

Sempre aggiornato

• AppFlow: aggiungi un App.addListener('resume') manipolatore che scarica e ricarica.
• CapgoL'aggiornamento automatico viene già eseguito alla ripresa. Aggiungi il gestore solo se desideri un intervallo di tempo personalizzato.

Controllo manuale di riavvio facoltativo

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: chiedi all'utente e chiama reload().
• Capgo: segnala il pacchetto come “obbligatorio” nella dashboard, quindi ascolta l'evento (emesso dopo majorAvailable evento (emesso dopo) notifyAppReady()Passo 5 – Mappatura delle chiamate

Step 5 – Mapping API calls

Corrispettivo di	Capgo equivalent	È gestito automaticamente
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()	Optional; dashboard toggles handle forced updates
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

Deployamenti specifici della versione (come AppFlow)

Se hai bisogno di targettizzare versioni native specifiche (simili al blocco di versione nativa 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 funziona automaticamente:

• Mantiene i registri di audit del dispositivo per ogni installazione.
• Invia email proattive quando si avvicina ai limiti del piano.
• Fornisce crediti di burst per garantire che non venga bloccato durante l'aggiornamento.
• Pubblica metriche di latenza per 18 regioni globali a Stato.capgo.app/storia.

Plugin enterprise Ionic

Se il tuo stack Ionic utilizza anche plugin enterprise, segui i documenti di migrazione mirati qui sotto. Ogni guida consiglia la sostituzione del Capgo e i passaggi successivi.

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

Frequently asked questions

Perché AppFlow sta interrompendo le notifiche in tempo reale?

Ionic sta interrompendo i prodotti commerciali, tra cui AppFlow, per concentrarsi sul loro framework open-source. I clienti esistenti possono continuare ad utilizzare gli aggiornamenti in tempo reale fino 31 dicembre 2027, ma non sono accettati nuovi feature o clienti. Il 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 di canali, distribuzioni e regole di rilascio si mappano direttamente, e il nostro team fornisce documentazione più supporto di tipo pratico. In molti casi basta installare il plugin, chiamare notifyAppReady()e caricare il primo pacchetto.

Saveremo denaro?

Sì. Le aggiornamenti live di AppFlow iniziano da $499/mo. Capgo inizia da $14/mo con un prezzo a consumo che scende a circa $0.001 per utente attivo al meseAcquisisci 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 passaggio 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 significative - Gestione degli aggiornamenti di versione principale con canali
• Gestione dei canali - Riferimento completo di configurazione dei canali

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 delta nativi, pacchetti crittografati e innovazione continua. Una volta migrato, puoi eliminare il glue di 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, connetti con Capgo Enterprise per il flusso di lavoro del prodotto in Capgo Enterprise Alternative per plugin di Ionic Enterprise per il workflow del prodotto nelle alternative del Plugin Enterprise Ionic Capgo Alternative per il flusso di lavoro del prodotto in Capgo Alternative Capgo consulenza 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.