Migrer d'AppFlow vers Capgo

🚦 Ionic a annoncé que les produits commerciaux d’AppFlow, y compris les mises à jour en direct, prenaient fin. Les projets existants peuvent être exécutés jusqu’au 31 décembre 2027, mais aucun nouveau client n’est accepté et aucune nouvelle fonctionnalité n’est prévue. Ce guide vous guide à travers les actions requises pour migrer vers Capgo et met en évidence l’automatisation native dont vous bénéficiez.

Aperçu de la migration

Capgo gère les canaux, la conservation des offres groupées, les restaurations, les analyses et les téléchargements CLI pour vous. La migration se résume à l’installation du plugin, à l’appel de CapacitorUpdater.notifyAppReady() et, si vous le souhaitez, à la configuration des commandes manuelles facultatives. Les sections ci-dessous parcourent directement chaque tâche.

Ciblage de versions comme AppFlow

Si vous comptez sur la correspondance de version automatique d’AppFlow (fournir des mises à jour compatibles basées sur la version native), Capgo offre la même fonctionnalité avec un contrôle amélioré. Consultez le Guide de ciblage de versions pour connaître les stratégies détaillées sur la gestion des mises à jour sur plusieurs versions d’application.

## Étape 0 – Capturez votre configuration AppFlow actuelle

• Notez votre AppFlow App ID, vos chaînes existantes et vos clés de signature.
• Exportez tout historique de bundle que vous souhaitez archiver.
• Si vous utilisez GitHub Actions ou un autre fournisseur CI, conservez ces pipelines : ils continueront à fonctionner avec Capgo.

## Étape 1 – Remplacez AppFlow SDK par Capgo

npm uninstall @capacitor/live-updates
npm install @capgo/capacitor-updater
npx cap sync

C’est tout. Capgo regroupe le code natif de iOS et Android ; aucune aide JavaScript supplémentaire n’est requise.

Étape 2 – Configuration minimale (pas de champs manuels)

Le bloc de configuration existant est étendu. Capgo détecte automatiquement votre projet et vos canaux, la configuration minimale est donc :

capacitor.config.ts

import { CapacitorConfig } from '@capacitor/cli'

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      autoDeletePrevious: true,
    },
  },
}

export default config

Référence rapide de configuration

Paramètre Ionic AppFlow	Capgo équivalent	Avez-vous besoin de le définir ?
appId	Géré dans le tableau de bord Capgo	Fourni automatiquement lors de la création du projet
channel / defaultChannel	Règles de chaîne dans le tableau de bord/API	Remplacement facultatif ; les valeurs par défaut proviennent du serveur. Voir Ciblage de versions pour les stratégies multi-versions
autoUpdateMethod	autoUpdate: true	Activé par défaut
maxVersions	Politique de rétention	Configuré de manière centralisée (1 mois par défaut, 24 mois maximum)
enabled	Non requis	Capgo bascule la disponibilité par canal

## Étape 3 – Appelez notifyAppReady() (le seul hook requis)

Dans le guide d’Ionic, vous câblez sync, download et reload, puis masquez l’écran de démarrage manuellement. Capgo effectue ces actions de manière native. Il vous suffit de confirmer que l’application est prête :

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

CapacitorUpdater.notifyAppReady()

Si la confirmation n’arrive jamais, Capgo annule automatiquement le bundle.

C’est tout : Capgo gère les vérifications d’antécédents, la visibilité des éclaboussures et les restaurations pour vous.

Facultatif : exécutez la logique avant que l’écran de démarrage ne se cache

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()

## Étape 4 – Mettre à jour les stratégies traduites

AppFlow documente trois stratégies. Voici comment ils correspondent à Capgo :### Arrière-plan (par défaut)

• AppFlow : configurez autoUpdateMethod = background, appelez sync() manuellement.
• Capgo : activé par défaut. Aucun JavaScript requis.

Toujours le plus récent

• AppFlow : ajoutez un gestionnaire App.addListener('resume') qui télécharge et recharge.
• Capgo : la mise à jour automatique s’exécute déjà à la reprise. Ajoutez le gestionnaire uniquement si vous souhaitez une fenêtre de synchronisation personnalisée.

Facultatif : vérification manuelle de la reprise

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 })
  }
})

Forcer la mise à jour

• AppFlow : invitez l’utilisateur et appelez reload().
• Capgo : marquez le bundle comme « obligatoire » dans le tableau de bord, puis écoutez l’événement majorAvailable (émis après notifyAppReady()) pour inviter ou forcer les utilisateurs à entrer dans votre application.

