Migrar desde AppFlow a Capgo

🚦 Ionic anunció que los productos comerciales de AppFlow, incluyendo las actualizaciones en vivo, están disminuyendo. Los proyectos existentes pueden ejecutarse hasta el 31 de diciembre de 2027, but no new customers are accepted and no new features are planned. This guide walks you through the actions required to migrate to Capgo and highlights the native automation you gain.

Resumen de la migración

Capgo handles channels, bundle retention, rollbacks, analytics, and CLI uploads for you. Migration boils down to installing the plugin, calling CapacitorUpdater.notifyAppReady()y, si lo deseas, configurar controles manuales opcionales. A continuación, se describen las secciones para cada tarea de manera directa.

Versión de destino como AppFlow

Si te basaste en la versión automática de AppFlow (entrega de actualizaciones compatibles según la versión nativa), Capgo ofrece la misma capacidad con un control mejorado. Consulta el Versión de destino: Guía para obtener estrategias detalladas sobre la gestión de actualizaciones en varias versiones de la aplicación.

Paso 0 – Captura tu configuración actual de AppFlow

• Nota tu ID de AppFlow ID de App, canales existentes y claves de firma.
• Exporta cualquier historia de paquetes que desees archivar.
• If you are using GitHub Actions or another CI provider, keep those pipelines—they will keep working with Capgo.

Paso 1 – Reemplaza el flujo de AppFlow SDK con Capgo

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

Listo. Capgo agrupa los módulos nativos code tanto para iOS como para Android; no se requieren ayudantes de JavaScript adicionales.

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

La bloque de configuración existente es extensa. Capgo detecta automáticamente tu proyecto y canales, por lo que la configuración mínima es:

capacitor.config.ts

import { CapacitorConfig } from '@capacitor/cli'

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

export default config

Referencia rápida de configuración

Configuración de Ionic AppFlow	Capgo equivalente	¿Necesita configurarlo?
appId	Administrado en la consola de Capgo	Suministrado automáticamente cuando se crea el proyecto
channel / defaultChannel	Reglas de canal en la consola/API	Opción de sobrescritura opcional; los valores por defecto provienen del servidor. Consulte Configuración de versión context: Página/área: Página de marketing de soluciones de Capgo. Rol: Título de sección o página. Visto en: página de marketing de soluciones/version-targeting.astro. Clave de mensaje `solutions_version_targeting_title` (Título de configuración de versión de soluciones). | Página/área: Página de marketing de soluciones de Capgo. Rol: Etiqueta de IU corta o elemento de navegación. Visto en: página de marketing de soluciones/version-targeting.astro. Clave de mensaje `solutions_version_targeting` (Configuración de versión de soluciones).
autoUpdateMethod	autoUpdate: true	para estrategias de varias versiones
maxVersions	Habilitado por defecto	Configurado centralmente (1 mes por defecto, 24 meses máximo)
enabled	No es necesario	Capgo activa la disponibilidad por canal

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

En la guía de Ionic, conectas sync, download, y reload, luego ocultas la pantalla de bienvenida manualmente. Capgo realiza esas acciones nativamente. Solo debes confirmar que la aplicación está lista:

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

CapacitorUpdater.notifyAppReady()

Si nunca llega la confirmación, Capgo vuelve a empaquetar automáticamente.

¡Eso es todo—Capgo gestiona los controles de fondo, la visibilidad de la pantalla de bienvenida y los reenvíos para ti.

Opcional: ejecutar logicas antes de que la pantalla de bienvenida se oculte

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 – Actualizar estrategias traducidas

Los documentos de AppFlow describen tres estrategias. Aquí está cómo se relacionan con Capgo:

Fondo (por defecto)

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

Siempre lo último

• AppFlow: agregar un App.addListener('resume') manejador que descarga y recarga.
• Capgo: actualización automática se ejecuta al reanudar ya. Agregar el manejador solo si deseas una ventana de tiempo personalizada.

Opcional: verificar el estado de pausa manualmente

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

Actualizar forzadamente

• AppFlow: solicite al usuario y llame reload().
• : Capgo: marcar el paquete como “obligatorio” en la consola, luego escuche el majorAvailable evento (empleado después de notifyAppReady()) para solicitar o forzar a los usuarios dentro de su aplicación.

Paso 5 – Mapear las llamadas a API

