Saltar al contenido

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:

Sección titulada «Primero, migra a la última herramienta:»
Ventana de terminal
npm remove -g capgo
npm remove capacitor-updater
npm i @capgo/cli
npm i @capgo/capacitor-updater@3
npx cap sync
{
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.

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 eliminará la necesidad de actualizar el plugin con frecuencia; la mayoría de las actualizaciones se realizarán en el servidor y las recibirás sin ningún cambio en tu lado.

⚠️ Se restablece cuando una update se convierte en la predeterminada, por lo que si prefieres no eliminar todas las versiones de download al actualizar desde la tienda, haz esto:

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

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

import { CapacitorUpdater } from 'capacitor-updater'

a

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

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

Ahora 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

Por ahora solo se utiliza el primer canal público. En el futuro, 'public' cambiará a múltiples canales públicos si se configuran más de uno.

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

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.