Migrate da AppFlow a Capgo

🚦 Ionic ha annunciato che i prodotti commerciali di AppFlow, comprese le aggiornamenti in tempo reale, stanno riducendo la loro attività. 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 mette in evidenza l'automazione nativa che guadagnate.

Panoramica della migrazione

Capgo gestisce i canali, la conservazione dei pacchetti, le annullazioni, le analisi e CLI gli 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 destinazione come AppFlow

Se avete fatto affidamento sulle versioni automatiche di AppFlow (che consegnano aggiornamenti compatibili in base alla versione nativa), Capgo offre la stessa capacità con un controllo migliorato. Vedere il Guida per la versione per strategie dettagliate sul gestione degli aggiornamenti su più versioni dell'applicazione.

Passo 0 – Cattura la tua configurazione attuale di AppFlow

• Nota la tua AppFlow ID App, canali esistenti e chiavi di firma.
• Esporta qualsiasi storia di bundle che desideri archiviare.
• Se stai utilizzando GitHub Azioni o un altro provider CI, conserva quelle pipeline—continueranno a funzionare con Capgo.

Passo 1 – Sostituisci la 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)

Il blocco di configurazione esistente è esteso. 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	Hai bisogno di impostarlo?
appId	Gestito nel dashboard 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 Targeting 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 attiva la disponibilità per canale

Passaggio 3 – Chiamata notifyAppReady() l'unica funzione richiesta

In questo tutorial di Ionic si collega sync, download, e reload, quindi 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 ripristina automaticamente il bundle.

Ecco—Capgo gestisce i controlli in background, la visibilità dello schermo di benvenuto e i ripristini per te.

Facoltativo: eseguire 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 strategie tradotte

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

Background (predefinito)

• AppFlow: configurare autoUpdateMethod = background, chiamare sync() manualmente.
• Capgo: abilitato di default. Nessun codice JavaScript richiesto.

Sempre aggiornato

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

Optional: verifica 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 })
  }
})

Aggiorna forzatamente

• AppFlow: sollecita l'utente e chiama reload().
• Capgo: segna il pacchetto come “obbligatorio” nella dashboard, quindi ascolta per il majorAvailable evento (emesso dopo notifyAppReady()per sollecitare 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()	Gestito automaticamente	Capgo’s aggiornamento auto-nativo esegue senza una chiamata di sincronizzazione manuale
LiveUpdates.download()	CapacitorUpdater.download()	Facoltativo per flussi personalizzati
LiveUpdates.reload()	CapacitorUpdater.set()	Facoltativo; i pulsanti della dashboard gestiscono gli aggiornamenti obbligatori
LiveUpdates.getVersion()	CapacitorUpdater.current()	Diagnostics facoltativi

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 per versione (come AppFlow)

Se hai bisogno di targettizzare versioni native specifiche (simili a quelle di AppFlow con blocco di versione nativa):

# 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 targettizzazione della versione 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 picco per assicurarsi che non venga bloccato 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.

• Migrare da Ionic Auth Connect
• Plugin enterprise Ionic
• 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. I clienti esistenti possono continuare ad utilizzare le 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 primo bundle.

Risparmieremo denaro?

Sì. Le aggiornamenti in tempo reale 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, guadagnerai crittografia, rollback automatico e 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 passaggio in modo che i tuoi CI/CD e le distribuzioni continuino a funzionare.

Risorse aggiuntive

• Guida per la versione di destinazione - Approfondimento delle strategie di matching delle versioni AppFlow
• Cambiamenti significativi - Gestione degli aggiornamenti di versione maggiore con canali
• Gestione dei canali - Riferimento completo di 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 delta nativi, pacchetti crittografati e innovazione continua. Una volta migrato, puoi eliminare la colla AppFlow code, affidarti all'automazione nativa e continuare a distribuire senza interruzioni.

Continua da Migrate from AppFlow to Capgo

Se stai 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, Alternativi per l'Enterprise Plugin di Ionic per il workflow del prodotto negli Alternativi per l'Enterprise Plugin di Ionic Capgo Alternativi per il workflow del prodotto negli Capgo Alternativi Capgo Consulenza per il workflow del prodotto nella Capgo Consulenza, e Capgo Supporto Premium per il workflow del prodotto nel Capgo Supporto Premium.