Migrer de Capawesome Cloud vers Capgo

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

⚡️ Capgo automatise les canaux, la suppression des bundles, les retours en arrière, les analyses et les CLI téléchargements natifs. Utilisez ce guide pour effectuer les étapes minimales requises pour migrer et optionnellement recréer tout comportement personnalisé dont vous avez encore besoin.

Vue d'ensemble

Réunissez votre configuration existante de Cloud Capawesome (ID d'application, canaux, clés de signature, CLI jetons) afin que vous puissiez l'archiver ou l'auditer ultérieurement.
Installez le Capgo plugin, supprimez le Capawesome SDK, et appelez CapacitorUpdater.notifyAppReady().
Configurez un comportement optionnel (téléchargements manuels, blocage des bundles, rechargements) si vous vous appuyez sur ces flux aujourd'hui.

Avec Capgo vous n'avez besoin que d'installer notre plugin et d'appeler CapacitorUpdater.notifyAppReady(). Tout le reste—canaux, suppression des bundles, retours en arrière, analyses et CLI automatisation—is géré nativement. Les sections ci-dessous décrivent chaque tâche directement.

Avant de commencer

Assurez-vous que votre projet utilise déjà Capacitor 5 ou une version ultérieure.
Installez le Capgo CLI (npm install -g @capgo/cli) si vous prévoyez de pousser des bundles à partir de CI/CD.

Étape 1 – Installez Capgo et supprimez le Capawesome SDK

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

C'est la seule substitution obligatoire. Le Capgo natif code est livré avec le plugin ; aucun aideur JavaScript supplémentaire n'est requis.

Étape 2 – Configuration minimale

La configuration précédente nécessitait de mapper des dizaines d'options capacitor.config. Capgo reconnaît automatiquement votre projet, donc la configuration minimale ressemble à ceci :

import { CapacitorConfig } from '@capacitor/cli'

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      autoDeletePrevious: true,
      periodCheckDelay: 10 * 60 * 1000, // optional: check every 10 minutes
    },
  },
}

export default config

Tout ce que Capawesome liste comme drapeaux manuels (defaultChannel, autoDeleteBundles, politiques de conservation, etc.) est géré à travers le tableau de bord de Capgo ou API. Vous n'avez besoin de surcharger ces clés que si vous souhaitez un comportement différent des valeurs par défaut de Capgo.

Référence rapide de la configuration

__CAPGO_KEEP_0__ équivalent	Capgo equivalent	Extrait du tableau de bord de __CAPGO_KEEP_0__ dès la création d'un projet
`appId`	Taken from the Capgo dashboard once you create a project	Configuration quick reference
`defaultChannel`	Règles de canal gérées dans le tableau de bord/API	Facultatif; la plupart des équipes définissent cela côté serveur
`autoDeleteBundles`	`autoDeletePrevious: true` (par défaut)	Déjà activé
`publicKey`	Géré dans le console Capgo	Seulement si vous faites tourner les clés manuellement
`maxVersions` / conservation	Politique de conservation du bundle	Configuré centralement dans Capgo (1 mois par défaut, 24 mois maximum)

Étape 3 – Appeler `notifyAppReady()` (la seule fonction requise)

