Instaladores y actualizaciones

Las aplicaciones de escritorio de Zoan (Designer, Agent y el Runner que comparten) se distribuyen desde Zoan Cloud. El portal de administración tiene la sección Instaladores, un catálogo por componente y versión: lo que se publica ahí es lo que descargan los usuarios y lo que usan las aplicaciones para actualizarse solas.

Qué se sube en cada fila

Los cuatro archivos los genera zoan build-installer en dist/, todos con la misma versión de plataforma.

Componente	Archivo	Quién lo usa
Instalador de la plataforma	Zoan-Platform-Setup-x.y.z.exe	El enlace Descargar aplicaciones del portal. Instalación nueva o actualización completa.
Designer	Zoan.Designer-x.y.z.zip	Autoactualización del Designer. Carpeta completa: ejecutable y carpetas de apoyo (java, extensión).
Agent	Zoan.Agent-x.y.z.zip	Autoactualización del Agent (bandeja y servicio de Windows). Carpeta completa: ejecutable, freerdp y capture.
Runner	Zoan.Runner-x.y.z.zip	El motor compartido en <instalación>\runner\. Lo actualizan el Designer y el Agent.

La versión se toma del nombre del archivo y debe coincidir con la del binario. Los clientes solo se actualizan cuando la versión publicada es mayor que la que tienen instalada.

Los tres componentes son carpetas completas comprimidas (bundles), no ejecutables sueltos: al aplicar una versión se reemplaza la carpeta entera, así que las carpetas de apoyo viajan con cada actualización. Los clientes anteriores a la 1.2.4, que solo entendían ejecutables, no ven los bundles: se actualizan con el instalador completo una vez y a partir de ahí siguen solos.

Cómo se actualiza cada aplicación

• Designer: al abrir consulta la última versión publicada. Si es mayor, la descarga en segundo plano, avisa y la aplica al cerrar: aparta la carpeta actual como .old, deja la nueva en su lugar y vuelve a abrirse. En instalaciones de máquina (Archivos de programa) Windows pide permiso una vez; en instalaciones por usuario no.
• Agent: comprueba al conectar y cada 6 horas. Verifica la huella SHA-256 de la descarga y espera a que termine la ejecución en curso si la hay. Como servicio de Windows se aplica sola sin preguntar (el servicio se detiene, se intercambia la carpeta y vuelve a arrancar). Desde la bandeja avisa, pide permiso si hace falta y se reinicia.
• Runner: es una carpeta, no un ejecutable, y la comparten Designer y Agent. Ambos descargan el zip, lo preparan en runner.new y lo intercambian cuando no hay ejecuciones. Si un robot está usando la carpeta, el cambio espera al final de esa ejecución o al siguiente arranque. Nunca se modifica la carpeta en uso a medias.

Con esto, una versión nueva del motor llega a todos los equipos con solo publicar los tres archivos.

Cuándo hace falta el instalador completo

La actualización automática reemplaza la carpeta completa de cada aplicación (ejecutable y carpetas de apoyo) y la carpeta del Runner. El intercambio lo hace updater\Zoan.Updater.exe, un aplicador pequeño que se instala junto a las aplicaciones y que solo renueva el instalador completo. No toca:

• el propio aplicador (updater\);

• el registro de Windows (accesos directos, asociación de .play, extensión del navegador, host de mensajería nativa), que ya está hecho;

• los paquetes de actividades, que se actualizan desde su propio catálogo;

• la extensión Zoan UI Discover, que actualiza la Chrome Web Store.

Cuando una versión cambia algo del registro, añade un componente nuevo o cambia el servicio de Windows, publica el instalador de la plataforma y pide a los usuarios ejecutarlo: detecta la instalación existente y la actualiza en su sitio. Es la excepción, no el flujo normal.

Producción y staging

Cada instancia de Zoan Cloud tiene su propio catálogo. Lo publicado en staging no llega a producción: hay que subir los archivos en cada una.