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 évidence l'automatisation native que vous obtenez.

Vue d'ensemble de la migration

Capgo gère les canaux, la conservation des lots, 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 souhaité, à la configuration de contrôles manuels optionnels. Les sections ci-dessous décrivent chaque tâche directement.

Conception de version comme AppFlow

Si vous vous êtes appuyé sur la mise à jour automatique de version d'AppFlow (délivrant des mises à jour compatibles en fonction de la version native), Capgo offre la même capacité avec un contrôle renforcé. Consultez le Guide de ciblage 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 configuration d'AppFlow ID d'application, canaux existants et clés de signature.
• Exportez tout historique de bundle que vous souhaitez archiver.
• Si vous utilisez les GitHub Actions ou un autre fournisseur CI, gardez ces pipelines – ils continueront à fonctionner avec Capgo.

Étape 1 – Remplacez l'SDK AppFlow par Capgo

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

C'est tout. Capgo encapsule les code natifs pour les deux iOS et Android; aucune aide JavaScript supplémentaire n'est requise.

Étape 2 – Configuration minimale (aucun champ manuel)

La section de configuration existante est exhaustive. 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ètre d'application Ionic AppFlow	L'équivalent de Capgo	Avez-vous besoin de le configurer ?
appId	Géré dans le tableau de bord Capgo	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() (la seule fonction requise)

Dans la guide d'Ionic, vous connectez sync, download, et reload, puis vous massez l'écran de splash manuellement. Capgo effectue ces actions nativement. Vous n'avez besoin que de 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 splash et les annulations pour vous.

Facultatif : exécutez une logique avant que l'écran de splash 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 décrit trois stratégies. Voici comment elles correspondent à Capgo:

Arrière-plan (par défaut)

• AppFlow: configurer autoUpdateMethod = backgroundappeler sync() manuellement.
• Capgo: activé par défaut. Pas de JavaScript nécessaire.

Toujours le plus récent

• AppFlow: ajoutez un App.addListener('resume') handler qui télécharge et rechargent.
• Capgo: les mises à jour automatiques sont déjà exécutées à la reprise. Ajoutez le gestionnaire uniquement si vous souhaitez une fenêtre de timing personnalisée.

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

Mettre à jour forcé

• AppFlow: interrogez l'utilisateur et appelez reload().
• Capgo: marquez le bundle comme “obligatoire” dans l'interface de dashboard, puis écoutez l'événement (émis après majorAvailable ) pour inviter ou forcer les utilisateurs à l'intérieur de votre application. notifyAppReady()Étape 5 – Cartographie des appels __CAPGO_KEEP_0__

Section intitulée “Étape 5 – Cartographie des appels API”

Équivalent de __CAPGO_KEEP_0__	Capgo equivalent	Géré automatiquement
LiveUpdates.sync()	__CAPGO_KEEP_0__’s mise à jour native s'exécute sans appel de synchronisation manuel	Capgo’s native auto-update runs without a manual sync call
LiveUpdates.download()	CapacitorUpdater.download()	Optionnel; les commutateurs de l'interface de dashboard gèrent les mises à jour forcées
LiveUpdates.reload()	CapacitorUpdater.set()	Step 6 – Handling __CAPGO_KEEP_0__ events
LiveUpdates.getVersion()	CapacitorUpdater.current()	Diagnostics facultatifs

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

Terminez la migration en chargeant des ensembles de fichiers 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.

• Plugins d'entreprise Ionic
• Migratez depuis Ionic Auth Connect
• Migratez depuis Ionic Identity Vault

Questions fréquentes

Pourquoi AppFlow arrête 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 s'appliquent 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échargez votre premier bundle.

Nous économiserons-nous de l'argent ?

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

Quand devrions-nous migrer ?

Puisque AppFlow est désormais en mode maintenance, migrer plus tôt vous donne accès à l'innovation en cours de Capgo.

Ressources supplémentaires

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

Aidez-moi ?

• 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-moteur-de-mise-à-jour

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 le glue AppFlow code, vous fier à l'automatisation native et continuer à livrer sans interruption.

Continuez de Migrer de AppFlow vers Capgo

Si vous utilisez Migrer de AppFlow vers Capgo pour planifier la migration et les opérations d'entreprise, connectez-le avec Capgo Enterprise pour le flux de travail du produit dans Capgo Enterprise, Alternatives de plugin Ionic Enterprise pour le flux de travail du produit dans Alternatives de plugin Ionic Enterprise, Alternatives de Capgo pour le flux de travail du produit dans Alternatives de Capgo, Consultation de Capgo pour le flux de travail du produit dans Consultation de Capgo et Support Premium de Capgo pour le flux de travail du produit dans Support Premium de Capgo.