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 complemento.

⚡️ Capgo automatiza los canales, la limpieza de paquetes, los reversiones, las métricas y CLI sube archivos nativamente. 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 Cloud de Capawesome 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 a CapacitorUpdater.notifyAppReady().
Configure el comportamiento opcional (descargas manuales, pin de paquetes, recargas) si depende de esos flujos hoy.

With Capgo solo necesitas instalar nuestro plugin y llamar CapacitorUpdater.notifyAppReady()Todas las demás tareas—canales, limpieza de paquetes, deshacer, análisis y CLI automatización—se manejan 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 plugin de Capawesome SDK

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

Es el único intercambio obligatorio. Capgo incluye nativamente code; no se requieren ayudantes de JavaScript adicionales.

Step 2 – Configuración mínima

La configuración anterior requería la mapeación de docenas de opciones en capacitor.config. 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

Todas las opciones de Capawesome que se enumeran como flags manuales (defaultChannel, autoDeleteBundlespolíticas de retención, etc.) se gestionan a través de la consola de Capgo o API. Solo necesitas sobrescribir estas claves si deseas un comportamiento que difiera de los valores predeterminados de Capgo.

Referencia rápida de configuración

Opción de Capawesome	equivalente de Capgo	¿Necesita configurarlo?
`appId`	Tomado desde la consola de Capgo una vez que se crea un proyecto	Solo si utiliza varios proyectos en un binario
`defaultChannel`	Reglas de canal administradas en la consola/API	Opcional; la mayoría de los equipos configuran esto de forma servidor
`autoDeleteBundles`	`autoDeletePrevious: true` (por defecto)	Ya está habilitado
`publicKey`	Administrado en la consola de Capgo	Solo si rota 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)

Etapas 3 – Llamar `notifyAppReady()` (el único gancho requerido)

El flujo de trabajo antiguo introdujo oyentes personalizados (checkForUpdates(), retryDownload(), ocultar 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()

Esta confirma que la aplicación se ha iniciado correctamente. Si la confirmación nunca llega, Capgo realiza automáticamente un rollback del paquete—sin necesidad de JavaScript adicional.

Eso es todo—Capgo gestiona los controles 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 se oculte

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

Etapas 4 – Mapear llamadas a API (principalmente opcional)

In Capgo normalmente dejas que se ejecute el actualizador automático; las API manuales siguen disponibles si deseas tener control total.

Capawesome Cloud	Capgo equivalente	¿Necesitas?
`LiveUpdate.fetchLatestBundle()`	`CapacitorUpdater.getLatest()`	Sólo cuando implementas tu propio flujo de descarga
`LiveUpdate.downloadBundle()`	`CapacitorUpdater.download()`	Opcional: el actualizador automático nativo ya descarga automáticamente
`LiveUpdate.setNextBundle()`	`CapacitorUpdater.next()`	Opcional: el panel de control pina los paquetes automáticamente
`LiveUpdate.reload()`	`CapacitorUpdater.reload()`	Opcional; Capgo impone paquetes obligatorios después de `notifyAppReady()`
`LiveUpdate.getCurrentBundle()`	`CapacitorUpdater.current()`	Opcional diagnósticos

Si te quedas con el comportamiento de actualización automática nativa, puedes eliminar el JavaScript de Capawesome por completo.

Ejemplos de control manual

Descargar el último paquete

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 próximo 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 – Estrategias de actualización: 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.
Capgocontexto: texto fragmento de HTML de una cadena de Capgo UI más larga (clave de página `submitting_a_pr_to_capgo`). Página/área: sitio web de marketing de Capgo. Rol: oración de sitio web. Visto en: página contributing.astro. Preservar términos de producto/marca y términos de desarrollador exactamente. Clave de mensaje `submitting_a_pr_to_capgo` (Submitting A Pr To Capgo).autoUpdate: trueNo se requiere ningún code adicional.

Siempre actualizado

Flujo de trabajo anterior: agregar un App.resume escuchador, llamar a download, luego set.
Capgocontexto: fragmento de texto HTML de una cadena de Capgo UI más larga (clave de página `submitting_a_pr_to_capgo`). Página/área: sitio web de marketing de Capgo. Rol: copia de sitio web. Visto en: página contribuyendo.astro. Conservar términos de producto/marca y de desarrollador de Capgo exactamente. Clave de mensaje `submitting_a_pr_to_capgo` (Enviar Un Pr A Capgo).

: actualización de fondo auto actualiza ya realiza la comprobación después de reanudar. Solo necesita el escuchador manual si quiere un intervalo personalizado.

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

Copiar a portapapeles (clipboard en inglés, pero se traduce a portapapeles en español, ya que es más común en español).

Flujo de trabajo anterior: lógica de la promoción de cables y la reutilización de carga.
CapgoSi está enviando una solicitud de extracción a __CAPGO_KEEP_0__. majorAvailable : marcar el paquete como “obligatorio” en la consola, luego escuchar para el notifyAppReady()evento (empleado después de

) para que los usuarios actualicen dentro de su aplicación.

Sección titulada “Etapa 6 – Desplegando paquetes” capawesome live-update deploySi anteriormente dependía de Capgo, Capgo ofrece un flujo de trabajo similar de CLI, y también puede automatizar los despliegues completamente 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 monitorea automáticamente la salud del paquete, 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.
Métricas de latencia en tiempo real en status.capgo.app/history.

Cronograma de migración

Inventario & instalación: 10 minutos (npm install, eliminar el antiguo plugin).
Config & preparación5 minutosnotifyAppReady).
Verificaciones de integridad15 minutos (pruebas manuales opcionales o escuchas).
Primera implementación: 10 minutes with Capgo CLI or CI integration.

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 soporte

Concierge de migración: reservar una sesión en : reservar una sesión en capgo.app/demo.
Comunidad: unirte 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 hayas migrado, 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, conecta 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 el detalle de implementación en Integración CI/CD, y GitHub Integración de Acciones para el detalle de implementación en GitHub Integración de Acciones.