Migrer depuis AppFlow vers Capgo

🚦 Ionic a annoncé que les produits commerciaux d'AppFlow, y compris les mises à jour en temps réel, sont en cours de fermeture. Les projets existants peuvent fonctionner 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 avant l'automatisation native que vous obtenez.

Vue d'ensemble de la migration

Capgo gère les canaux, la rétention des paquets, les retours en arrière, les analyses et les CLI téléchargements pour vous. La migration se résume à l'installation du plugin, à l'appel de CapacitorUpdater.notifyAppReady(), et, si vous le souhaitez, à la configuration de contrôles manuels optionnels. Les sections ci-dessous décrivent chaque tâche directement.

Version ciblée comme AppFlow

Si vous vous êtes appuyé sur la version automatique de AppFlow (délivrant des mises à jour compatibles en fonction de la version native), Capgo offre la même capacité avec un contrôle amélioré. Consultez le Guide de la version ciblée pour des stratégies détaillées sur la gestion des mises à jour sur plusieurs versions d'applications.

Étape 0 – Capturer votre configuration actuelle d'AppFlow

• Notez votre configuration d'AppFlow ID d'applicationcanaux existants et clés de signature.
• Exporter toute l'histoire de bundle que vous souhaitez archiver.
• Si vous utilisez des GitHub Actions ou un autre fournisseur CI, gardez ces pipelines ; ils continueront de fonctionner avec Capgo.

Étape 1 – Remplacer l'AppFlow SDK par Capgo

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

That’s it. Capgo bundles the native code for both iOS and Android; no extra JavaScript helpers are required.

__CAPGO_KEEP_0__ rassemble les __CAPGO_KEEP_1__ natifs pour les deux iOS et Android; aucune aide JavaScript supplémentaire n'est requise.

The existing configuration block is extensive. Capgo auto-detects your project and channels, so the minimal configuration is:

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

import { CapacitorConfig } from '@capacitor/cli'

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

export default config

Copier dans le presse-papier

Section intitulée « Référence rapide de la configuration »	Capgo equivalent	__CAPGO_KEEP_0__ équivalent
appId	Managed in the Capgo dashboard	Fourni automatiquement lors de la création du projet
channel / defaultChannel	Règles de canal dans le tableau de bord/API	Remplacement facultatif ; les valeurs par défaut proviennent du serveur. Voir Ciblage de version pour des stratégies multi-version
autoUpdateMethod	autoUpdate: true	Activé par défaut
maxVersions	Politique de conservation	Configuré centralement (1 mois par défaut, 24 mois maximum)
enabled	Non requis	Capgo active la disponibilité par canal

Étape 3 – Appel notifyAppReady() (l'unique crochet requis)

Dans la documentation d'Ionic, vous connectez sync, download, et reload, puis masquez l'écran de démarrage manuellement. Capgo effectue ces actions nativement. Vous n'avez qu'à confirmer que l'application est prête :

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

CapacitorUpdater.notifyAppReady()

Si la confirmation ne parvient jamais, Capgo roule automatiquement le bundle.

C'est tout—Capgo gère les vérifications en arrière-plan, la visibilité de l'écran de démarrage et les annulations pour vous.

Facultatif : exécuter des logiques 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 elles correspondent à Capgo :

Arrière-plan (par défaut)

• AppFlow : configurer autoUpdateMethod = background : appeler sync() manuellement.
• Capgo : activé par défaut. Pas de JavaScript requis.

Toujours à jour

• AppFlow : ajouter un App.addListener('resume') un gestionnaire qui télécharge et rechargement.
• CapgoL'auto-mise à jour s'exécute déjà à la reprise. Ajoutez le gestionnaire uniquement si vous souhaitez une fenêtre de temps personnalisée.

Vérification manuelle facultative

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

Mise à jour forcée

• Flux d'applicationDemander à l'utilisateur et appeler reload().
• Capgo: marquez le bundle comme “obligatoire” dans l'interface de dashboard, puis écoutez pour le majorAvailable événement (émis après) notifyAppReady()Pour inciter ou forcer les utilisateurs à utiliser votre application.

Étape 5 – Cartographie des appels API

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

Étape 6 – Déploiement à 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 auriez pu scripter avant, mais il comprend désormais des garanties 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 avez besoin de cibler des versions natives spécifiques (de même que la 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 version pour des stratégies complètes.

Capgo automatiquement :

• Conserve les journaux d'audit au niveau du dispositif pour chaque installation.
• Envoie des e-mails proactifs lorsque vous approchez des limites de plan.
• Fournit des crédits de débit pour vous permettre de ne jamais être bloqué en cours de publication.
• Publie les métriques de latence pour 18 régions mondiales à status.capgo.app/history.

Plugins Ionic Enterprise

If your Ionic stack also uses enterprise plugins, follow the targeted migration docs below. Each guide recommends the Capgo replacement and the next steps.

• Migrer de Ionic Auth Connect
• Migrer de Ionic Identity Vault
• Plugins d'entreprise Ionic

Foire aux questions fréquentes

Pourquoi AppFlow arrête-t-il les mises à jour en temps réel ?

Ionic met fin aux produits commerciaux, y compris AppFlow, pour se concentrer sur leur framework open-source. Les clients existants peuvent continuer à utiliser les mises à jour en temps réel jusqu'au 31 décembre 2027, mais aucun nouveau fonctionnement ou client n'est accepté. Capgo remplit cette lacune avec une plateforme native OTA dédiée.

Combien de temps faut-il pour la migration ?

La plupart des équipes complètent le déplacement en moins d'une journée. Les concepts tels que les canaux, les déploiements et les règles de publication se mappent directement, et notre équipe fournit des documents ainsi que du soutien en main de maître. Dans de nombreux cas, vous n'avez qu'à installer le plugin, appeler notifyAppReady()et télécharger votre premier bundle.

Nous économiserons-nous de l'argent ?

Oui. Les mises à jour live d'AppFlow commencent à 499 $/mois. Capgo commence à 14 $/mois avec un tarification basée sur l'utilisation qui tombe à environ 0,001 $ par MAU. Vous obtenez également une encryption, des retours automatiques et un suivi de la latence à l'échelle mondiale.

Quand devons-nous migrer ?

Puisque AppFlow est maintenant en mode maintenance, migrer plus tôt vous donne accès à l'innovation Capgo en cours. Nous vous recommandons de passer à la vitesse supérieure lorsque cela correspond à votre planning de publication. Notre équipe d'ingénierie vous aidera à planifier le changement pour que vos CI/CD et vos déploiements continuent de fonctionner.

Ressources supplémentaires

• Guide de ciblage de version - Découverte approfondie des stratégies de correspondance de version AppFlow
• Changements majeurs - Gestion des mises à jour de version majeure avec les canaux
• Gestion de canal - Référence complète de la configuration de canal

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-mises-à-jour

Capgo est conçu pour les entreprises qui nécessitent des mises à jour delta natives, des ensembles chiffrés et une innovation continue. Une fois que vous avez migré, vous pouvez supprimer la glue AppFlow code, vous fier à l'automatisation native et continuer à livrer sans interruption.