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 claves de firma.
Exporta cualquier 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 por 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:

Fondo (predeterminado)

AppFlow: configurar autoUpdateMethod = background, llama a 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()) para solicitar o forzar a los usuarios dentro de tu app.

Paso 5 – Mapeo de llamadas a API

Método de AppFlow	Equivalente en Capgo	¿Lo necesitas?
`LiveUpdates.sync()`	Gestionado automáticamente	La auto-actualización nativa de Capgo funciona sin una llamada de sincronización manual
`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 – Despliega 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 automáticamente:

Keeps device-level audit logs for every install.
Envía correos proactivos cuando te acercas a los límites del plan.
Ofrece créditos burst para que nunca te bloqueen a mitad 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 empresariales, sigue la documentación de migración específica a continuación. Cada guía recomienda el reemplazo de Capgo y los siguientes pasos.

Preguntas frecuentes

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

Ionic dejará de ofrecer productos comerciales, incluido AppFlow, para centrarse en su framework open-source. Los clientes actuales pueden seguir usando live updates hasta 31 de diciembre de 2027, pero no se aceptan nuevos clientes ni nuevas funcionalidades. 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 la migración en menos de un día. Conceptos como channels, deployments y release rules se mapean directamente, y nuestro equipo ofrece documentación y soporte práctico. En muchos casos, solo tienes que instalar el plugin, llamar a notifyAppReady(), y subir tu primer bundle.

¿Ahorraremos dinero?

Yes. AppFlow live updates start at $499/mes. Capgo comienza en $14/mes con precios basados en el uso que bajan a aproximadamente $0.001 por MAU. Además, obtienes cifrado, rollbacks automáticos y monitoreo de latencia a nivel mundial.

¿Cuándo deberíamos migrar?

Como AppFlow está ahora en modo de mantenimiento, migrar antes te da acceso a la innovación continua de Capgo. Recomendamos cambiar cuando se ajuste a tu calendario de lanzamientos. Nuestro equipo de ingeniería te ayudará a planificar la transición para que tu CI/CD y tus 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: capgo.app/demo
Únete a la comunidad: Discord de Capgo
Sigue los issues / solicita funciones: github.com/Cap-go/capacitor-updater

Capgo está diseñado para empresas que necesitan delta updates nativos, bundles cifrados e innovación continua. Una vez migres, podrás eliminar el glue de AppFlow code, confiar en la automatización nativa y seguir publicando 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.