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. Las secciones a continuación recorren cada tarea de manera directa.

Version Targeting Like AppFlow

Si confiaste 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. Consulta 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 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

Es todo. Capgo agrupa los módulos nativos code 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 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 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 las comprobaciones 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.
• Capgohabilitado por defecto. No se requiere JavaScript.

Siempre lo último

• AppFlowagregue un App.addListener('resume') manejador que descarga y recarga.
• CapgoPreserve Capgo product/brand and developer terms exactly.

actualiza automáticamente ya se ejecuta al reanudar. Agregue el manejador solo si desea una ventana de tiempo personalizada.

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

Copiar a portapapeles

• 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.

Step 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 sincronización 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

Finaliza 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 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 en medio de una 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, 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 o 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. 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 modelo de precios basado en el uso que se reduce a aproximadamente $0.001 por MAUUsted también obtiene cifrado, rollback automático y monitoreo de latencia en todo el mundo.

¿Cuándo debemos migrar?

Porque AppFlow ahora está en modo de mantenimiento, migrar más pronto le da acceso a la innovación en curso de Capgo. 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 - 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 / solicitud 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 Migrate from 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 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.