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:

• Configurazione Build iOS
• Configurazione Build Android
• Integrazione GitHub Actions

Opzione 2: CI/CD Gestito

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

3. Configurazione dei Canali

1. Creare canali nella dashboard Capgo:

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

2. 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

1. Testare gli Aggiornamenti Live

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

2. 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

1. Crea un account Capgo
2. Segui la nostra guida rapida
3. Configura l’integrazione CI/CD
4. Configura gli aggiornamenti live

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