Migrazione da AppFlow a Capgo

Riferimento alla Configurazione AppFlow

Prima della migrazione, prendi nota della tua configurazione AppFlow attuale in capacitor.config.ts:

import { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    LiveUpdates: {
      appId: 'your-app-id',
      channel: 'Production',
      autoUpdateMethod: 'background', // oppure 'always latest', 'force update'
      maxVersions: 2
    }
  }
};

Questa configurazione ti aiuterà a mappare le funzionalità di AppFlow con gli equivalenti di Capgo.

Strategie di Aggiornamento

Aggiornamenti in Background (Predefinito)

Se stai utilizzando gli aggiornamenti in background di AppFlow:

// Equivalente Capgo in capacitor.config.ts
{
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false,
      autoDeletePrevious: true
    }
  }
}

Aggiornamenti Forzati

Se stai utilizzando la strategia di aggiornamento forzato di AppFlow:

// Equivalente Capgo in capacitor.config.ts
{
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: true,
      keepUrlPathAfterReload: true
    }
  }
}

// Codice JavaScript richiesto
import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { SplashScreen } from '@capacitor/splash-screen';

CapacitorUpdater.addListener('appReady', () => {
  SplashScreen.hide();
});

CapacitorUpdater.notifyAppReady();

Sempre l’Ultima Versione

Se stai utilizzando la strategia “always latest” di AppFlow, implementa con Capgo:

import { CapacitorUpdater } from '@capgo/capacitor-updater';
import { App } from '@capacitor/app';

async function setupAlwaysLatest() {
  App.addListener('resume', async () => {
    const result = await CapacitorUpdater.download({
      url: 'your-update-url'
    });
    if (result) {
      await CapacitorUpdater.set({ id: result.id });
    }
  });
}

Migrazione dei Metodi API

Metodo AppFlow	Equivalente Capgo	Note
`sync()`	`download()`	Scarica nuovi aggiornamenti
`reload()`	`set()`	Applica gli aggiornamenti immediatamente
`setConfig()`	`setChannel()`	Aggiorna la configurazione del canale

Esempio di Migrazione

// Codice AppFlow
import * as LiveUpdates from '@capacitor/live-updates';
const result = await LiveUpdates.sync();
if (result.activeApplicationPathChanged) {
  await LiveUpdates.reload();
}

// Equivalente Capgo
import { CapacitorUpdater } from '@capgo/capacitor-updater';
const bundle = await CapacitorUpdater.download({
  url: 'your-update-url'
});
if (bundle) {
  await CapacitorUpdater.set({ id: bundle.id });
}

Perché migrare a Capgo?

Con l’annuncio della chiusura di Ionic AppFlow, la migrazione a Capgo offre una transizione perfetta per il tuo flusso di lavoro di sviluppo di app mobili. Capgo offre funzionalità migliorate, prestazioni superiori e significativi risparmi sui costi mantenendo tutte le funzionalità critiche necessarie.

Vantaggi Principali

Distribuzione degli aggiornamenti più veloce (< 1 minuto vs 10 minuti)
Prezzi più convenienti (14$/mese vs 499$/mese)
Crittografia end-to-end inclusa in tutti i piani
Maggiore controllo sui canali di aggiornamento
Opzioni complete di integrazione CI/CD

Passaggi di Migrazione

1. Migrazione degli Aggiornamenti Live

Rimuovere le Dipendenze Precedenti

npm uninstall @ionic/appflow
# Rimuovere le configurazioni specifiche di AppFlow da capacitor.config.json

Installare Capgo

npm install @capgo/capacitor-updater
npx cap sync

Aggiornare la Configurazione

Aggiungi la configurazione Capgo al tuo capacitor.config.json:

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": true
    }
  }
}

2. Migrazione CI/CD

Capgo offre opzioni flessibili per CI/CD:

Opzione 1: Usa il tuo CI/CD Esistente

Segui i nostri tutorial dettagliati per configurare CI/CD con piattaforme popolari:

Opzione 2: CI/CD Gestito

Lascia che gestiamo noi la tua configurazione CI/CD con il nostro servizio gestito.

3. Configurazione dei Canali

Creare canali nella dashboard Capgo:

npx @capgo/cli channel create production
npx @capgo/cli channel create staging

Configurare le impostazioni dei canali:

# Configurare il canale di produzione
npx @capgo/cli channel update production --no-downgrade --no-upgrade

# Configurare il canale di staging
npx @capgo/cli channel update staging

4. Test della Migrazione

Testare gli Aggiornamenti Live

# Creare e caricare un bundle di test
npx @capgo/cli bundle create --channel staging

Verificare la Ricezione degli Aggiornamenti

Installare l’app su un dispositivo di test
Verificare che gli aggiornamenti vengano ricevuti correttamente
Verificare il processo di installazione degli aggiornamenti
Testare la funzionalità di ripristino

Risoluzione dei Problemi

Problemi Comuni

Aggiornamenti Non Ricevuti

Verificare la configurazione dei canali
Controllare i log del dispositivo
Assicurare una connettività di rete adeguata
Validare il formato della versione del bundle

Prossimi Passi

Crea un account Capgo
Segui la nostra guida rapida
Configura l’integrazione CI/CD
Configura gli aggiornamenti live

Per i team aziendali che richiedono supporto dedicato durante la migrazione, programma una chiamata con il nostro team.