Migrate from AppFlow a Capgo

🚦 El equipo de 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 2027, pero 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 los canales, la retención de paquetes, los retrocesos, las métricas y CLI subidas para ti. La migración se reduce a instalar el plugin, 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 de manera directa.

Versión de destino como AppFlow

If usted confió en la versión automática de AppFlow (entregando actualizaciones compatibles según la versión nativa), Capgo proporciona la misma capacidad con un control mejorado. Consulte el Guía de versiones objetivo para estrategias detalladas sobre la gestión de actualizaciones en varias versiones de la aplicación.

Paso 0 – Captura su configuración actual de AppFlow

• Tenga en cuenta su AppFlow ID de la aplicación, canales existentes y claves de firma.
• Exporte cualquier historia de paquetes que desee archivar.
• Si está utilizando GitHub Actions o otro proveedor de CI, mantenga esas líneas de producción—siguen funcionando con Capgo.

Paso 1 – Reemplace la AppFlow SDK con Capgo

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

¡Listo. Capgo empaqueta el code nativo para iOS y 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 la aplicación de Ionic AppFlow	equivalente de Capgo	¿Necesita configurarlo?
appId	Administrado en la consola de Capgo	Se proporciona automáticamente cuando se crea el proyecto
channel / defaultChannel	Reglas del canal en la consola/API	Sobrescritura opcional; los valores por defecto provienen del servidor. Consulte Versionamiento 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)

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 maneja los controles de fondo, la visibilidad de la pantalla de bienvenida y los rechazos por ti.

Opcional: ejecutar lógica antes de que se oculte la pantalla de bienvenida

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

AppFlow documenta tres estrategias. Aquí está cómo se relacionan con Capgo:

Fondo (predeterminado)

• 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: la actualización automática se ejecuta al reanudar. Agregue el manejador solo si desea 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 forzadamente

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

Paso 5 – Mapear API llamadas

Método AppFlow	Capgo equivalente	¿Necesitas?
LiveUpdates.sync()	Se maneja automáticamente	Capgo’s actualización nativa auto 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 – 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 necesita dirigirse 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
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 Enfoque 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 auge para que nunca esté bloqueado durante la publicación.
• Publica métricas de latencia para 18 regiones globales en status.capgo.app/history.

Plugins de Ionic Enterprise

If your Ionic stack also uses enterprise plugins, follow the targeted migration docs below. Each guide recommends the Capgo replacement and the next steps.

• Plugins de Ionic Enterprise
• Migrar desde Ionic Auth Connect
• Migrar desde Ionic Identity Vault

Preguntas frecuentes

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

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

¿Cuánto tiempo dura la migración?

La mayoría de los equipos completan el cambio 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 instalar el plugin y llamar notifyAppReady()y subir su 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 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 antes te da acceso a la innovación en curso Capgo. Recomendamos cambiar cuando se adapte a su 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

• - Inmersión profunda en estrategias de coincidencia de versiones estilo AppFlow Cambios significativos
• - Gestión de actualizaciones de versión mayor con canales Gestión de canales
• - Referencia completa de configuración de canales Necesitas ayuda?

Sección titulada “Necesitas ayuda?”

• Version Targeting Guide book.capgo.app/demo
• Únete a la comunidad: Capgo Discord
• Seguir problemas / solicitar 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 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ás utilizando Migrar desde AppFlow a Capgo para planificar la migración y las operaciones de la empresa, conectarlo con Capgo Enterprise para el flujo de trabajo del producto en Capgo Enterprise, Alternativas del plugin de Ionic Enterprise para el flujo de trabajo del producto en Alternativas del plugin de Ionic Enterprise, 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.