Migrate from 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 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 CapacitorUpdater.notifyAppReady()y, si lo desea, configurar controles manuales opcionales. Las secciones a continuación describen cada tarea de manera directa.

Version Targeting Like AppFlow

Si se basó en la versión automática de AppFlow (entrega de actualizaciones compatibles según la versión nativa), Capgo proporciona 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.

Paso 0 – Captura tu configuración actual de AppFlow

• Tenga en cuenta su AppFlow ID de la aplicacióncanales existentes y claves de firma.
• Exporte cualquier historia de paquetes que desee archivar.
• If estás utilizando GitHub Actions 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 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 extenso. 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 sobrescrita; los valores por defecto provienen del servidor. Consulte Configuración de versión para estrategias de múltiples 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, usted conecta sync, download, y reload, luego oculta la pantalla de bienvenida manualmente. Capgo realiza esas acciones nativamente. Solo necesita 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 reenvíos para usted.

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

AppFlow documenta 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 el ú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: 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

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

Paso 5 – Mapear llamadas a API

Método de Flujo de Aplicación	equivalente de Capgo	¿Necesita?
LiveUpdates.sync()	Se maneja automáticamente	Capgo’s nativa actualización automática corre 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ósticos

Paso 6 – Despliega utilizando el Capgo CLI o API

Finaliza la migración subiendo paquetes con el Capgo CLI o API. El flujo 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 versiones para objetivos para estrategias completas.

Capgo automáticamente:

• Almacena registros de auditoría a nivel de dispositivo para cada instalación.
• Envía correos electrónicos proactivos cuando se acerque a los límites del plan.
• Proporciona créditos de descarga para que nunca se bloquee 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, siga los documentos de migración dirigidos a continuación. Cada guía recomienda la sustitución de 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 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 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 MAU. También obtienes 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 Capgo en curso. 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

• 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
• 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 se migre, puede eliminar el 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 Migrar desde AppFlow a Capgo para planificar la migración y las operaciones empresariales, conecte con Capgo Empresas para el flujo de trabajo del producto en Capgo Empresas, Alternativas de Plugins de Ionic Empresas para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Empresas, Capgo Alternativas para el flujo de trabajo del producto en Capgo Alternativas, Consultoría de Capgo para el flujo de trabajo del producto en Consultoría de Capgo, y Soporte Premium de Capgo para el flujo de trabajo del producto en Soporte Premium de Capgo.