Migrer de Cloud Capawesome vers Capgo

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

⚡️ Capgo automatiser 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, si nécessaire, recréer tout comportement personnalisé que vous utilisez encore.

Vue d'ensemble

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

Avec Capgo, vous n'avez besoin d'installer que notre plugin et d'appeler CapacitorUpdater.notifyAppReady() Tout le reste—gestion des canaux, nettoyage des bundles, annulations, analytics et CLI automatisation—is traité 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 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 module 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 embarque le code ; aucune aide JavaScript supplémentaire n'est requise.

Étape 2 – Configuration minimale

The previous setup required mapping dozens of options in 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, autoDeleteBundlesla gestion des politiques de rétention, etc.) est géré à travers l'interface de bord de Capgo ou API. Vous n'avez besoin de surcharger ces clés que si vous souhaitez une comportement différent de ceux par défaut de Capgo.

Référence rapide de la configuration

Option de Capawesome	Équivalent de Capgo	Est-ce que vous devez le configurer ?
`appId`	Extrait de la Capgo console dès création d'un projet	Seulement si vous utilisez plusieurs projets dans un même exécutable
`defaultChannel`	Règles de canal gérées dans la console/API	Optional; most teams set this server-side
`autoDeleteBundles`	`autoDeletePrevious: true` (par défaut)	Déjà activé
`publicKey`	Géré dans la console Capgo	Seulement si vous rotatez les clés manuellement
`maxVersions` / conservation	Politique de conservation du bundle	Configuré centralement dans la console Capgo (1 mois par défaut, 24 mois maximum)

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

Le flux de travail ancien a introduit des écouteurs personnalisés (checkForUpdates(), retryDownload(), masquer 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 de fond, la visibilité de l'écran d'accueil et les annulations nativement.

Avant que l'écran d'accueil se cache, vous pouvez exécuter une logique personnalisée.

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

Step 4 – Map API calls (mostly optional)

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 Capawesome	Capgo équivalent	En avez-vous besoin ?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	Only when implementing your own download workflow
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	Optionnel : l'auto-mise à jour native télécharge déjà
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Optionnel : le tableau de bord pince les bundles automatiquement
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Optionnel ; Capgo impose les bundles obligatoires après `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	Diagnostic optionnel

Si vous restez avec le comportement d'auto-mise à jour natif, 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 – Stratégies d'actualisation : comment 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 requis.

Actualité la plus récente

Flux précédent: ajoutez un App.resume écouteur, appelez download, puis set.
CapgoLa mise à jour automatique de fond effectue déjà la vérification après redémarrage. Vous n'avez besoin du listener manuel que si vous souhaitez une plage d'intervalle personnalisée.

Vérification manuelle 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 })
    }
  }
})

Copier dans le presse-papier

Flux précédent: logique de commande et exigez un rechargement.
CapgoMarquez le bundle comme “obligatoire” dans l'interface de dashboard, puis écoutez ensuite pour le majorAvailable event (émis après) notifyAppReady()) to require users to upgrade inside your app.

Étape 6 – Déployer des bundles

Si vous vous êtes auparavant appuyé sur capawesome live-update deploy, Capgo propose un flux de travail similaire CLI et vous pouvez également automatiser les déploiements entièrement 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

Puisque Capgo surveille automatiquement l'état de votre bundle, vous obtenez également :

Device-level audit logs for every install.
Rétention automatique (un mois par défaut) avec des limites configurables jusqu'à 24 mois.
Métriques de latence en temps réel à État.capgo.app/historique.

Calendrier de migration

Inventaire & installation: 10 minutesnpm installSupprimer les anciens plugins).
Configuration & prêt: 5 minutesnotifyAppReady).
Vérifications de base: 15 minutes (optionnelles, tests manuels ou écouteurs).
Première mise en production: 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

__CAPGO_KEEP_0__ supportTitre de section « __CAPGO_KEEP_0__ support » dossier.capgo.app/demo.
CommunityRejoignez la Capgo Discord.
Suivi des problèmes: github.com/Cap-go/capacitor-updater/issues.

Capgo est conçu pour une fiabilité à long terme : mises à jour delta natives, paquets chiffrés, roulements automatiques et analyses qui ne nécessitent pas de JavaScript personnalisé. Une fois que vous avez migré, vous pouvez supprimer les liens de maintenance lourds et laisser la plateforme effectuer les mises à jour automatiquement.

Continuez de Migratez de Capawesome Cloud vers Capgo

Si vous utilisez Migratez de Capawesome Cloud vers Capgo planifier l'automatisation de CI/CD, la connecter 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 Native Builds, les Capgo Intégrations pour le flux de travail du produit dans Capgo Intégrations, Intégration CI/CD pour les détails d'implémentation dans l'Intégration CI/CD, et les GitHub Intégrations d'actions pour les détails d'implémentation dans les GitHub Intégrations d'actions.