Método de AppFlow	equivalente de Capgo	¿Necesita?
LiveUpdates.sync()	Se maneja automáticamente	Capgo’s actualización automática nativa se ejecuta sin una llamada de sincronización manual
LiveUpdates.download()	CapacitorUpdater.download()	Opcional para flujos personalizados
LiveUpdates.reload()	CapacitorUpdater.set()	Opcional; los botones de la consola manejan actualizaciones forzadas
LiveUpdates.getVersion()	CapacitorUpdater.current()	Opcional diagnóstico

Paso 6 – Despliega utilizando el Capgo CLI o API

Completa la migración subiendo paquetes con el Capgo CLI o API. El flujo de trabajo refleja lo que podrías haber scripteado antes, pero ahora incluye salvaguardas nativas:

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

Despliegues específicos de versión (como AppFlow)

Si necesitas dirigirte a versiones nativas específicas (similar a la bloqueo de versión 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

Ver el Guía de objetivos de versión para estrategias completas.

Capgo automáticamente:

• Mantiene registros de auditoría a nivel de dispositivo para cada instalación.
• Envía correos electrónicos proactivos cuando se acerca a los límites del plan.
• Proporciona créditos de sobretiempo para que nunca estés bloqueado durante la publicación.
• Publica métricas de latencia para 18 regiones globales en status.capgo.app/history.

Plugins de Ionic Enterprise

Si su pila de Ionic también utiliza plugins de empresa, consulte los documentos de migración dirigidos a continuación. Cada guía recomienda la sustitución por Capgo y los pasos siguientes.

• Migrar desde Ionic Secure Storage
• Migrar desde Ionic Auth Connect
• Migrar desde Ionic Identity Vault

Preguntas frecuentes

¿Por qué AppFlow está cerrando actualizaciones en vivo?

Ionic está discontinuando productos comerciales, incluido AppFlow, para centrarse en su marco de código abierto. Los clientes existentes pueden seguir utilizando actualizaciones en vivo hasta 31 de diciembre de 2027, pero no se aceptan nuevas características ni clientes. Capgo cubre ese vacío con una plataforma de OTA nativa dedicada.

How long does migration take?

La mayoría de los equipos completan el movimiento en menos de un día. Conceptos como canales, despliegues y reglas de lanzamiento se traducen directamente, y nuestro equipo proporciona documentación y apoyo en mano. En muchos casos, simplemente instala el plugin, llama notifyAppReady(), y sube tu primer paquete.

¿Ganaremos dinero?

Sí. Las actualizaciones en vivo de AppFlow comienzan en $499/mo. Capgo comienza en $14/mo con un precio basado en el uso que se reduce a aproximadamente $0.001 por MAU. También obtienes cifrado, rollbacks automáticos y monitoreo de latencia en todo el mundo.

¿Cuándo debemos migrar?

Dado que AppFlow está ahora en modo de mantenimiento, migrar antes te da acceso a la innovación Capgo en curso. Recomendamos cambiar cuando se adapte a tu calendario de lanzamiento. Nuestro equipo de ingeniería te ayudará a planificar el cambio para que tu CI/CD y despliegues sigan funcionando.

Recursos Adicionales

• Guía de Enfoque de Versión - Inmersión profunda en estrategias de coincidencia de versiones estilo AppFlow
• Cambios Importantes - Gestión de actualizaciones de versiones principales con canales
• Gestión de Canales - Referencia completa de configuración de canales

Necesita ayuda?

• Reserve una sesión de migración: book.capgo.app/demo
• Únete a la comunidad: Capgo Discord
• Seguimiento de problemas / solicitudes de características: github.com/Cap-go/capacitor-actualizador

Capgo está diseñado para empresas que necesitan actualizaciones delta nativas, paquetes cifrados y innovación continua. Una vez que se migre, puede eliminar la pegamento de AppFlow code, confiar en la automatización nativa y seguir enviando sin interrupciones.

Sigue adelante desde Migrar desde AppFlow a Capgo

Si está utilizando Migrate from AppFlow to Capgo conectarlo con Capgo Empresa para el flujo de trabajo del producto en Capgo Enterprise, Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternatives, Capgo Alternativas para el flujo de trabajo del producto en Capgo Alternativas, Capgo Consultoría para el flujo de trabajo del producto en Capgo Consultoría, y Capgo Soporte Premium para el flujo de trabajo del producto en Capgo Soporte Premium.