Migrar de AppFlow a Capgo

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

🚦 Ionic anunció que los productos comerciales de AppFlow —incluyendo Live Updates— dejarán de funcionar. Los proyectos actuales pueden seguir operando hasta 31 de diciembre de 2027, pero no se aceptan nuevos clientes ni se prevén nuevas funciones. Esta guía te explica los pasos necesarios para migrar a Capgo y destaca la automatización nativa que ganas.

Resumen de la migración

Capgo gestiona canales, retención de bundles, rollbacks, analytics y subidas de CLI por ti. La migración consiste en instalar el plugin y llamar a CapacitorUpdater.notifyAppReady(), y —si lo deseas— configurar controles manuales opcionales. Las secciones siguientes explican cada tarea directamente.

Paso 0 – Captura tu configuración actual de AppFlow

Anota tu AppFlow ID de la app, los canales existentes y las llaves de firma.
Exporta el historial de bundles que quieras archivar.
Si usas GitHub Actions u otro proveedor de CI, mantén esos pipelines; seguirán funcionando con Capgo.

Paso 1 – Reemplaza el SDK de AppFlow con Capgo

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

Eso es todo. Capgo empaqueta el code nativo para iOS y Android; no se necesitan helpers de JavaScript adicionales.

Paso 2 – Configuración mínima (sin campos manuales)

El bloque de configuración actual es extenso. Capgo detecta automáticamente tu proyecto y canales, así que la configuración mínima es:

import { CapacitorConfig } from '@capacitor/cli'

const config: CapacitorConfig = {
  plugins: {
    CapacitorUpdater: {
      autoUpdate: true,
      autoDeletePrevious: true,
    },
  },
}

export default config

Referencia rápida de configuración

Ajuste de Ionic AppFlow	Equivalente en Capgo	¿Es necesario configurarlo?
`appId`	Gestionado en el dashboard de Capgo	Se proporciona automáticamente al crear el proyecto
`channel` / `defaultChannel`	Reglas de canal en el dashboard/API	Sobrescritura opcional; los valores por defecto vienen del servidor. Ver Segmentación por versión para estrategias de múltiples versiones
`autoUpdateMethod`	`autoUpdate: true`	Habilitado por defecto
`maxVersions`	Política de retención	Configurado centralmente (1 mes por defecto, 24 meses máx.)
`enabled`	No es necesario	Capgo alterna la disponibilidad por canal

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

En la guía de Ionic, conectas sync, download, y reload, y luego ocultas la splash screen manualmente. Capgo realiza esas acciones de forma nativa. Solo necesitas confirmar que la app está lista:

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

CapacitorUpdater.notifyAppReady()

Si la confirmación nunca llega, Capgo hace un rollback del bundle automáticamente.

Eso es todo: Capgo gestiona los chequeos en segundo plano, la visibilidad del splash y los rollbacks por ti.

Opcional: ejecutar lógica antes de ocultar la splash screen

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

CapacitorUpdater.addListener('appReady', () => {
  // Log diagnostics or run custom code if needed
  SplashScreen.hide()
})

CapacitorUpdater.notifyAppReady()

Paso 4 – Estrategias de actualización traducidas

AppFlow documenta tres estrategias. Así es como se corresponden con Capgo:

Segundo plano (predeterminado)

AppFlow: configurar autoUpdateMethod = background, llamar sync() manualmente.
Capgo: habilitado por defecto. No requiere JavaScript.

Siempre la última

AppFlow: añade un App.addListener('resume') handler que descarga y recarga.
Capgo: el auto-update ya se ejecuta al reanudar. Añade el handler solo si quieres una ventana de tiempo personalizada.

Opcional: comprobación manual al reanudar

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

App.addListener('resume', async () => {
  const bundle = await CapacitorUpdater.download()
  if (bundle) {
    await CapacitorUpdater.set({ id: bundle.id })
  }
})

Forzar actualización

AppFlow: muestra un prompt al usuario y llama a reload().
Capgo: marcar el bundle como “obligatorio” en el dashboard, luego escuchar el majorAvailable evento (emitido tras notifyAppReady()) to prompt or force users inside your app.

Paso 5 – Mapeo de llamadas a API

