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 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 gestiona canales, retención de paquetes, retrocesos, análisis y CLI subidas para usted. La migración se reduce a instalar el plugin y llamar CapacitorUpdater.notifyAppReady(), y si lo deseas, configurar controles manuales opcionales. A continuación, se describen cada tarea de manera detallada.

Versión de destino como AppFlow

Si se basó en la versión automática de AppFlow (entrega de actualizaciones compatibles según la versión nativa), Capgo ofrece la misma capacidad con un control mejorado. Consulte la Guía de Versión de destino 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

• Nota tu AppFlow App IDcanales existentes, y claves de firma.
• , canales existentes y claves de firma.
• Si está utilizando GitHub Acciones o otro proveedor de CI, mantenga esas pipelines—siguen funcionando con Capgo.

Step 1 – Reemplaza el flujo de AppFlow SDK con Capgo

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

Eso es todo. Capgo agrupa los nativos code para iOS y Android; no se requieren ayudantes de JavaScript adicionales.

Step 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

Configuración de Ionic AppFlow	equivalente a Capgo	¿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	Optional override; por defecto vienen desde el servidor. Ver Objetivo de versión estrategias de varias versiones
autoUpdateMethod	autoUpdate: true	para estrategias de varias versiones
maxVersions	Habilitado por defecto	Política de retención de datos de __CAPGO_KEEP_0__
enabled	Not 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, and reloadLuego, oculta 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()

If the confirmation never arrives, Capgo rolls the bundle back automatically.

Eso es todo—Capgo se encarga de las comprobaciones de fondo, la visibilidad de la pantalla de bienvenida y los rechazos por ti.

Optional: 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 – Estrategias de actualización traducidas

Los documentos de AppFlow describen tres estrategias. Aquí está cómo se relacionan con Capgo:

Fondo (por defecto)

• AppFlow: configurar autoUpdateMethod = background, llamar sync() manualmente.
• CapgoHabilitado 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 ya se ejecuta al reanudar. Agrega el manejador solo si deseas una ventana de tiempo personalizada.

Verificación manual opcional

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: pregunte al usuario y llame reload().
• : Capgo: marque el paquete como “obligatorio” en la consola, luego escuche el majorAvailable : evento (empleado después notifyAppReady()para solicitar o forzar a los usuarios dentro de tu aplicación.

Step 5 – Mapear las llamadas API

Método de AppFlow	Equivalente de Capgo	¿Necesitas esto?
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()	Diagnósticos 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 necesitas dirigirte 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
# 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

Consulte el Guía de versiones para estrategias completas.

Capgo automáticamente:

• Keeps device-level audit logs for every install.
• Envía correos electrónicos proactivos cuando se acerca a los límites del plan.
• Proporciona créditos de reventón para que nunca se bloquee durante la publicación.
• Publica métricas de latencia para 18 regiones globales en Estado.capgo.app/historial.

Plugins de Ionic para empresas

Si su pila de Ionic también utiliza plugins empresariales, siga los documentos de migración dirigida a continuación. Cada guía recomienda la sustitución del 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, 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 esa brecha con una plataforma de actualizaciones nativas OTA dedicada.

¿Cuánto tiempo lleva la migración?

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?

Yes. AppFlow live updates start at $499/mo. Capgo comienza en $14/mo con precios basados en el uso que disminuyen 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 con anticipación 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 Targeteo de Versión - Explora profundamente las estrategias de coincidencia de versiones estilo AppFlow
• Cambios significativos - Administrar actualizaciones de versión mayor con canales
• Gestión de Canales - Referencia completa de configuración de canal

context

• 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 se migre, puede eliminar la pegamento de AppFlow code, confiar en la automatización nativa y seguir enviando sin interrupciones.

Siga 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 del plugin empresarial de Ionic para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternativas, 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.