Rollbacks

Mientras que las actualizaciones en vivo de Capgo te permiten entregar mejoras y correcciones a tus usuarios de manera rápida, puede haber situaciones en las que necesites retroceder a una versión anterior de tu aplicación. Quizás una nueva actualización introdujo un problema crítico inesperado, o tal vez deseas revertir un cambio específico mientras trabajas en una solución.

Capgo ofrece varias formas de gestionar los builds de un canal y controlar la versión de tu aplicación que reciben los usuarios, incluidas opciones de retroceso manual y mecanismos de seguridad automáticos.

Protección de Retroceso Automático

Capgo includes a built-in safety mechanism to protect your users from broken updates. If a JavaScript error occurs before the notifyAppReady() __CAPGO_KEEP_0__ incluye un mecanismo de seguridad integrado para proteger a tus usuarios de actualizaciones rotas. Si ocurre un error de JavaScript antes de que se llame el método, el plugin se retrocederá automáticamente a la versión anterior que funcionaba.

How Automatic Rollback Works

Cuando se descarga y aplica una nueva actualización, Capgo espera que su aplicación llame notifyAppReady() dentro de un plazo configurable para confirmar que la actualización se cargó correctamente. Este método indica que:

• El paquete JavaScript se cargó sin errores críticos
• La funcionalidad básica de su aplicación está funcionando
• La actualización es segura para mantenerla

Si notifyAppReady() no se llama debido a un crash o error crítico de JavaScript, Capgo hará:

1. Detectará que la actualización no se inicializó correctamente
2. Revertirá automáticamente a la versión de trabajo anterior
3. Marcará la actualización problemática como fallida para evitar que se aplique de nuevo

Consejo

Asegúrate de llamar a notifyAppReady() en la inicialización de tu aplicación code después de que se hayan cargado tus componentes principales con éxito. Esto garantiza que la protección automática de rollback funcione como se espera.

import { CapacitorUpdater } from '@capgo/capacitor-updater'

// Call this after your app has successfully initialized
await CapacitorUpdater.notifyAppReady()

Esta protección automática ayuda a asegurarse de que incluso si accidentalmente envías una actualización rota, tus usuarios no se quedarán con una aplicación no funcional.

Configurando el Tiempo de espera

Puedes configurar cuánto tiempo Capgo espera a que notifyAppReady() se llame configurando el appReadyTimeout en tu configuración de Capacitor:

{
  "plugins": {
    "CapacitorUpdater": {
      "appReadyTimeout": 10000
    }
  }
}

La appReadyTimeout El valor se especifica en milisegundos. El tiempo de espera predeterminado es típicamente de 10 segundos, pero puede ajustarlo según las necesidades de inicialización de tu aplicación. Si tu aplicación tarda más en cargar debido a procesos de inicialización complejos, es posible que desees aumentar este valor.

Volver a una versión anterior del paquete

La historia de cada nueva versión subida y asignada a un canal se almacena en Capgo. Si necesitas revertir una actualización específica, puedes seleccionar una de estas versiones anteriores para volver a desplegarla en el canal.

La forma principal de revertir es a través de la interfaz de reversiones, que se encuentra en la pestaña 4 (Historial) cuando se visualiza un canal en el panel de control de Capgo. Esta pestaña proporciona una vista completa de todas las versiones disponibles para el canal, lo que te permite seleccionar y revertir fácilmente a cualquier versión anterior.

Para revertir utilizando la pestaña Historial:

1. Iniciar sesión en el Capgo.

2. Navegue a la sección ‘Canales’.

3. Haga clic en el nombre del canal que desea revertir.

4. Vaya a la cuarta pestaña (Historial) en la vista del canal.

5. Encuentre la compilación que desea revertir en la historia de compilaciones.

6. Seleccione esa compilación para que sea la compilación activa para el canal.

7. Confirme que desea retroceder a esta compilación.

Método Alternativo: Utilizando el Icono de Corona

Como una segunda forma, también puede retroceder directamente desde la primera pestaña haciendo clic en el icono de corona junto a cualquier compilación en la historia de compilaciones del canal:

1. En la primera pestaña de la vista del canal, encuentre la compilación que desea revertir.
2. Haga clic en el icono de corona junto a esa compilación para que sea la compilación activa para el canal.
3. Confirme que desea retroceder a esta compilación.

Nota

La devolución a una versión anterior solo afecta al canal seleccionado. Si tienes varios canales (por ejemplo, Producción, Etapa, etc.), necesitarás repetir el proceso de devolución para cada canal afectado.

