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 automates les canaux, la suppression des bundles, les retours en arrière, les analyses et CLI télécharge des fichiers natively. 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 existante de Capawesome (ID d'application, canaux, clés de signature, CLI jetons) afin que vous puissiez l'archiver ou l'auditer ultérieurement.
Installez le plugin Capgo, supprimez le Capawesome SDK et appelez CapacitorUpdater.notifyAppReady().
Configurez les comportements facultatifs (téléchargements manuels, blocage 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—canaux, nettoyage du paquet, annulations, analytics et CLI automatisme—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 envoyer des paquets à partir de CI/CD.

Étape 1 – Installez Capgo et supprimez le plugin 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 embarque le plugin ; aucune aide JavaScript supplémentaire n'est requise.

Étape 2 – Configuration minimale

La configuration précédente nécessitait la mise en correspondance de dizaines d'options dans 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 politique de conservation, etc.) est géré à travers le tableau de bord Capgo ou API. Vous n'avez besoin de surcharger ces clés que si vous souhaitez une comportement qui diffère des valeurs par défaut de Capgo.

Référence de configuration rapide

Option Capawesome	Équivalent Capgo	Avez-vous besoin de le configurer ?
`appId`	Cela provient du tableau de bord Capgo dès la création d'un projet	Seulement si vous utilisez plusieurs projets dans un seul exécutable
`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 roulez les clés manuellement
`maxVersions` / conservation	Politique de conservation du paquet	Configuré centralement dans Capgo (1 mois par défaut, 24 mois maximum)

Étape 3 – Appel `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 un 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 API (pour la plupart facultatifs)

In Capgo vous laissez généralement fonctionner l'actualisation automatique ; les API manuelles restent disponibles si vous souhaitez avoir un contrôle total.

Capawesome Cloud	Capgo équivalent	En avez-vous besoin ?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	Seulement lors de la mise en œuvre de votre propre flux de téléchargement
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	Optionnel : l'actualisation automatique native télécharge déjà
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Optionnel : les panneaux de dashboard pin les bundles automatiquement
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Optionnel ; Capgo impose les bundles obligatoires après `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	Optionnel diagnostics

Si vous maintenez le comportement d'actualisation automatique native, vous pouvez supprimer le JavaScript Capawesome entièrement.

Exemples de contrôle manuel

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

Configurer 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 : la façon dont Capgo les gère

Les documents de Capawesome décrivent trois stratégies. Voici comment elles sont traduites :

Mises à jour en arrière-plan

Flux de travail précédent: configurez-le dans code et planifiez les téléchargements manuellement.
Capgocontext : fragment de texte HTML d'une chaîne de saisie Capgo plus longue (clé parente `submitting_a_pr_to_capgo`). Page/zone : site Web de marketing Capgo. Rôle : phrase de site Web. Vu dans : page contributing.astro. Conservez les termes de produit/marque et les termes de développeur exacts. Clé de message `submitting_a_pr_to_capgo` (Soumettre Un Pr À Capgo).autoUpdate: truePas de mise à jour supplémentaire code requise.

Toujours à jour

Flux de travail précédent: ajoutez un App.resume écouteur, appelez download, puis set.
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 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 de fond 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.

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 : mise à jour forcée

Flux de travail précédent: logique de requête en câble et exigez un rechargement.
CapgoSection intitulée « Étape 6 – Déploiement de bundles » majorAvailable Si vous vous êtes auparavant appuyé sur notifyAppReady()__CAPGO_KEEP_0__ offre un flux de travail similaire __CAPGO_KEEP_1__ et vous pouvez également automatiser les déploiements entièrement via __CAPGO_KEEP_2__.

Fenêtre de terminal

: logique de requête en câble et exigez un rechargement. 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

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

Journaux d'audit au niveau du dispositif pour chaque installation.
Rétention automatique (un mois par défaut) avec des limites configurables jusqu'à 24 mois.
Métriques de latence en temps réel à status.capgo.app/history.

Calendrier de migration

Inventaire & installation : 10 minutes (npm install, supprimer l'ancien plugin).
Config & prêt : 5 minutes notifyAppReady).
Sanité des données : 15 minutes (tests ou écouteurs manuels facultatifs).
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

Médiation de la migration : réservez une session à book.capgo.app/demo.
Communauté: rejoignez-vous 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 gérer les mises à jour automatiquement.

Continuez de Migrate from Capawesome Cloud à Capgo

Si vous utilisez Migrate from Capawesome Cloud à Capgo pour planifier l'automatisation de CI/CD, connectez-l’avec Capgo CI/CD pour le flux de travail du produit dans Capgo CI/CD, Capgo Bâtiments natifs pour le flux de travail du produit dans Capgo Bâtiments natifs Capgo Intégrations pour le flux de travail du produit dans Capgo Intégrations Intégration CI/CD pour le détail d'implémentation dans Intégration CI/CD, et GitHub Intégration d'actions pour le détail d'implémentation dans GitHub Intégration d'actions.