Migratez de AppFlow vers Capgo

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

🚦 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 aucun nouveau fonctionnement n'est prévu. 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 CapacitorUpdater.notifyAppReady()et, si souhaité, à la configuration de contrôles manuels optionnels. Les sections ci-dessous décrivent chaque tâche directement.

Étape 0 – Capturer votre configuration actuelle d'AppFlow

Notez votre 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 – Remplacez l'AppFlow SDK par Capgo

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

C'est terminé. Capgo rassemble 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 :

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	Équivalent de Capgo	Est-ce que vous devez 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 masquez l'écran de splash 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 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 documente trois stratégies. Voici comment elles s'appliquent à Capgo:

Arrière-plan (par défaut)

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

Toujours le plus récent

AppFlow: ajoutez un App.addListener('resume') handler qui télécharge et rechargement.
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 de reprise manuelle

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: demandez à l'utilisateur et appelez 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 à l'intérieur de 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 auto 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 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 à une 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
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

Voir le Guide de ciblage de version pour des stratégies complètes.

Capgo automatiquement :

Conservation des journaux d'audit au niveau du dispositif pour chaque installation.
Envoie des emails proactifs lorsque vous approchez des limites de plan.
Fournit des crédits de débit instantanés pour que vous ne soyez jamais bloqué en cours de publication.
Publie les métriques de latence pour 18 régions mondiales à status.capgo.app/history.

Plugins d'entreprise Ionic

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

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 terminent 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 une documentation 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.

Payerons-nous moins cher?

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 maintenant en mode maintenance, migrer plus tôt vous donne accès à l'innovation en cours de Capgo. Nous vous recommandons de passer à la version suivante lorsque cela correspond à votre planning de publication. Notre équipe d'ingénieurs vous aidera à planifier le changement pour que vos CI/CD et 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 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-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 d'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 Entreprise pour le flux de travail du produit dans Capgo Entreprise, Alternatives d'entreprise Ionic pour le flux de travail du produit dans les Alternatives d'entreprise Ionic, Capgo Alternatives pour le flux de travail du produit dans Capgo Alternatives, Capgo Consulting pour le flux de travail du produit dans Capgo Consulting, et Capgo Support Premium pour le flux de travail du produit dans Capgo Support Premium.