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 seguir funcionando hasta 31 de diciembre de 2027Pero no se aceptan nuevos clientes y no se planean nuevas características. Esta guía te guía a través de las acciones necesarias para migrar a Capgo y destaca la automatización nativa que obtienes.

Resumen de la migración

Capgo gestiona canales, retención de paquetes, retrocesos, análisis y CLI subidas para ti. La migración se reduce a instalar el complemento, llamar a CapacitorUpdater.notifyAppReady(), y, si se desea, configurar controles manuales opcionales. Las secciones a continuación te guían a través de cada tarea directamente.

Version Targeting como AppFlow

Si te basaste en la versión automática de AppFlow (entregando actualizaciones compatibles basadas en la versión nativa), Capgo proporciona la misma capacidad con un control mejorado. Consulta el Guía de Version Targeting para estrategias detalladas sobre el manejo de actualizaciones en varias versiones de la aplicación.

Paso 0 – Captura tu configuración actual de AppFlow

• Nota tu AppFlow ID de la aplicación, canales existentes y claves de firma.
• Exporta cualquier historia de paquetes que desees archivar.
• Si estás utilizando GitHub Acciones o otro proveedor de CI, mantén esas pipelines—siguen funcionando con 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 empaqueta el nativo code para iOS y Android; no se requieren ayudantes de JavaScript adicionales.

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

La 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

__CAPGO_KEEP_0__ equivalente	Capgo equivalent	Administrado en la consola de __CAPGO_KEEP_0__
appId	Managed in the Capgo dashboard	Reglas de canal en la consola/__CAPGO_KEEP_0__
channel / defaultChannel	Channel rules in the dashboard/API	Opcional sobrescritura; los valores por defecto vienen del servidor. Consulte Versiones objetivo para estrategias de varias versiones
autoUpdateMethod	autoUpdate: true	Habilitado por defecto
maxVersions	Política de retención	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)

Iniciar la aplicación (el único hook requerido) sync, downloady luego oculta la pantalla de bienvenida manualmente. __CAPGO_KEEP_0__ realiza esas acciones nativamente. Solo debes confirmar que la aplicación está lista: reload, then hide the splash screen manually. Capgo performs those actions natively. You only need to confirm the app is ready:

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

CapacitorUpdater.notifyAppReady()

¡Listo! Capgo se encarga de los controles de fondo, la visibilidad de la pantalla de bienvenida y los rechazos por ti.

That’s it—Capgo handles the background checks, splash visibility, and rollbacks for you.

Copiar al portapapeles

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

Título de la sección «Paso 4 – Actualiza estrategias traducidas»

AppFlow documents three strategies. Here is how they map to Capgo:

Título de la sección «Fondo (por defecto)»

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

Siempre el último

• AppFlow: agregar un App.addListener('resume') manejador que descarga y recarga.
• Capgo: actualiza automáticamente al reanudar. Agrega el manejador solo si deseas una ventana de tiempo personalizada.

Opcional: verificación de reanudación manual

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 forzoso

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

Paso 5 – Mapear llamadas a API

Método AppFlow	equivalente de Capgo	Necesita?
LiveUpdates.sync()	Se maneja automáticamente	La actualización automática nativa de Capgo 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()	Diagnostics opcionales

Paso 6 – Desplegar utilizando el Capgo CLI o API

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

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

Implementaciones específicas de versión (como AppFlow)

Si necesita dirigirse a versiones nativas específicas (similar a la bloqueo de versiones nativas de AppFlow):

# Only deliver to devices on native version 2.0.0 or higher
capgo bundle upload \
  --path dist \
  --channel production \
  --native-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

Consulte el Guía de versiones objetivo para estrategias completas.

Capgo automáticamente:

• Conserva 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 descarga 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 tu pila de Ionic también utiliza plugins de empresa, sigue los documentos de migración dirigidos a continuación. Cada guía recomienda la sustitución Capgo y los siguientes pasos.

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

Preguntas frecuentes

Why is AppFlow shutting down live updates?

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 o clientes. Capgo cubre esa brecha 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 liberación 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.

Will we save money?

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

¿Cuándo debemos migrar?

Dado que AppFlow ahora está en modo de mantenimiento, migrar con anticipación le da acceso a la innovación de Capgo en curso. Recomendamos cambiar cuando se adapte a su calendario de lanzamiento. Nuestro equipo de ingeniería le ayudará a planificar el cambio para que su 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 versión mayor 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 migres, puedes eliminar la pegatina de AppFlow code, confiar en la automatización nativa y seguir enviando sin interrupciones.

Sigue adelante desde Migrar desde AppFlow a Capgo

Si estás utilizando Migrar desde AppFlow a Capgo para planificar la migración y las operaciones empresariales, conecta con Capgo Empresas para el flujo de trabajo del producto en Capgo Empresas Alternativas de Ionic Enterprise Plugin para el flujo de trabajo del producto en Alternativas de Ionic Enterprise Plugin 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.