Migratez depuis AppFlow à Capgo

🚦 Ionic a annoncé que les produits commerciaux d'AppFlow, y compris les mises à jour en direct, sont en cours de fin. 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 rétention des bundles, 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 étape par étape.

Viser la version comme AppFlow

Si vous vous êtes appuyé sur la correspondance 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ôl’amélioré. Consultez le guide de la Guide de ciblage de version pour des stratégies détaillées sur la gestion des mises à jour sur plusieurs versions d'applications.

Étape 0 – Capturer votre configuration actuelle d'AppFlow

• Notez votre AppFlow App ID, canaux 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, conservez ces pipelines – ils continueront à 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 tout. Les Capgo encapsulent les code natifs pour les deux iOS et Android ; aucune aide JavaScript supplémentaire n'est requise.

Étape 2 – Configuration minimale (pas de champs manuels)

La configuration existante est étendue. 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

Équivalent de l'application Ionic AppFlow	L'équivalent de Capgo	Géré dans le tableau de bord du __CAPGO_KEEP_0__
appId	Géré dans le tableau de bord Capgo.	fournis automatiquement lors de la création du projet
channel / defaultChannel	Règles de canal dans le tableau de bord API	Obligatoire pour contourner les valeurs par défaut. Voir Stratégie de ciblage de version pour les stratégies de plusieurs versions
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'unique crochet requis )

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 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 de fond, la visibilité de l'écran d'accueil et les annulations pour vous.

Avant la disparition de l'écran d'accueil, exécutez logique optionnelle

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 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: ajouter un App.addListener('resume') handler qui télécharge et rechargement.
• CapgoSi vous souhaitez soumettre un PR à Capgo, vous devez soumettre un PR à Capgo.

Vérification manuelle facultative

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

Copier dans le presse-papier

• AppFlow: Demandez à l'utilisateur et appelez reload().
• CapgoMarquez le bundle comme “obligatoire” dans l'interface de dashboard, puis écoutez pour le majorAvailable événement (émis après) notifyAppReady()) to prompt or force users inside your app.

É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 s’exécute sans appel de synchronisation manuelle
LiveUpdates.download()	CapacitorUpdater.download()	Facultatif pour les flux personnalisés
LiveUpdates.reload()	CapacitorUpdater.set()	Mise à jour forcée ; les paramètres de tableau de bord la gèrent.
LiveUpdates.getVersion()	CapacitorUpdater.current()	Diagnostic facultatif

Étape 6 – Déploiement à l'aide du 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 inclut maintenant des garanties natives :

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

Déployements spécifiques à une version (comme AppFlow)

Si vous devez cibler des versions natives spécifiques (comme la mise en cache 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 automatiquement :

• Keeps device-level audit logs for every install.
• Envoie des emails proactifs lorsque vous approchez des limites de plan.
• Provides burst credits so you are never blocked mid-release.
• Publie les métriques de latence pour 18 régions mondiales à statut.capgo.app/historique.

Plugins Ionic Enterprise

Si votre stack Ionic utilise également des plugins d'entreprise, suivez les guides 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

Foire aux 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 2027mais 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 mouvement en moins d'une journée. Les concepts comme 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écharger votre premier bundle.

Serons-nous économiser de l'argent ?

Oui. Les mises à jour AppFlow commencent à 499$/mo. Capgo commence à 14$/mo avec un 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 mondiale.

Quand devons-nous migrer ?

Puisque AppFlow est maintenant en mode maintenance, migrer plus tôt vous donne accès à l'innovation en cours de Capgo. Nous recommandons de passer à Capgo lorsque cela convient à 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 - Découvrez en profondeur les stratégies de correspondance de version AppFlow
• Changements majeurs - Gérez les mises à jour de version majeure avec les canaux
• Gestion des canaux - Référence complète de la configuration des canaux

Aidez-vous ?

• Réservez une session de migration: dossier.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 la glue AppFlow code, vous fier à l'automatisation native et continuer à livrer sans interruption.

Continuez de Migratez de AppFlow vers 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 Enterprise, Alternatives de plugins Ionic Enterprise pour le flux de travail du produit dans les alternatives d'Ionic Enterprise Plugin Capgo Alternatives pour le flux de travail du produit dans Capgo Alternatives Capgo Conseil de Consultation 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.