Migrer d'AppFlow vers Capgo

Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.

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

Aperçu de la migration

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

Notez votre AppFlow ID de l'app, vos canaux existants et vos clés de signature.
Exportez tout l'historique de bundles que vous souhaitez archiver.
Si vous utilisez GitHub Actions ou un autre fournisseur de CI, conservez ces pipelines — ils continueront de fonctionner avec Capgo.

Étape 1 – Remplacer le SDK d'AppFlow par Capgo

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

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

Étape 2 – Configuration minimale (aucun champ manuel)

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

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	Équivalent Capgo	Doit-on le configurer ?
`appId`	Géré dans le dashboard Capgo	Fourni automatiquement lors de la création du projet
`channel` / `defaultChannel`	Règles de canal dans le dashboard/API	Surcharge optionnelle ; les valeurs par défaut proviennent du serveur. Voir Ciblage de version 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 max)
`enabled`	Non requis	Capgo permet de basculer la disponibilité par canal

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

Dans le guide d'Ionic, vous liez sync, download, et reload, puis masquez manuellement la splash screen. Capgo effectue ces actions nativement. Vous devez seulement confirmer que l'app est prête :

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

CapacitorUpdater.notifyAppReady()

Si la confirmation n'arrive jamais, Capgo effectue un rollback automatique du bundle.

Et voilà — Capgo gère pour vous les vérifications en arrière-plan, la visibilité du splash screen et les rollbacks.

Optionnel : exécuter une logique avant de masquer la splash screen

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 – Stratégies de mise à jour

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

En arrière-plan (par défaut)

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

Toujours la dernière version

AppFlow : ajoutez un App.addListener('resume') handler qui télécharge et recharge.
Capgo: l'auto-update s'exécute déjà au resume. Ajoutez le handler uniquement si vous souhaitez une fenêtre de timing personnalisée.

Optionnel : vérification manuelle au resume

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

AppFlow: demandez à l'utilisateur et appelez reload().
Capgo: marquez le bundle comme « mandatory » dans le dashboard, puis écoutez l' majorAvailable événement (émis après notifyAppReady()) pour inciter ou forcer les utilisateurs dans votre app.

Étape 5 – Mapper les appels API

Méthode AppFlow	Équivalent Capgo	En avez-vous besoin ?
`LiveUpdates.sync()`	Géré automatiquement	L'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

Terminez la migration en envoyant vos bundles avec Capgo CLI ou API. Le workflow est similaire à vos scripts précédents, mais inclut désormais des protections natives :

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

Déploiements par 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
# 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.

Plugins Ionic Enterprise

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.

Foire aux questions

Pourquoi AppFlow arrête-t-il les live updates ?

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.

Combien de temps prend la migration ?

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 ?

Oui. Les live updates d'AppFlow commencent à 499 $/mois. Capgo commence à 14 $/mois avec une tarification à l'usage qui descend à environ 0,001 $ par MAU. Vous bénéficiez aussi du chiffrement, des rollbacks automatiques et du monitoring de latence mondial.

Quand devrions-nous migrer ?

AppFlow étant désormais en mode maintenance, migrer plus tôt vous donne accès à l'innovation continue de Capgo. Nous recommandons de changer selon votre calendrier de release. Notre équipe d'ingénieurs vous aidera à planifier la transition pour que votre CI/CD et vos déploiements continuent de tourner.

Ressources complémentaires

Guide de ciblage de version - Analyse approfondie des stratégies de correspondance de versions de type AppFlow
Breaking changes - Gérer les mises à jour de versions majeures avec les canaux
Gestion des canaux - Référence complète de la configuration des canaux

Besoin d'aide ?

Réservez une session de migration : réserver capgo.app/demo
Rejoignez la communauté : Capgo Discord
Suivre les issues / demander des fonctionnalités : github.com/Cap-go/capacitor-updater

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 »

Si vous utilisez Migrer d'AppFlow vers Capgo pour planifier la migration et les opérations d'entreprise, connectez-l’à Capgo Enterprise 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.