Migrer de AppFlow vers Capgo

Copiez un prompt de configuration avec les étapes d'installation et la 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 train de se ralentir. Les projets existants peuvent continuer 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 avant l'automatisation native que vous obtenez.

Vue d'ensemble de la migration

Gestion des canaux, de la rétention des bundles, des retours en arrière, des analyses et des CLI téléchargements est géré pour vous par Capgo. CapacitorUpdater.notifyAppReady()La migration se résume à l'installation du plugin, à l'appel de

Consultez le

pour des stratégies détaillées sur la gestion des mises à jour à travers plusieurs versions d'applications. Étape 0 – Capturer votre configuration AppFlow actuelleSection intitulée « Étape 0 – Capturer votre configuration AppFlow actuelle »
Exporter l'ensemble de l'historique 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. 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 extensive. 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 Ionic AppFlow	Capgo équivalent	Faut-il 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 de fond, la visibilité de l'écran de démarrage et les annulations pour vous.

Facultatif : exécuter une 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 – Mettre à jour les stratégies traduites

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

Fond (par défaut)

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

Toujours à jour

AppFlowajoutez un App.addListener('resume') gérant qui télécharge et rechargement.
CapgoMise à jour automatique s'exécute déjà lors de la reprise. Ajoutez le gérant uniquement si vous souhaitez une fenêtre de temps 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é

AppFlowDemander à l'utilisateur et appeler reload().
CapgoMettre en surbrillance le bundle comme « obligatoire » dans l'interface de dashboard, puis écouter l'événement (émis après majorAvailable ) pour demander ou forcer les utilisateurs à l'intérieur de votre application. notifyAppReady()Étape 5 – Cartographie des appels __CAPGO_KEEP_0__

Step 5 – Mapping API calls

Méthode AppFlow	L'équivalent de Capgo	En avez-vous besoin ?
`LiveUpdates.sync()`	Traité automatiquement	La mise à jour auto-native de Capgo fonctionne 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 ensembles avec Capgo CLI ou API. Le flux reflète ce que vous auriez peut-être scripté avant, mais inclut maintenant 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)

If vous devez cibler des versions natives spécifiques (similaire à 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 la 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 emails 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 Entreprise

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

Foire aux 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'à 31 décembre 2027mais aucune nouvelle fonctionnalité ou client n'est acceptée. Capgo remplit ce vide avec une plateforme native OTA dédiée.

Combien de temps prend la migration ?

La plupart des équipes terminent le mouvement en moins d'une journée. Les concepts de canaux, de déploiements et de règles de publication s'appliquent directement, et notre équipe fournit une documentation ainsi qu'un 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 capables de faire des économies ?

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 utilisateur actif par mois 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 développement Capgo. Nous vous recommandons de passer à Capacitor 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 - Profondeur d'investigation dans les stratégies de correspondance de version AppFlow
Changements majeurs - Gestion des mises à jour de version majeure avec les canaux
Gestion de canaux - Référence complète de la configuration du 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-mises-à-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 collage AppFlow code, vous fier à l'automatisation native et continuer à livrer sans interruption.

Continuez de Migratez de AppFlow vers Capgo

Si vous utilisez Migrer à partir d'AppFlow vers Capgo pour planifier la migration et les opérations d'entreprise, connectez-le à Capgo Entreprise pour le flux de travail du produit dans Capgo Entreprise, Alternatives d'extension d'entreprise d'Ionic pour le flux de travail du produit dans Alternatives d'extension d'entreprise d'Ionic, 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 le support Premium Capgo.