Aller au contenu

Migrer d'AppFlow vers Capgo

🚦 Ionic a annoncé l'arrêt progressif des produits commerciaux d'AppFlow, dont Live Updates. Les projets existants peuvent continuer à 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 accompagne dans les étapes nécessaires pour migrer vers Capgo et met en avant l'automatisation native que vous y gagnez.

Capgo gère pour vous les canaux, la conservation des bundles, les rollbacks, les analytics et l'upload de CLI. La migration se résume à installer le plugin, appeler CapacitorUpdater.notifyAppReady(), et — si vous le souhaitez — configurer des contrôles manuels optionnels. Les sections ci-dessous détaillent chaque tâche.

Étape 0 – Capturez votre configuration AppFlow actuelle

Section intitulée « Étape 0 – Capturez votre configuration AppFlow actuelle »
  • Notez votre AppFlow ID de l'app, vos canaux existants et vos clés de signature.
  • Exportez l’historique des bundles que vous souhaitez archiver.
  • Si vous utilisez GitHub Actions ou un autre fournisseur CI, conservez ces pipelines : ils continueront de fonctionner avec Capgo.
Fenêtre de terminal
npm uninstall @capacitor/live-updates
npm install @capgo/capacitor-updater
npx cap sync

C'est tout. Capgo embarque le code natif pour iOS et Android ; aucun helper JavaScript supplémentaire n'est nécessaire.

Étape 2 – Configuration minimale (aucun champ manuel)

Section intitulée « Étape 2 – Configuration minimale (sans champs manuels) »

Le bloc de configuration existant est volumineux. 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
Paramètre Ionic AppFlowÉquivalent CapgoFaut-il le configurer ?
appIdGéré dans le dashboard CapgoFourni automatiquement lors de la création du projet
channel / defaultChannelRègles de canal dans le dashboard/APIRemplacement facultatif ; les valeurs par défaut proviennent du serveur. Voir Ciblage de version pour les stratégies multi-versions
autoUpdateMethodautoUpdate: trueActivé par défaut
maxVersionsPolitique de rétentionConfiguré de manière centralisée (1 mois par défaut, 24 mois max)
enabledNon requisCapgo bascule la disponibilité par canal

Étape 3 – Appeler notifyAppReady() (le seul hook requis)

Section intitulée « Étape 3 – Appeler notifyAppReady() (le seul hook requis) »

Dans le guide d’Ionic, vous configurez sync, download, et reload, puis masquez l’écran de démarrage manuellement. Capgo effectue ces actions nativement. Il vous suffit de confirmer que l’app est prête :

import { CapacitorUpdater } from '@capgo/capacitor-updater'
CapacitorUpdater.notifyAppReady()

Si la confirmation n’arrive jamais, Capgo fait automatiquement un rollback du bundle.

C’est tout — Capgo gère les vérifications en arrière-plan, la visibilité du splash et les rollbacks pour vous.

Facultatif : exécuter du code avant le masquage de l’écran de démarrage
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()

AppFlow décrit trois stratégies. Voici comment elles correspondent à Capgo :

  • AppFlow: configurer autoUpdateMethod = background, appelez sync() manuellement.
  • Capgo: activé par défaut. Aucun JavaScript requis.
  • AppFlow : ajoutez un App.addListener('resume') handler qui télécharge et recharge.
  • Capgo: la mise à jour automatique s’exécute déjà à la reprise. Ajoutez le handler uniquement si vous souhaitez une fenêtre de temps personnalisée.
Facultatif : vérification manuelle à 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 })
}
})
  • AppFlow: demandez à l’utilisateur et appelez reload().
  • Capgo: marquez le bundle comme « obligatoire » dans le dashboard, puis écoutez le majorAvailable événement (émis après notifyAppReady()) pour inciter ou forcer les utilisateurs dans votre app.
