Registros de Retroceso

Mientras que Capgo’s actualizaciones en vivo 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 mientras trabajas en una solución.

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

Protección de Retroceso Automático

Capgo incluye un mecanismo de seguridad integrado para proteger a tus usuarios de actualizaciones rotas. Si ocurre un error de JavaScript antes de la notifyAppReady() When se llama el método, el plugin volverá automáticamente a la versión anterior que funcionaba.

¿Cómo funciona el Rollback Automático?

Cuando se descarga y aplica una nueva actualización, Capgo espera que tu 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 función principal de tu 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 paquete anterior que funcionaba
3. Marque la actualización problemática como fallida para evitar que se aplique de nuevo

Consejo

Asegúrese de llamar a notifyAppReady() en la inicialización de su aplicación code después de que sus componentes principales se hayan cargado 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 sube una actualización rota, sus usuarios no se quedarán con una aplicación no funcional.

Configuración del Tiempo de espera

Puede configurar cuánto tiempo Capgo espera a notifyAppReady() para ser llamado estableciendo el appReadyTimeout en su 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 puedes 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

Every time you upload a new build and assign it to a channel, Capgo keeps a history of those builds. If you need to revert a specific update, you can select one of these previous builds to redeploy to the channel.

The primary way to roll back is through the rollback interface, which is located in the 4th tab (History) when viewing a channel in the Capgo Dashboard. This tab provides a comprehensive view of all available builds for the channel, allowing you to easily select and revert to any previous version.

Para retroceder utilizando la pestaña Historial:

1. Inicia sesión en la Capgo Dashboard.

2. Navega a la sección “Canales”.

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

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

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

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

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

Método Alternativo: Utilizando la Icono de Corona

Como una segunda forma, también puede deshacerse directamente desde la primera pestaña haciendo clic en el icono de corona junto a cualquier compilación en el historial 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 hacerla la compilación activa para el canal.
3. Confirme que desea deshacerse a esta compilación.

Nota

Al revertir a una versión anterior solo afecta al canal seleccionado. Si tienes múltiples canales (por ejemplo, Producción, Etapa, etc.), debes repetir el proceso de reversión para cada canal afectado.

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

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. Navega al canal en el Capgo Panel de Control.

2. Haz clic en el botón “Desvincular” junto a la versión actual.

3. Confirma que deseas desvincular el canal.

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

This is useful if you’ve identified a problem with an update but aren’t yet sure which build you want to roll back to. Desvincular el canal te da tiempo para investigar sin enviar actualizaciones adicionales.

Forzar el Paquete Integrado

Forzar el paquete integrado en un canal:

Navega al canal en el __CAPGO_KEEP_0__ Dashboard.

1. Navigate to the channel in the Capgo Dashboard.

2. Confirma que deseas forzar el paquete integrado.

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

Esta es una opción de rollback más agresiva que revertir a una versión específica anterior, ya que descarta todas las actualizaciones publicadas desde que la aplicación se publicó en las tiendas de aplicaciones.

Precaución

Precaución

Ten cuidado al forzar el paquete integrado, ya que afectará a todos los dispositivos del canal. Asegúrate de haber considerado el impacto y tener un plan para seguir adelante 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 tus lanzamientos y responder a problemas.

Algunas estrategias incluyen:

• Monitorear informes de errores y retroalimentación de usuarios inmediatamente después de lanzar una actualización
• Usar despliegues en fases o un sistema de canal estadiado para probar actualizaciones en un grupo más pequeño antes de la amplia difusión
• Tener un proceso claro de decisión para saber cuándo revertir, desconectar o forzar el paquete integrado, y quién tiene la autoridad para hacerlo
• Comunicar a los usuarios sobre el problema y la resolución, si es apropiado

Al combinar un monitoreo cuidadoso con la capacidad de gestionar rápidamente actualizaciones problemáticas, puedes entregar una experiencia de aplicación que mejora continuamente mientras minimizas las interrupciones para tus usuarios.

Sigue adelante desde Revertidos

Si estás utilizando Rollbacks para planificar el rollback y el control de versiones, conecta con Version Targeting para los detalles de implementación en Version Targeting Update Behavior para los detalles de implementación en Update Behavior empaquetar para los detalles de implementación en empaquetar Actualizaciones en vivo Capgo para el flujo de trabajo del producto en Actualizaciones en vivo Capgo Estrategias de rollback para Actualizaciones en vivo Capacitor para el contexto práctico en Estrategias de Rebobinado para Capacitor Actualizaciones en vivo.