Después de la devolución, los dispositivos configurados para escuchar el canal actualizado recibirán la versión anterior la próxima vez que revisen las actualizaciones. La versión devuelta se tratará como una nueva actualización, por lo que se aplican el flujo de actualización y las condiciones habituales.

Acelerar una Devolución Crítica con Notificaciones

Reasignar un canal normalmente tiene efecto la próxima vez que un dispositivo revise las actualizaciones. Capgo Las notificaciones pueden enviar una notificación de revisión de actualizaciones en silencio a una aplicación compatible mientras está en segundo plano. Con la integración del actualizador habilitada, la aplicación puede revisar, descargar e instalar la devolución según su configuración de modo de actualización.

Esta es una ruta de aceleración, no una orden de comando de flota forzada. La entrega sigue siendo de mejor esfuerzo y depende de la programación de fondo del sistema operativo, la disponibilidad de la red y el estado del dispositivo. No puede actualizar una aplicación offline o forzada a cerrar, por lo que no puede prometer un tiempo fijo para llegar a cada dispositivo.

Para configurar esta ruta, sigue Notificaciones: Habilita Revisión de Actualizaciones en Silencio.

Desvincular un Canal

Si deseas detener temporalmente las actualizaciones en un canal mientras investigas un problema, puedes desvincular el canal de su versión actual.

Para desvincular un canal:

1. Navegue hasta el canal en la Consola de Capgo.

2. Haga clic en el botón “Desvincular” al lado del build actual.

3. Confirme que desea desvincular el canal.

Una vez que un canal esté desvinculado, no distribuirá actualizaciones nuevas. Los dispositivos configurados para ese canal permanecerán en su build actual hasta que el canal esté vinculado a un build nuevamente.

Esto es útil si ha identificado un problema con una actualización pero aún no está seguro de qué build quiere revertir. Desvincular el canal le da tiempo para investigar sin enviar actualizaciones adicionales.

Forzar el Paquete Integrado

En situaciones más graves, puede querer revertir todos los dispositivos de un canal a la build web que se empaquetó originalmente con el binario nativo de su aplicación. Esto se conoce como el “paquete integrado”.

Para forzar el paquete integrado en un canal:

1. Navegue hasta el canal en la Consola de Capgo.

2. Haga clic en el botón “Paquete Integrado”.

3. Confirme que desea forzar el paquete integrado.

Cuando fuerces el paquete integrado, todos los dispositivos configurados en ese canal volverán a la versión web original empaquetada en su próxima verificación de actualizaciones. Esto sucede sin importar en qué versión estén actualmente.

Esta es una opción de devolución más agresiva que reversionar a una versión de construcción específica anterior, ya que descarta todas las actualizaciones en vivo publicadas desde que la aplicación se publicó por última vez en las tiendas de aplicaciones.

Advertencia

Tenga cuidado al forzar el paquete integrado, ya que afectará a todos los dispositivos en el canal. Asegúrese de haber considerado el impacto y tener un plan para avanzar antes de tomar esta acción.

Monitoreo y respuesta a problemas

Para detectar problemas rápidamente y minimizar el impacto de actualizaciones problemáticas, es importante tener un plan para monitorear sus lanzamientos y responder a problemas.

Algunas estrategias incluyen:

Para un lanzamiento que todavía está limitado a un grupo de cohortes, utilice Despliegues progresivos pausar la exposición o eliminar su objetivo antes de cambiar el paquete estable para todo el canal.

• Monitorear informes de errores y retroalimentación de usuarios inmediatamente después de liberar una actualización.
• Usar despliegues en fases o un sistema de canal estagiado para probar actualizaciones en un grupo más pequeño antes de su amplia liberación.
• Tener un proceso de decisión claro para cuando revertir, desconectar o forzar el paquete incorporado, y quién tiene la autoridad para hacerlo.
• Comunicarse con los usuarios sobre el problema y la resolución, si es apropiado.

Al combinar la monitoreo cuidadoso con la capacidad de gestionar rápidamente actualizaciones problemáticas, puede entregar una experiencia de aplicación en constante mejora mientras minimiza las interrupciones para sus usuarios.

Sigue adelante desde Revertir

Si estás utilizando Revertir para planificar la reversión y el control de versiones, conectarlo con Objetivo de Versión para los detalles de implementación en Version Targeting, Comportamiento de Actualización para los detalles de implementación en Comportamiento de Actualización, paquete para los detalles de implementación en paquete, Capgo Actualizaciones en Vivo for the product workflow in Capgo Live Updates, and para el flujo de trabajo del producto en Capacitor Actualizaciones en Vivo, y Estrategias de Reversión para Capacitor Actualizaciones en Vivo