Méthode AppFlowÉquivalent CapgoEn avez-vous besoin ?
LiveUpdates.sync()Géré automatiquementL'auto-update natif de Capgo s'exécute sans appel de synchronisation manuel
LiveUpdates.download()CapacitorUpdater.download()Optionnel pour les flux personnalisés
LiveUpdates.reload()CapacitorUpdater.set()Optionnel ; les toggles du dashboard gèrent les mises à jour forcées
LiveUpdates.getVersion()CapacitorUpdater.current()Diagnostics optionnels

Étape 6 – Déployer via le Capgo CLI ou API

Section intitulée « Étape 6 – Déployer avec Capgo CLI ou API »

Terminez la migration en envoyant des bundles avec Capgo CLI ou API. Le workflow reprend ce que vous avez peut-être scripté auparavant, mais intègre désormais des garde-fous natifs :

Fenêtre de terminal
capgo login # authenticate once
capgo bundle upload \
--path dist \
--channel production # automatically tags platform/version

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

Fenêtre de terminal
# Only deliver to devices on native version 2.0.0 or higher
# Channel must use metadata strategy: --disable-auto-update metadata
capgo bundle upload \
--path dist \
--channel production \
--min-update-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 gère automatiquement :

  • Conserve des logs d'audit par appareil pour chaque installation.
  • Envoie des e-mails proactifs lorsque vous approchez des limites de votre plan.
  • Fournit des crédits de secours pour ne jamais être bloqué en pleine release.
  • Publie les métriques de latence pour 18 régions mondiales sur statut.capgo.app/history.

Si votre stack Ionic utilise également des plugins enterprise, suivez les guides de migration spécifiques ci-dessous. Chaque guide recommande le remplacement Capgo et les étapes suivantes.

Ionic abandonne ses produits commerciaux, dont AppFlow, pour se concentrer sur son framework open source. Les clients actuels peuvent continuer à utiliser les live updates jusqu'au 31 décembre 2027, mais aucune nouvelle fonctionnalité ni aucun nouveau client ne sont acceptés. Capgo comble ce vide avec une plateforme OTA native dédiée.

La plupart des équipes terminent la transition en moins d'une journée. Les concepts tels que les canaux, les déploiements et les règles de release sont directement transposables, et notre équipe fournit la documentation ainsi qu'un support concret. Dans de nombreux cas, il suffit d'installer le plugin, d'appeler notifyAppReady(), et d'envoyer votre premier bundle.

Allons-nous faire des économies ?

Section intitulée « Allons-nous économiser ? »

Oui. Les live updates d’AppFlow commencent à 499 $/mois. Capgo commence à 14 $/mois avec une tarification à l’usage qui descend à environ 0,001 $ par utilisateur actif mensuel (MAU). You also gain encryption, automatic rollbacks, and worldwide latency monitoring.

Comme AppFlow est désormais en mode maintenance, migrer plus tôt vous donne accès à l’innovation continue de Capgo. Nous vous recommandons de basculer lorsque cela correspond à votre calendrier de release. Notre équipe d’ingénierie vous aidera à planifier la transition pour que vos CI/CD et vos déploiements continuent de fonctionner.

Capgo est conçu pour les entreprises qui ont besoin de delta updates natifs, de bundles chiffrés et d'innovation continue. Une fois la migration effectuée, vous pouvez supprimer le code glue AppFlow code, vous appuyer sur l'automatisation native et continuer à livrer sans interruption.

Continuer après « Migrer d'AppFlow vers Capgo »

Section intitulée « Continuer après Migrer d'AppFlow vers Capgo »

Si vous utilisez Migrer d'AppFlow vers Capgo pour planifier la migration et les opérations d'entreprise, connectez-l’à Capgo Entreprise pour le workflow produit dans Capgo Enterprise, Alternatives aux plugins Ionic Enterprise pour le workflow produit dans les alternatives aux plugins Ionic Enterprise, Alternatives Capgo pour le workflow produit dans les alternatives Capgo, Conseil Capgo pour le workflow produit dans Capgo Consulting, et Support Premium Capgo pour le workflow produit dans Capgo Premium Support.