Le flux de travail ancien introduisait des écouteurs personnalisés (checkForUpdates(), retryDownload(), masquant l'écran de splash, etc.). Capgo effectue ces étapes nativement. La seule API que vous devez appeler est :

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

Cela confirme que l'application s'est démarrée avec succès. Si la confirmation ne parvient jamais, Capgo effectue automatiquement le rollback du bundle—pas de JavaScript supplémentaire nécessaire.

C'est tout—Capgo gère les vérifications en arrière-plan, la visibilité de l'écran de splash et les rollbacks nativement.

Facultatif : exécuter une logique personnalisée avant que l'écran de splash ne se cache

import { CapacitorUpdater } from '@capgo/capacitor-updater'
import { SplashScreen } from '@capacitor/splash-screen'

CapacitorUpdater.addListener('appReady', () => {
  // Run diagnostics or logging if you need to
  SplashScreen.hide()
})

CapacitorUpdater.notifyAppReady()

Étape 4 – Cartographier les appels de API (en grande partie facultatif)

Dans Capgo vous laissez généralement l'auto-mise à jour s'exécuter ; les API manuelles restent disponibles si vous souhaitez avoir un contrôle total.

Cloud de Capawesome	Capgo équivalent	Avez-vous besoin de cela?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	Seulement lors de la mise en œuvre de votre propre workflow de téléchargement
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	Optionnel : mise à jour native auto déjà télécharge
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Optionnel : tableau de bord fixe les bundles automatiquement
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Optionnel ; Capgo impose des bundles obligatoires après `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	Diagnostic optionnel

Si vous restez avec le comportement de mise à jour native, vous pouvez supprimer le JavaScript Capawesome entièrement.

Exemples de contrôle manuel

Téléchargez le dernier bundle

import { CapacitorUpdater } from '@capgo/capacitor-updater'

const downloadUpdate = async () => {
  const latest = await CapacitorUpdater.getLatest()
  if (latest?.url) {
    const bundle = await CapacitorUpdater.download({
      url: latest.url,
      version: latest.version,
    })
    console.log('Bundle downloaded', bundle?.id)
  }
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const downloadUpdate = async () => {
  const result = await LiveUpdate.fetchLatestBundle()
  if (result.downloadUrl) {
    await LiveUpdate.downloadBundle({
      bundleId: result.bundleId,
      url: result.downloadUrl,
    })
    console.log('Bundle downloaded')
  }
}

Définir le prochain bundle

import { CapacitorUpdater } from '@capgo/capacitor-updater'

const setNextBundle = async () => {
  await CapacitorUpdater.next({ id: 'bundle-id-123' })
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const setNextBundle = async () => {
  await LiveUpdate.setNextBundle({ bundleId: 'bundle-id-123' })
}

Appliquer le bundle téléchargé immédiatement

import { CapacitorUpdater } from '@capgo/capacitor-updater'

const applyUpdate = async () => {
  await CapacitorUpdater.reload()
}

import { LiveUpdate } from '@capawesome/capacitor-live-update'

const applyUpdate = async () => {
  await LiveUpdate.reload()
}

Étape 5 – Mise à jour des stratégies : la façon dont Capgo les gère

Capawesome décrit trois stratégies. Voici comment elles se traduisent :

Mises à jour en arrière-plan

Flux de travail précédent: configurez-le dans code et planifiez les téléchargements manuellement.
Capgo: activé par défaut (autoUpdate: true). Pas de code supplémentaire nécessaire.

À jour le plus récent

Flux de travail précédent: ajoutez un App.resume écouteur, appelez download, puis set.
Capgo: la mise à jour automatique en arrière-plan effectue déjà la vérification après la reprise. Vous n'avez besoin que de l'écouteur manuel si vous souhaitez une plage d'intervalle personnalisée.

Vérification de reprise facultative

import { App } from '@capacitor/app'
import { CapacitorUpdater } from '@capgo/capacitor-updater'

App.addListener('resume', async () => {
  const latest = await CapacitorUpdater.getLatest()
  if (latest?.url) {
    const downloaded = await CapacitorUpdater.download({
      url: latest.url,
      version: latest.version,
    })
    if (downloaded) {
      await CapacitorUpdater.next({ id: downloaded.id })
    }
  }
})

Mettre à jour de force

Flux de travail précédent: logique de mise en réseau et exigez un rechargement.
Capgo: marquez le bundle comme « obligatoire » dans l'interface utilisateur, puis écoutez l'événement (émis après majorAvailable ) pour obliger les utilisateurs à mettre à jour à l'intérieur de votre application. notifyAppReady()Étape 6 – Déploiement des bundles

Section intitulée « Étape 6 – Déploiement des bundles »

, __CAPGO_KEEP_0__ propose un flux de travail similaire __CAPGO_KEEP_1__ et vous pouvez également automatiser les déploiements entièrement via __CAPGO_KEEP_2__. capawesome live-update deploy, Capgo offers a similar CLI workflow, and you can also automate deployments entirely via API.

# Authenticate once (stores a token in your CI environment)
capgo login

# Upload a new bundle (auto-detects platform/version)
capgo bundle upload --path dist --channel production

Because Capgo tracks bundle health automatically, you also get:

Section intitulée « Étape 6 – Déploiement des bundles »
Rétention automatique (un mois par défaut) avec des limites configurables jusqu'à 24 mois.
Mesures de latence en temps réel à status.capgo.app/history.

Section intitulée « Chronologie de migration »

: 10 minutes (, supprimer l'ancien plugin).npm installConfiguration & prêt
: 5 minutes (Vérifications de santénotifyAppReady).
: 15 minutes (tests manuels optionnels ou écouteurs).__CAPGO_KEEP_0__
Première déploiement: 10 minutes avec Capgo CLI ou intégration CI.

En pratique, les équipes terminent en moins d'une heure. Si vous fournissez les détails du projet Capawesome, nous pouvons même importer les canaux et les listes de périphériques pour vous.

Capgo support

Concierge de migration: réservez une session à book.capgo.app/demo.
Communauté: rejoignez le Capgo Discord.
Suivi des problèmes: github.com/Cap-go/capacitor-mises-à-jour/versions.

Capgo est conçu pour une fiabilité à long terme : des mises à jour delta natives, des ensembles chiffrés, des retours en arrière automatiques et des statistiques qui ne nécessitent pas de JavaScript personnalisé. Une fois que vous avez migré, vous pouvez supprimer le collage lourd à entretenir et laisser la plateforme effectuer les mises à jour automatiquement.

Continuez de Migrer de Cloud Capawesome vers Capgo

Si vous utilisez Migrer de Cloud Capawesome vers Capgo pour planifier l'automatisation CI/CD, connectez-le avec Capgo CI/CD pour le flux de travail du produit dans Capgo CI/CD, Capgo Builds natifs pour le flux de travail du produit dans Capgo Builds natifs, Capgo Intégrations pour le flux de produit dans les intégrations Capgo Intégration CI/CD pour les détails d'implémentation dans l'Intégration CI/CD, et GitHub Actions Integration pour les détails d'implémentation dans les intégrations GitHub Actions