Migrer depuis AppFlow vers Capgo

🚦 Ionic a annoncé que les produits commerciaux d'AppFlow, y compris les mises à jour en direct, sont en cours de fermeture. Les projets existants peuvent fonctionner jusqu'au 31 décembre 2027, but no new customers are accepted and no new features are planned. This guide walks you through the actions required to migrate to Capgo and highlights the native automation you gain.

Vue d'ensemble de la migration

Capgo handles channels, bundle retention, rollbacks, analytics, and CLI uploads for you. Migration boils down to installing the plugin, calling CapacitorUpdater.notifyAppReady()et, si vous le souhaitez, la configuration de contrôles manuels facultatifs.

La cible de version comme AppFlow

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

Étape 0 – Capturer votre configuration actuelle d'AppFlow

• Notez votre ID d'application AppFlow ID d'application AppFlow, les canaux existants et les clés de signature.
• Exporter tout l'historique de bundle que vous souhaitez archiver.
• If vous utilisez des GitHub Actions ou un autre fournisseur CI, conservez ces pipelines — ils continueront de fonctionner avec Capgo.

Étape 1 – Remplacez le flux d'application SDK par Capgo

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

C'est tout. Les Capgo contiennent les code natifs pour les deux iOS et Android ; aucun aideur JavaScript supplémentaire n'est requis.

Étape 2 – Configuration minimale (aucun champ manuel)

La section de configuration existante est extensive. Capgo détecte automatiquement votre projet et vos canaux, donc la configuration minimale est :

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 la configuration

Paramètres d'AppFlow d'Ionic	L'équivalent de Capgo.	Avez-vous besoin de le configurer ?
appId	Géré dans le tableau de bord Capgo.	Automatiquement fourni lors de la création du projet
channel / defaultChannel	Channel rules in the dashboard/API	Optional override; 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'étape 3 – Appel notifyAppReady() (l'unique crochet requis)

, et sync, download, puis masquez l'écran de splash manuellement. __CAPGO_KEEP_0__ effectue ces actions nativement. Vous n'avez besoin que de confirmer que l'application est prête : reload, then hide the splash screen manually. Capgo performs those actions natively. You only need to confirm the app is ready:

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

CapacitorUpdater.notifyAppReady()

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

That’s it—Capgo handles the background checks, splash visibility, and rollbacks for you.

Facultatif : exécuter 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 – Stratégies mises à jour traduites

Les documents d'AppFlow décrivent 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: ajoutez un App.addListener('resume') : téléchargez et rechargez.
• CapgoOptionnel : vérification manuelle du redémarrage

Copier dans le presse-papier

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

Sous-titre « Mettre à jour forcé »

• AppFlow: sollicitez l'utilisateur et appelez reload().
• : Capgo: marquez le bundle comme « obligatoire » dans le tableau de bord, puis écoutez l'événement (émis après majorAvailable ) pour solliciter ou forcer les utilisateurs à l'intérieur de votre application. notifyAppReady()Étape 5 – Cartographie des appels

Step 5 – Mapping API calls

Équivalent de __CAPGO_KEEP_0__	Capgo equivalent	Automatiquement géré
LiveUpdates.sync()	Étape 5 – Cartographie des appels __CAPGO_KEEP_0__	Capgo's mise à jour native s'exécute sans appel de synchronisation manuelle
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()	Diagnostic facultatif

Étape 6 – Déployez à l'aide de Capgo CLI ou API

Terminez la migration en chargeant des ensembles avec Capgo CLI ou API. Le flux reflète ce que vous auriez peut-être scripté avant, mais inclut 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 devez 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
# 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

Voir 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 empêcher d'être bloqué en cours de publication.
• Publie les métriques de latence pour 18 régions mondiales à status.capgo.app/history.

Plugins d'entreprise Ionic

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

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

Questions fréquentes

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

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

How long does migration take?

La plupart des équipes terminent le mouvement en moins d'une journée. Les concepts comme les canaux, les déploiements et les règles de publication se mappent directement, et notre équipe fournit une documentation complétée par un soutien en main de maître. Dans de nombreux cas, vous installez simplement le plugin, appelez notifyAppReady(), et téléchargez votre premier bundle.

Serons-nous en mesure d'économiser de l'argent ?

Oui. Les mises à jour en direct d'AppFlow commencent à $499/mo. Capgo commence à $14/mo avec une tarification basée sur l'utilisation qui chute à environ $0.001 par MAUVous obtenez également l'encryption, les rollbacks automatiques et la surveillance de la latence à l'échelle mondiale.

Quand devons-nous migrer ?

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

Ressources supplémentaires

• Guide de ciblage de version - Profondeur de plongée dans les 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 : book.capgo.app/demo
• Rejoignez la communauté : Capgo Discord
• Suivez les problèmes / demandez des fonctionnalités : github.com/Cap-go/capacitor-updater

Capgo est conçu pour les entreprises qui ont besoin d'actualisations delta natives, de bundles chiffrés et d'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.

Continuez de Migratez de AppFlow à Capgo

Si vous utilisez Migratez de AppFlow vers Capgo pour planifier la migration et les opérations d'entreprise, connectez-l’avec Capgo Entreprise pour le flux de travail du produit dans Capgo Entreprise, Ionic Entreprise Plugin Alternatives pour le flux de travail du produit dans Ionic Entreprise Plugin Alternatives, Capgo Alternatives pour le flux de travail du produit dans Capgo Alternatives, Capgo Conseil pour le flux de travail du produit dans Capgo Conseil, et Capgo Support Premium pour le flux de travail du produit dans Capgo Support Premium.