Migration d'AppFlow vers Capgo

Référence de Configuration AppFlow

Avant la migration, notez votre configuration AppFlow actuelle dans capacitor.config.ts :

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

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

Cette configuration vous aidera à mapper les fonctionnalités d’AppFlow vers leurs équivalents Capgo.

Stratégies de Mise à Jour

Mises à Jour en Arrière-plan (Par Défaut)

Si vous utilisez les mises à jour en arrière-plan d’AppFlow :

// Équivalent Capgo dans capacitor.config.ts
{
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: false,
      autoDeletePrevious: true
    }
  }
}

Mises à Jour Forcées

Si vous utilisez la stratégie de mise à jour forcée d’AppFlow :

// Équivalent Capgo dans capacitor.config.ts
{
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      directUpdate: true,
      keepUrlPathAfterReload: true
    }
  }
}

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

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

CapacitorUpdater.notifyAppReady();

Toujours la Dernière Version

Si vous utilisez la stratégie “always latest” d’AppFlow, implémentez avec 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 });
    }
  });
}

Migration des Méthodes API

Méthode AppFlow	Équivalent Capgo	Notes
sync()	download()	Télécharge les nouvelles mises à jour
reload()	set()	Applique les mises à jour immédiatement
setConfig()	setChannel()	Met à jour la configuration du canal

Exemple de Migration

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

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

Pourquoi migrer vers Capgo ?

Suite à l’annonce concernant Ionic AppFlow, la migration vers Capgo offre une transition fluide pour votre processus de développement d’applications mobiles. Capgo propose des fonctionnalités améliorées, de meilleures performances et des économies significatives tout en maintenant toutes les fonctionnalités essentielles.

Avantages Principaux

• Livraison des mises à jour plus rapide (< 1 minute contre 10 minutes)
• Tarification plus abordable (14$/mois contre 499$/mois)
• Chiffrement de bout en bout inclus dans tous les plans
• Meilleur contrôle des canaux de mise à jour
• Options complètes d’intégration CI/CD

Étapes de Migration

1. Migration des Mises à Jour

Retirer les Dépendances

npm uninstall @ionic/appflow
# Retirer les configurations spécifiques à AppFlow de capacitor.config.json

Installer Capgo

npm install @capgo/capacitor-updater
npx cap sync

Mettre à Jour la Configuration

Ajoutez la configuration Capgo à votre capacitor.config.json :

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

2. Migration CI/CD

Capgo offre des options flexibles :

Option 1 : Utiliser votre CI/CD Existant

Suivez nos tutoriels détaillés :

• Configuration iOS
• Configuration Android
• Intégration GitHub Actions

Option 2 : Service CI/CD

Utilisez notre service géré.

3. Configuration des Canaux

1. Créer des canaux dans le tableau de bord Capgo :

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

2. Configurer les paramètres :

# Canal de production
npx @capgo/cli channel update production --no-downgrade --no-upgrade

# Canal de staging
npx @capgo/cli channel update staging

4. Tests de Migration

1. Tester les Mises à Jour

# Créer un bundle de test
npx @capgo/cli bundle create --channel staging

2. Vérification

• Installer l’application sur un appareil de test
• Vérifier la réception des mises à jour
• Tester le processus d’installation
• Valider la récupération

Résolution des Problèmes

Problèmes Fréquents

Mises à Jour Non Reçues

• Vérifier la configuration des canaux
• Consulter les journaux
• Vérifier la connectivité réseau
• Valider les versions

Prochaines Étapes

1. Créer un compte Capgo
2. Guide de démarrage
3. Intégration CI/CD
4. Configuration des mises à jour

Pour les équipes nécessitant un support dédié, contactez notre équipe.