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 fin de commercialisation. 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()La migration se résume à l'installation du plugin, à l'appel de et — si souhaité — à la configuration de contrôles manuels optionnels. Les sections ci-dessous décrivent chaque tâche directement.

Version Ciblage Comme AppFlow

Si vous vous êtes appuyé sur le ciblage automatique de version d'AppFlow (délivrance d'actualisations compatibles en fonction de la version native), Capgo offre la même capacité avec un contrôle renforcé. Consultez le Guide du 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 ID d'application AppFlow ID d'application AppFlow, vos canaux existants et vos clés de signature.
• Exportez toute votre 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. Capgo encapsule 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 zone 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'Ionic AppFlow	équivalent de Capgo	En avez-vous besoin pour le configurer ?
appId	Géré dans le tableau de bord de Capgo	Fourni 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. Consultez Ciblage de version context : Page/zone : Page de marketing de solutions Capgo. Rôle : En-tête de section ou de page. Vu dans : page solutions/version-targeting.astro. Clé de message `solutions_version_targeting_title` (Titre du ciblage de version des solutions). | Page/zone : Page de marketing de solutions Capgo. Rôle : Étiquette de navigation ou élément de menu court. Vu dans : page solutions/version-targeting.astro. Clé de message `solutions_version_targeting` (Ciblage de version des solutions).
autoUpdateMethod	autoUpdate: true	pour des stratégies de versions multiples
maxVersions	Activé par défaut	Politique de conservation des données : 1 mois par défaut, 24 mois maximum
enabled	Not nécessaire	Capgo active ou inactive en fonction du 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 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.

Actualité la plus récente

• AppFlow: ajoutez un App.addListener('resume') traitement qui télécharge et rechargement.
• Capgocontexte : fragment de texte HTML d'une chaîne de Capgo UI plus longue (clé parente `submitting_a_pr_to_capgo`). Page/zone : site Web de marketing de Capgo. Rôle : phrase de site Web. Vu dans : page contributing.astro. Conservez exactement les termes de produit/marque et les termes de développeur de Capgo.

: mise à jour automatique fonctionne déjà lors du redémarrage. Ajoutez le traitement uniquement si vous souhaitez une fenêtre de timing personnalisée.

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

• Section intitulée « Mettre à jour forcé » : AppFlow: Demandez à 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 demander ou forcer les utilisateurs à l'intérieur de votre application. notifyAppReady()Étape 5 – Cartographier les appels

Step 5 – Mapping API calls

Équivalent de	Capgo equivalent	Est automatiquement géré
LiveUpdates.sync()	's mise à jour native sans appel de synchronisation manuel	Capgo’s native auto-update runs without a manual sync call
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 du Capgo CLI ou API

Terminez la migration en téléchargeant des ensembles avec le Capgo CLI ou API. Le flux reflète ce que vous auriez pu scripter 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
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 :

• 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 Ionic Enterprise

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

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

Foire aux questions

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.

Combien de temps prend la migration ?

La plupart des équipes terminent le processus 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écharger votre premier bundle.

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

Oui. Les mises à jour en direct d'AppFlow commencent à $499/mo. Le 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 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 - Gestion des mises à jour de version majeure avec les canaux
• Gestion des canaux - Référence complète de la configuration des canaux

Avez-vous 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

context : « 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 Migrate from AppFlow à Capgo

Si vous utilisez Migrate from AppFlow à Capgo To planer la migration et les opérations d'entreprise, connectez-le avec Capgo Entreprise Pour le flux de travail du produit dans Capgo Entreprise Alternatives de plugin d'entreprise Ionic Pour le flux de travail du produit dans Alternatives de plugin d'entreprise 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 Capgo Support Premium.