Migrar desde 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 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 desea, configurar controles manuales opcionales. Las secciones a continuación recorren cada tarea directamente.

Version Targeting Like AppFlow

Si se basó en la versión automática de AppFlow (entregando actualizaciones compatibles según la versión nativa), Capgo ofrece la misma capacidad con un control mejorado. Consulte el Version Targeting Guide para estrategias detalladas sobre la gestión de actualizaciones en varias versiones de la aplicación.

Step 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 Acciones o otro proveedor de CI, mantenga esas pipelines—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 agrupa los nativos code para tanto iOS como Android; no se requieren ayudantes de JavaScript adicionales.

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

La bloque de configuración existente es extenso. Capgo auto-detecta su 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	Se proporciona 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 Target de versión contexto: 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 soluciones/version-targeting.astro. Clave de mensaje `solutions_version_targeting_title` (Título de la 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 soluciones/version-targeting.astro. Clave de mensaje `solutions_version_targeting` (Target 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() La única función requerida

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 la confirmación nunca llega, Capgo vuelve a empaquetar automáticamente.

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

Opcional: ejecutar lógica 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 (predeterminado)

• 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: actualización automática se ejecuta al reanudar ya. 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: 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 native auto-update runs without a manual sync call
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 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

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

If you need to target specific native versions (similar to AppFlow’s native version locking):

# 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 versiones objetivo 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 reventón para que nunca estés bloqueado durante la publicación.
• Pública 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, siga las documentaciones de migración dirigidas a continuación. Cada guía recomienda la sustitución por Capgo y los siguientes pasos.

• 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, incluyendo 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 cambio en menos de un día. Los 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 MAUUsted también obtiene cifrado, rollbacks automáticos y monitoreo de latencia en todo el mundo.

¿Cuándo debemos migrar?

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

Recursos Adicionales

• Guía de Versionado - Profundice 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 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 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 Alternativas de Ionic Enterprise Plugin Capgo Alternativas para el flujo de trabajo del producto en Capgo Alternativas, Capgo Asesorí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.