Método de AppFlow	Equivalente en Capgo	¿Lo necesitas?
`LiveUpdates.sync()`	Gestionado automáticamente	El auto-update nativo de Capgo funciona sin llamadas de sync manuales
`LiveUpdates.download()`	`CapacitorUpdater.download()`	Opcional para flujos personalizados
`LiveUpdates.reload()`	`CapacitorUpdater.set()`	Optional; dashboard toggles handle forced updates
`LiveUpdates.getVersion()`	`CapacitorUpdater.current()`	Diagnósticos opcionales

Paso 6 – Despliegue usando Capgo CLI o API

Finaliza la migración subiendo bundles con Capgo CLI o API. El flujo de trabajo refleja lo que quizá ya tenías en scripts, pero ahora incluye protecciones nativas:

capgo login                # authenticate once
capgo bundle upload \
  --path dist \
  --channel production     # automatically tags platform/version

Despliegues por versión específica (como AppFlow)

Si necesitas apuntar a versiones nativas específicas (similar al bloqueo de versiones nativas de AppFlow):

# Only deliver to devices on native version 2.0.0 or higher
# Channel must use metadata strategy: --disable-auto-update metadata
capgo bundle upload \
  --path dist \
  --channel production \
  --min-update-version "2.0.0"

# Use channels for different major versions
capgo bundle upload --channel v2  # for app version 2.x
capgo bundle upload --channel v3  # for app version 3.x

Consulta la Guía de Version Targeting para estrategias integrales.

Capgo lo hace automáticamente:

Mantiene logs de auditoría a nivel de dispositivo por cada instalación.
Envía correos proactivos cuando te acercas a los límites de tu plan.
Ofrece burst credits para que nunca te bloquees en medio de un release.
Publica métricas de latencia de 18 regiones globales en estado.capgo.app/history.

Plugins de Ionic Enterprise

Si tu stack de Ionic también usa plugins enterprise, sigue las guías de migración específicas abajo. Cada guía recomienda el reemplazo con Capgo y los siguientes pasos.

Preguntas frecuentes

¿Por qué AppFlow dejará de ofrecer Live Updates?

Ionic dejará de comercializar sus productos, incluido AppFlow, para centrarse en su framework de código abierto. Los clientes actuales podrán seguir usando Live Update hasta 31 de diciembre de 2027, pero no se aceptarán nuevos clientes ni funciones. Capgo cubre ese vacío con una plataforma nativa de OTA dedicada.

¿Cuánto tarda la migración?

La mayoría de los equipos completan el cambio en menos de un día. Conceptos como channels, deployments y release rules se mapean directamente, y nuestro equipo ofrece documentación y soporte técnico. En muchos casos, solo tienes que instalar el plugin, llamar a notifyAppReady(), y subir tu primer bundle.

¿Ahorraremos dinero?

Sí. Los live updates de AppFlow empiezan en $499/mes. Capgo empieza en $14/mes con precios basados en el uso que bajan a unos $0.001 por MAU. También obtienes cifrado, rollbacks automáticos y monitoreo de latencia global.

¿Cuándo deberíamos migrar?

Como AppFlow está ahora en modo de mantenimiento, migrar pronto te da acceso a la innovación continua de Capgo. Recomendamos el cambio cuando encaje con tu calendario de lanzamientos. Nuestro equipo de ingeniería te ayudará a planificar la transición para que tu CI/CD y despliegues sigan funcionando.

Recursos adicionales

Guía de Version Targeting - Análisis profundo de estrategias de coincidencia de versiones al estilo AppFlow
Cambios importantes - Gestión de actualizaciones de versiones mayores con channels
Gestión de canales - Referencia completa de configuración de canales

¿Necesitas ayuda?

Reserva una sesión de migración: book.capgo.app/demo
Únete a la comunidad: Discord de Capgo
Reporta errores / solicita funciones: github.com/Cap-go/capacitor-updater

Capgo está diseñado para empresas que requieren Native Build delta, bundles cifrados e innovación continua. Tras migrar, puedes eliminar el glue de AppFlow code, confiar en la automatización nativa y seguir haciendo deploy sin interrupciones.

Continuar desde «Migrar desde AppFlow» a Capgo

Si estás usando Migrar de AppFlow a Capgo para planificar la migración y las operaciones enterprise, conéctalo con Capgo Enterprise para el flujo de trabajo del producto en Capgo Enterprise, Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise, Alternativas a Capgo para el flujo de trabajo del producto en Capgo Alternatives, Consultoría de Capgo para el flujo de trabajo del producto en Capgo Consulting, y Soporte Premium de Capgo para el flujo de trabajo del producto en Capgo Premium Support.