Migrate from AppFlow a Capgo
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
🚦 Ionic ha annunciato che i prodotti commerciali di AppFlow, tra cui le Aggiornamenti in tempo reale, sono in via di chiusura. 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
Sottosezione intitolata “Panoramica della migrazione”Capgo gestisce i canali, la conservazione dei pacchetti, le annullazioni e le CLI analisi e le pubblicazioni 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.
Passo 0 – Cattura la tua configurazione attuale di AppFlow
Sezione intitolata “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 Actions o un altro provider CI, conserva quelle pipeline—continueranno a funzionare con Capgo.
Passo 1 – Sostituisci l'AppFlow SDK con Capgo
Sezione intitolata “Passo 1 – Sostituisci l'AppFlow SDK con Capgo”npm uninstall @capacitor/live-updatesnpm install @capgo/capacitor-updaternpx cap syncEcco fatto. Capgo compatta il nativo code per iOS e Android; non sono necessarie aiuto JavaScript aggiuntivi.
Passo 2 – Configurazione minima (nessun campo manuale)
Sottosezione intitolata “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 è:
import { CapacitorConfig } from '@capacitor/cli'
const config: CapacitorConfig = { plugins: { CapacitorUpdater: { autoUpdate: true, autoDeletePrevious: true, }, },}
export default configRiferimento rapido alla configurazione
Sottosezione intitolata “Riferimento rapido alla configurazione”| Impostazione AppFlow di Ionic | L'equivalente di Capgo | Avete 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 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 attiva la disponibilità per canale |
Passo 3 – Chiamata notifyAppReady() (l'unico hook richiesto)
Sottosezione intitolata “Passo 3 – Chiamata notifyAppReady() (l'unico hook richiesto)”In questo tutorial di Ionic si collega sync, download, e reload, quindi nasconde lo schermo di avvio 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 fa rotolare automaticamente il pacchetto.
È tutto—Capgo gestisce le verifiche in background, la visibilità dello schermo di avvio e i rollback per conto tuo.
Facoltativo: eseguire logica prima che lo schermo di avvio 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
Sezione intitolata “Step 4 – Strategie di aggiornamento tradotte”L'AppFlow documenta tre strategie. Ecco come si mappano a Capgo:
Background (predefinito)
Sezione intitolata “Background (predefinito)”- AppFlow: configurare
autoUpdateMethod = background, chiamaresync()manualmente. - Capgo: abilitato di default. Non richiede JavaScript.
Sempre aggiornato
Sezione intitolata “Sempre aggiornato”- targetLanguageItalian
App.addListener('resume')protectedTokens - CapgoCapacitor
GitHub
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 }) }})code
API- SDKCLI
reload(). - npm","bun","texts","Flusso dell'applicazione",": aggiungi un","manipolatore che scarica e ricarica.","Capgo",": le aggiornamenti automatici si eseguono già alla ripresa. Aggiungi il manipolatore solo se desideri una finestra di timing personalizzata.","Facoltativo: controllo di ripresa manuale","Copia negli appunti","Aggiorna forzatamente","Sezione intitolata “Aggiorna forzatamente”","Flusso dell'applicazione",": sollecita l'utente e chiama","Capgo"]}: segnala il bundle come “obbligatorio” nella dashboard, poi 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__
Sezione intitolata “Passo 5 – Mappatura delle chiamate API”
Section titled “Step 5 – Mapping API calls”| Corrispettivo di __CAPGO_KEEP_0__ | Capgo equivalent | Trattato automaticamente |
|---|---|---|
LiveUpdates.sync() | __CAPGO_KEEP_0__’s aggiornamento auto-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() | Step 5 – Mapping __CAPGO_KEEP_0__ calls |
LiveUpdates.getVersion() | CapacitorUpdater.current() | Diagnostics facoltativi |
Passo 6 – Distribuisci utilizzando il Capgo CLI o API
Sezione intitolata “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 oncecapgo bundle upload \ --path dist \ --channel production # automatically tags platform/versionDistribuzioni specifiche della versione (come AppFlow)
Sezione intitolata “Distribuzioni specifiche della versione (come AppFlow)”Se hai bisogno di targettizzare versioni native specifiche (simili alla bloccatura della versione nativa di AppFlow):
# Only deliver to devices on native version 2.0.0 or highercapgo bundle upload \ --path dist \ --channel production \ --native-version "2.0.0"
# Use channels for different major versionscapgo bundle upload --channel v2 # for app version 2.xcapgo bundle upload --channel v3 # for app version 3.xVedi il Guida per la versione Targeting 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 burst per cui non si viene mai bloccati 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 qui sotto. Ogni guida consiglia la sostituzione __CAPGO_KEEP_0__ e i passaggi successivi.If your Ionic stack also uses enterprise plugins, follow the targeted migration docs below. Each guide recommends the Capgo replacement and the next steps.
Domande frequenti
Sottosezione intitolata “Domande frequenti”Perché AppFlow sta interrompendo le aggiornamenti in tempo reale?
Sottosezione intitolata “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 copre questo gap con una piattaforma nativa OTA dedicata.
Quanto tempo richiede la migrazione?
Sottosezione intitolata “Quanto tempo richiede la migrazione?”La maggior parte delle squadre completa il trasferimento in meno di un giorno. I 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 e chiamare notifyAppReady()Esegui l'upload del tuo primo bundle.
Salveremo denaro?
Scheda intitolata “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?
Scheda intitolata “Quando dobbiamo migrare?”Poiché AppFlow è ora in modalità di manutenzione, l'aggiornamento più presto ti darà 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 passaggio in modo che il tuo CI/CD e le tue distribuzioni continuino a funzionare.
Risorse aggiuntive
Sottosezione intitolata “Risorse aggiuntive”- Guida per la versione di destinazione - Profondità in AppFlow-style version matching strategie
- Cambiamenti significativi - Gestione degli aggiornamenti di versione principale con canali
- Gestione dei canali - Riferimento completo di configurazione dei canali
Hai bisogno di aiuto?
Sottosezione intitolata “Hai bisogno di aiuto?”- Prenota una sessione di migrazione: book.capgo.app/demo
- Unisciti alla community: Capgo Discord
- Segui le questioni / richiedi funzionalità: github.com/Cap-go/capacitor-aggiornamento
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 spedire senza interruzioni.
Continua a procedere da Migra da AppFlow a Capgo
Sottosezione intitolata “Continua a procedere da Migra da AppFlow a Capgo”Se stai utilizzando Migra da 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.