De V2 a V3

Esta documentación explica cómo actualizar a la versión 3 de auto-update.

Primero migra a las últimas herramientas:

npm remove -g capgo
npm remove capacitor-updater

npm i @capgo/cli
npm i @capgo/capacitor-updater@3
npx cap sync

Elimina toda tu configuración anterior:

{
  CapacitorUpdater: {
      autoUpdateURL: "https...",
      ...
  },
}

para dejar solo esto:

{
  "CapacitorUpdater": {
    "autoUpdate": true
  }
}

⚠️ Si estabas usando tu servidor, con autoUpdateURL, actualizaré esta guía pronto para ti. Mientras tanto, echa un vistazo a la nueva opción de upload external que te permite enviar solo el enlace de tu zip, no el code en la nube de Capgo. Esto se ha creado para empresas con políticas de privacidad estrictas. En el modo externo, el code nunca llegará al servidor de Capgo, solo almacenamos la URL y la enviamos al dispositivo, que la descargará directamente. En el modo estándar, el code se comprime y se guarda en nuestro servidor, pero nunca lo abriremos ni lo usaremos.

Qué ha cambiado

Todas las configuraciones de auto-update pasan a ser server-side, para darte más control sobre cómo envías una actualización a los usuarios.

¡Esto nos permite revertir e incluso desplegar solo a un usuario con channels! Estos ajustes se vuelven a añadir a la interfaz web:

• desactivar revert bajo native
• desactivar update sobre major

⚠️ Se activarán por defecto en todos los canales

Esto también reducirá la necesidad de actualizar el plugin con frecuencia; la mayoría de las actualizaciones se harán en el servidor y las recibirás sin cambios en tu lado.

⚠️ Se reinicia cuando una actualización pasa a ser la predeterminada; si prefieres no eliminar todas las versiones descargadas al actualizar desde la tienda, haz esto:

{
  "CapacitorUpdater": {
    "autoUpdate": true,
    "resetWhenUpdate": false
  }
}

Actualiza tu code

Por último, actualiza todos tus imports en JS de:

import { CapacitorUpdater } from 'capacitor-updater'

a

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

Luego vuelve a buildear tu code npm run build y copia los assets una vez más npx cap copy.

Ya deberías poder probar el último sistema de auto-update

Envía tu versión con:

npx @capgo/cli@latest bundle upload

en lugar de

npx capgo upload

Evolución futura

Por ahora solo se usa el primer canal público; en el futuro, 'public' cambiará a múltiples canales públicos si se configura más de uno.

Problemas comunes:

• Problema de build tras la actualización: si ya has abierto los code de origen del plugin en Android Studio o Xcode, a veces la sincronización no los elimina, y esa es la causa del problema. Abre el IDE nativo y elimínalos capacitor-updater a mano y haz npx cap sync esto debería solucionarlo.

Continúa con la migración de V2 a V3

Si estás usando De V2 a V3 para planificar la entrega de live update, conéctalo con Live Updates de Capgo para el flujo de trabajo del producto en Capgo Live Updates, Resumen para el detalle de implementación en Overview, Funcionalidades para el detalle de implementación en Features, Comportamiento de actualización para el detalle de implementación en Update Behavior, y Tipos de actualización para el detalle de implementación en Update Types.