Migrare da AppFlow a Capgo

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

Panoramica della migrazione

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

Versione di Targetizzazione Come AppFlow

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

Passo 0 – Cattura la tua impostazione corrente di AppFlow

• Nota la tua AppFlow ID App, canali esistenti e chiavi di firma.
• Esporta qualsiasi storia di bundle che vuoi archiviare.
• Se stai utilizzando GitHub Azioni o un altro provider CI, conserva quelle pipeline—continueranno a funzionare 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 pacchetta il code nativo 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 AppFlow di Ionic	L'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	Sostituzione 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 di massimo)
enabled	Non richiesto	Capgo abilita la disponibilità per canale

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

Nella guida di Ionic si collega sync, download, e reload, quindi 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 ripiega automaticamente il pacchetto.

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

Facoltativo: esegui 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 – Aggiorna le strategie tradotte

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

Background (predefinito)

• AppFlowConfigura autoUpdateMethod = background, chiama sync() manualmente.
• Capgo: abilitato di default. Non richiede JavaScript.

Sempre aggiornato

• AppFlow: aggiungi un App.addListener('resume') manipolatore che scarica e ricarica.
• Capgo: l'aggiornamento automatico si esegue già al ripristino. Aggiungi il manipolatore solo se desideri un finestra di timing personalizzata.

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

Forza aggiornamento

• 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 invitare o costringere gli utenti all'interno della tua app.

Passo 5 – Mappatura delle chiamate API

Metodo AppFlow	Capgo equivalente	Hai bisogno di esso?
LiveUpdates.sync()	Trattato automaticamente	Capgo’s auto-aggiornamento nativo funziona senza una chiamata di sincronizzazione manuale
LiveUpdates.download()	CapacitorUpdater.download()	Facoltativo per flussi personalizzati
LiveUpdates.reload()	CapacitorUpdater.set()	Facoltativo; interfacce di dashboard gestiscono aggiornamenti obbligatori
LiveUpdates.getVersion()	CapacitorUpdater.current()	Diagnosi facoltative

Passo 6 – Distribuisci utilizzando il Capgo CLI o API

Completa la migrazione caricando bundle con il Capgo CLI o API. Il workflow riproduce ciò che potresti aver scritto prima, ma ora include salvaguardie 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 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 Versione Guida per la Targetizzazione 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 burst in modo che non si blocchi durante la pubblicazione.
• Pubblica metriche di latenza per 18 regioni globali a status.capgo.app/storia.

Plugin enterprise Ionic

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

• Migra da Ionic Secure Storage
• 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, inclusa 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 di OTA nativa dedicata.

Quanto tempo richiede la migrazione?

La maggior parte delle squadre completa il trasferimento in meno di un giorno. notifyAppReady()I concetti di canali, distribuzioni e regole di rilascio si mappano direttamente, e il nostro team fornisce documentazione più supporto di prima mano.

In molti casi, basta installare il plugin, chiamare

Risparmieremo denaro? Sezione intitolata “Risparmieremo denaro?”. Capgo starts at $499/mo . __CAPGO_KEEP_0__ inizia da $14/mocon un prezzo a consumo che scende a circa

$0.001 per utente attivo al mese (MAU)

Poiché AppFlow è ora in modalità di manutenzione, migrare prima ti dà accesso alle innovazioni in corso Capgo. Raccomandiamo 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 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

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-updater

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 a procedere 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 Imprese per il flusso di lavoro del prodotto in Capgo Imprese, Alternativi per Plugin di Imprese di Ionic per il flusso di lavoro del prodotto in Alternativi per Plugin di Imprese di Ionic, Alternativi a Capgo per il flusso di lavoro del prodotto in Alternativi a Capgo, Consulenza Capgo per il flusso di lavoro del prodotto in Consulenza Capgo, e Supporto Premium di Capgo per il flusso di lavoro del prodotto in Supporto Premium di Capgo.