Migrar desde Capawesome Cloud a Capgo

Copie un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.

⚡️ Capgo automatiza canales, limpieza de paquetes, retrocesos, análisis y CLI subida nativa. Utilice esta guía para realizar los pasos mínimos necesarios para migrar y opcionalmente recrear cualquier comportamiento personalizado que aún necesite.

Resumen

Reúna su configuración de Capawesome Cloud existente (ID de aplicación, canales, claves de firma, CLI tokens) para que pueda archivar o auditarlo más tarde.
Instale el Capgo plugin, elimine el Capawesome SDK, y llame CapacitorUpdater.notifyAppReady().
Configure el comportamiento opcional (descargas manuales, pinning de paquetes, recargas) si depende de esos flujos hoy.

Con Capgo solo necesita instalar nuestro plugin y llamar CapacitorUpdater.notifyAppReady()Todo lo demás—canales, limpieza de paquetes, retrocesos, análisis y CLI automatización—se maneja nativamente. Las secciones a continuación recorren cada tarea directamente.

Antes de empezar

Asegúrate de que tu proyecto ya esté utilizando Capacitor 5 o posterior.
Instala el Capgo CLI (npm install -g @capgo/cli) si planeas enviar paquetes desde CI/CD.

Paso 1 – Instala Capgo y elimina el Capawesome SDK

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

Es ese el único intercambio obligatorio. El Capgo nativo code viene con el complemento; no se requieren ayudantes de JavaScript adicionales.

Paso 2 – Configuración mínima

La configuración anterior requería mapear docenas de opciones en capacitor.config. El Capgo reconoce automáticamente tu proyecto, por lo que la configuración mínima se ve así:

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

Todo lo que Capawesome enumera como banderas de manual (defaultChannel, autoDeleteBundles, políticas de retención, etc.) se gestiona a través de la consola de Capgo o API. Solo necesita sobreescribir estas claves si desea un comportamiento que difiera de los valores predeterminados de Capgo.

Referencia rápida de configuración

Equivalente de __CAPGO_KEEP_0__	Capgo equivalent	Tomado de la consola de __CAPGO_KEEP_0__ una vez que cree un proyecto
`appId`	Taken from the Capgo dashboard once you create a project	Reglas de canal gestionadas en la consola/__CAPGO_KEEP_0__
`defaultChannel`	Everything Capawesome lists as manual flags ("", retention policies, etc.) is managed through the API dashboard or __CAPGO_KEEP_1__. You only need to override these keys if you want behaviour that differs from __CAPGO_KEEP_2__’s defaults.	Opcional; la mayoría de los equipos configura esto de forma servidor
`autoDeleteBundles`	`autoDeletePrevious: true` (por defecto)	Ya habilitado
`publicKey`	Administrado en la consola Capgo	Sólo si rotas las claves manualmente
`maxVersions` / retención	Política de retención de paquetes	Configurado centralmente en Capgo (1 mes por defecto, 24 meses máximo)

Paso 3 – Llamar `notifyAppReady()` (el único hook requerido)

El antiguo flujo introdujo oyentes personalizados (checkForUpdates(), retryDownload()Haciendo desaparecer la pantalla de bienvenida, etc.). Capgo realiza esos pasos nativamente. El único API que debes llamar es:

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

CapacitorUpdater.notifyAppReady()

Esto confirma que la aplicación se ha iniciado correctamente. Si nunca llega la confirmación, Capgo realiza automáticamente el rollback del paquete—no se necesita JavaScript adicional.

¡Eso es todo—Capgo gestiona las comprobaciones de fondo, la visibilidad de la pantalla de bienvenida y los rollbacks nativamente.

Opcional: ejecutar lógica personalizada antes de que la pantalla de bienvenida desaparezca

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

Paso 4 – Mapear llamadas a API (en su mayoría opcional)

En Capgo normalmente permites que el actualizador automático se ejecute; las APIs manuales siguen disponibles si deseas tener control total.

Cloud de Capawesome	Capgo equivalente	¿Necesitas esa funcionalidad?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	Sólo cuando implementas tu propio flujo de descarga
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	Opcional: actualización automática nativa ya descarga
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Opcional: la consola de administración pina los bundles automáticamente
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Opcional; Capgo impone bundles obligatorios después de `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	Opcional diagnósticos

Si se mantiene el comportamiento de actualización automática nativa, se puede eliminar el JavaScript de Capawesome por completo.

Ejemplos de control manual

Descargar el último 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')
  }
}

Establecer el siguiente paquete

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

Aplicar el paquete descargado de inmediato

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

Paso 5 – Actualiza las estrategias: cómo Capgo las maneja

Capawesome documenta tres estrategias. Aquí está cómo se traducen:

Actualizaciones de fondo

Anterior flujo de trabajo: configurar en code y programar descargas manualmente.
Capgo: habilitado por defecto (autoUpdate: true). No se requiere ningún code adicional.

Siempre la última versión

Anterior flujo de trabajo: agregar un App.resume escuchador, llamar download, luego set.
Capgo: actualización de fondo ya realiza la comprobación después de la reanudación. Solo necesita el escuchador manual si quiere un intervalo personalizado.

Opcional: comprobación de reanudación manual

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

Actualizar forzoso

Flujo de trabajo anterior: conectar la lógica de la promesa y hacer reloader.
Capgo: Marque el paquete como “obligatorio” en la consola, luego escuche por el majorAvailable evento (empleado después de notifyAppReady()) para que los usuarios actualicen dentro de su aplicación.

Step 6 – Desplegando paquetes

Si anteriormente dependiste de capawesome live-update deploy, Capgo ofrece un flujo de trabajo similar de CLI, y también puedes automatizar los despliegues de forma completa a través de 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

Porque Capgo sigue automáticamente el estado de los paquetes, también obtienes:

Registros de auditoría a nivel de dispositivo para cada instalación.
Retención automática (un mes por defecto) con límites configurables hasta 24 meses.
Metrices de latencia en tiempo real en status.capgo.app/historial.

cronograma de migración

Inventario y instalación: 10 minutos (npm install, eliminar el plugin antiguo).
Configuración y prontitud: 5 minutos (notifyAppReady).
Verificaciones de integridad: 15 minutos (pruebas manuales opcionales o escuchas).
Primera implementación: 10 minutos con Capgo CLI o integración de CI.

En la práctica, los equipos terminan en menos de una hora. Si proporciona detalles del proyecto Capawesome, podemos incluso importar canales y listas de dispositivos para usted.

Capgo de apoyo

Concierge de migración: reserve una sesión en book.capgo.app/demo.
Comunidad: unirse a Capgo Discord.
Seguimiento de problemas: github.com/Cap-go/capacitor-updater/issues.

Capgo está diseñado para una confiabilidad a largo plazo: actualizaciones delta nativas, paquetes cifrados, rollbacks automáticos y análisis que no requieren JavaScript personalizado. Una vez que migres, puedes eliminar el pegamento pesado de mantenimiento y dejar que la plataforma realice actualizaciones automáticamente.

Sigue adelante desde Migrar desde Capawesome Cloud a Capgo

Si estás utilizando Migrar desde Capawesome Cloud a Capgo para planificar la automatización de CI/CD, conectarlo con Capgo CI/CD para el flujo de trabajo del producto en Capgo CI/CD, Capgo Compilaciones Nativas para el flujo de trabajo del producto en Capgo Compilaciones Nativas, Capgo Integraciones para el flujo de trabajo del producto en Capgo Integraciones, Integración CI/CD para los detalles de implementación en Integración CI/CD, y GitHub Integración de Acciones para los detalles de implementación en GitHub Integración de Acciones.