Reversiones

While Capgo’s live updates permitte rápidamente entregar mejoras y correcciones a sus usuarios, puede haber situaciones en las que necesite retroceder a una versión anterior de la aplicación. Quizás una nueva actualización introdujo un problema crítico inesperado, o tal vez quiere revertir un cambio mientras trabaja en una solución.

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

Protección de Retroceso Automático

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

¿Cómo Funciona la Protección de Retroceso Automático?

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

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

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

1. Detectar que la actualización falló para inicializarse 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 notifyAppReady() en la inicialización de tu aplicación code después de que tus 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 envías una actualización rota, tus usuarios no se quedarán con una aplicación no funcional.

Configurando el Tiempo de Espera

Puede configurar cuánto tiempo Capgo espera para notifyAppReady() ser llamado configurando el appReadyTimeout en su configuración de Capacitor:

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

El appReadyTimeout 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 su aplicación. Si su aplicación tarda más en cargar debido a procesos de inicialización complejos, puede querer aumentar este valor.

Regresando a una Versión Anterior del Paquete

Cada vez que sube una nueva compilación y la asigna a un canal, Capgo mantiene un registro de esas compilaciones. Si necesita revertir una actualización específica, puede seleccionar una de estas versiones anteriores para volver a desplegar en el canal.

The forma principal de deshacer cambios es a través de la interfaz de deshacer, que se encuentra en la pestaña 4ª (Historial) cuando se visualiza un canal en el Capgo Panel de control.

Para deshacer cambios utilizando la pestaña Historial:

1. Inicie sesión en el Capgo Panel de control.

2. Navegue a la sección de "Canales".

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

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

5. Encuentre la versión que desee revertir en el historial de versiones.

6. Seleccione esa versión para que se convierta en la versión activa para el canal.

7. Confirme que desea deshacer cambios hasta esa versión.

Método Alternativo: Utilizando la Icono de Corona

Como segunda opción, también puedes retroceder directamente desde la primera pestaña haciendo clic en el icono de corona junto a cualquier construcción en la historia de construcciones del canal:

1. En la primera pestaña de la vista del canal, encuentra la construcción que deseas revertir.
2. Haz clic en el icono de corona junto a esa construcción para hacerla la construcción activa para el canal.
3. Confirmar que deseas retroceder a esta construcción.

Nota

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

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

Acelerar un Rollback Crítico con Notificaciones (Vista Privada)

Reapuntar un canal normalmente tiene efecto la próxima vez que un dispositivo revisa las actualizaciones. La integración de Notificaciones Capgo actualmente está en vista privada y puede enviar una notificación de actualización silenciosa a una aplicación compatible mientras está en segundo plano. Con la integración del actualizador habilitada, la aplicación puede verificar, descargar e instalar el rollback según su configuración 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 salir, por lo que no puede prometer un tiempo fijo para llegar a cada dispositivo.

Para solicitar acceso a la vista privada o configurar esta ruta crítica, comuníquese con support@capgo.app. También puede leer Notificaciones: Habilitar Verificaciones Silenciosas de Actualizaciones.

Desvincular un Canal

Si desea detener temporalmente las actualizaciones en un canal mientras investiga un problema, puede desvincular el canal de su construcción actual.

Para desvincular un canal:

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

2. Haga clic en el botón “Desvincular” junto a la construcción 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 versión actual hasta que el canal esté vinculado a una versión nuevamente.

Esto es útil si has identificado un problema con una actualización pero aún no estás seguro de qué versión deseas retroceder. Desvincular el canal te da tiempo para investigar sin enviar actualizaciones adicionales.

Título de la sección “Forzando el paquete integrado”

Para forzar el paquete integrado en un canal:

Navegue hasta el canal en el __CAPGO_KEEP_0__ Dashboard.

1. Navigate to the channel in the Capgo Dashboard.

2. Confirme que desea forzar el paquete integrado.

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

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

Precaución

Cuidado

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 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 tus lanzamientos y responder a problemas.

Algunas estrategias incluyen:

Para un lanzamiento que todavía está limitado a un cohorte, utilice Despliegues progresivos para 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 lanzar 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 lanzamiento amplio
• Tener un proceso de decisión claro 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 corresponde

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

Sigue adelante desde Rollbacks

Si está utilizando Rollbacks para planificar el rollback y el control de versiones, conecte Versión de destino para los detalles de implementación en Versión de destino Comportamiento de actualización para los detalles de implementación en Comportamiento de actualización paquete para el detalle de implementación en el paquete, Capgo Actualizaciones en Vivo para el flujo de trabajo del producto en Capgo Actualizaciones en Vivo, y Estrategias de Reversión para Capacitor Actualizaciones en Vivo para el contexto práctico en Estrategias de Reversión para Capacitor Actualizaciones en Vivo.