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

Version Targeting Like AppFlow

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

Paso 0 – Capturar su configuración actual de AppFlow

• Anote 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 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 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 flujo de aplicación de Ionic	Capgo equivalente	¿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	Sobrescrito opcional; los valores por defecto provienen del servidor. Consulte Versiones 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

Step 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 de manera nativa. 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 reenvíos para ti!

Opcional: ejecuta 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 – Actualiza 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 el ú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().
• Capgomarque 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 tu aplicación.

Paso 5 – Mapear llamadas a API

Método AppFlow	equivalente de Capgo	¿Necesita?
LiveUpdates.sync()	Manejado automáticamente	Capgo’s actualización automática nativa 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 gestionan 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 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 afluencia 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.

• 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 el, but no new features or customers are accepted. Capgo fills that gap with a dedicated native OTA platform.

pero no se aceptan nuevas características o clientes.

La mayoría de los equipos completan el proceso en menos de un día. notifyAppReady()Conceptos como canales, despliegues y reglas de lanzamiento se traducen directamente, y nuestro equipo proporciona documentación y apoyo en vivo.

En muchos casos, simplemente instala el plugin, llama

¿Ganaremos dinero? ¿Ganaremos dinero?. Capgo starts at $499/mo . __CAPGO_KEEP_0__ comienza en $14/mocon un precio basado en el uso que se reduce a aproximadamente

$0.001 por MAU

Porque 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

• Guía de versiones objetivo - 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

Necesitas ayuda?

• Reserva 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-updater

Capgo está diseñado para empresas que necesitan actualizaciones delta nativas, paquetes cifrados y innovación continua. Una vez que migres, puedes 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ás utilizando Migrar desde AppFlow a Capgo para planificar la migración y las operaciones de la empresa, conectarlo con Capgo Empresa para el flujo de trabajo del producto en Capgo Empresa, Alternativas del plugin de Ionic Empresa para el flujo de trabajo del producto en Alternativas del plugin de Ionic Empresa, 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.