## Étape 5 – Mappage des appels API

Méthode AppFlow	Capgo équivalent	En avez-vous besoin ?
LiveUpdates.sync()	Géré automatiquement	La mise à jour automatique native de Capgo s’exécute sans appel de synchronisation manuelle
LiveUpdates.download()	CapacitorUpdater.download()	Facultatif pour les flux personnalisés
LiveUpdates.reload()	CapacitorUpdater.set()	Facultatif; les bascules du tableau de bord gèrent les mises à jour forcées
LiveUpdates.getVersion()	CapacitorUpdater.current()	Diagnostic en option

## Étape 6 – Déployer à l’aide de Capgo CLI ou API

Terminez la migration en téléchargeant des bundles avec le Capgo CLI ou API. Le flux de travail reflète ce que vous avez peut-être écrit auparavant, mais inclut désormais des protections natives :

capgo login                # authenticate once
capgo bundle upload \
  --path dist \
  --channel production     # automatically tags platform/version

Déploiements spécifiques à la version (comme AppFlow)

Si vous devez cibler des versions natives spécifiques (similaire au verrouillage de version native d’AppFlow) :

# 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

Consultez le Guide de ciblage de versions pour connaître les stratégies complètes.

Capgo automatiquement :

• Conserve les journaux d’audit au niveau de l’appareil pour chaque installation.
• Envoie des e-mails proactifs lorsque vous approchez des limites du plan.
• Fournit des crédits en rafale afin que vous ne soyez jamais bloqué à mi-version.
• Publie des mesures de latence pour 18 régions du monde sur status.capgo.app/history.

Plugins d’entreprise Ionic

Si votre pile Ionic utilise également des plugins d’entreprise, suivez les documents de migration ciblés ci-dessous. Chaque guide recommande le remplacement de Capgo et les étapes suivantes.

• Migrer depuis Ionic Secure Storage
• Migrer depuis Ionic Auth Connect
• Migrer depuis Ionic Identity Vault

Questions fréquemment posées

Pourquoi AppFlow arrête-t-il les mises à jour en direct ?

Ionic abandonne les produits commerciaux, y compris AppFlow, pour se concentrer sur son framework open source. Les clients existants peuvent continuer à utiliser les mises à jour en direct jusqu’au 31 décembre 2027, mais aucune nouvelle fonctionnalité ni aucun nouveau client ne sont acceptés. Capgo comble cette lacune avec une plateforme OTA native dédiée.

Combien de temps dure la migration ?

La plupart des équipes terminent le déménagement en moins d’une journée. Des concepts tels que les canaux, les déploiements et les règles de publication sont directement mappés, et notre équipe fournit une documentation ainsi qu’une assistance pratique. Dans de nombreux cas, il vous suffit d’installer le plugin, d’appeler notifyAppReady() et de télécharger votre premier bundle.### Allons-nous économiser de l’argent ? Oui. Les mises à jour en direct d’AppFlow commencent à 499 $/mois. Capgo commence à 14 $/mois avec une tarification basée sur l’utilisation qui tombe à environ 0,001 $ par MAU. Vous bénéficiez également d’un cryptage, de restaurations automatiques et d’une surveillance mondiale de la latence.

Quand devons-nous migrer ?

Étant donné qu’AppFlow est désormais en mode maintenance, une migration plus précoce vous donne accès à l’innovation Capgo en cours. Nous vous recommandons de changer lorsque cela correspond à votre calendrier de sortie. Notre équipe d’ingénierie vous aidera à planifier la transition afin que votre CI/CD et vos déploiements continuent de fonctionner.

Ressources supplémentaires

• Guide de ciblage de versions - Découvrez en profondeur les stratégies de correspondance de versions de style AppFlow
• Modifications récentes - Gestion des mises à jour de versions majeures avec les chaînes
• Gestion des canaux - Référence complète de configuration des canaux

Besoin d’aide ?

• Réservez une session de migration : cal.com/team/capgo/demo
• Rejoignez la communauté : Capgo Discord
• Suivre les problèmes/demander des fonctionnalités : github.com/Cap-go/capacitor-updater

Capgo est conçu pour les entreprises qui ont besoin de mises à jour delta natives, de packages chiffrés et d’une innovation continue. Une fois la migration effectuée, vous pouvez supprimer le code de colle AppFlow, vous appuyer sur l’automatisation native et continuer à expédier sans interruption.