Descarga y actualización de la aplicación de escritorio

Cómo funcionan las descargas de escritorio Passwork

Este artículo explica lo que sucede cuando un usuario hace clic en Descargar la aplicación de escritorio Passwork en la interfaz web, o cuando una aplicación ya instalada busca actualizaciones.

Seleccionar la versión correcta de la aplicación

• El servidor Passwork sabe qué versiones de la aplicación son compatibles con la versión actual del backend.
• La configuración del backend define la base del servidor de actualización URL en la variable de entorno DESKTOP_SERVER_BASE_URL.
• Usando esta base URL, el backend solicita archivos .yaml especiales del servidor de actualización (por ejemplo, latest.yml, latest-linux.yml, latest-mac.yml) con metadatos de compilación disponibles:
  • versión específica de la aplicación (formato XXYYZZ);
  • instalador URLs para diferentes plataformas;
  • sumas de verificación y campos auxiliares.
• Según este archivo y la versión de la función de escritorio compatible, el backend:
  • selecciona una versión de aplicación adecuada y compatible para este servidor;
  • construye el enlace del instalador final para la plataforma del usuario.

Importante: el backend no "adivina" versiones y no busca instaladores directamente desde un repositorio público. Siempre se basa en:

• su propia comprensión de la versión de la función de escritorio compatible;
• .yaml manifiestos disponibles en DESKTOP_SERVER_BASE_URL.

Para obtener detalles sobre la estructura del servidor de actualización y los archivos latest*.yml, consulte Descripción general del servidor de actualización.

Devolver el enlace y la descarga del lado del cliente

Después de que el backend seleccione una versión y cree el URL:

• El backend devuelve el URL generado al cliente:
  • ya sea como respuesta a una solicitud de interfaz web;
  • o como parte de la actualización, busque una aplicación ya instalada.
• El lado del cliente luego envía una solicitud HTTP al servidor de actualización:
  • la solicitud va directamente a un URL como DESKTOP_SERVER_BASE_URL/XXYY/XXYYZZ/ y descarga un archivo específico (.exe, .dmg, .deb, .rpm, etc.);
  • el archivo se instala o consume mediante la lógica de actualización automática (según la plataforma y el escenario).

En breve:

• el servidor de aplicaciones Passwork maneja lógica de selección de versión y genera el URL correcto;
• el servidor de actualización (definido por DESKTOP_SERVER_BASE_URL) maneja la distribución real de archivos;
• el cliente (navegador o aplicación de escritorio Passwork instalada) realiza descarga, instalación o actualización.

Para los administradores, esto significa:

• Para permitir a los usuarios descargar y actualizar la aplicación, basta con:
  • configurar DESKTOP_SERVER_BASE_URL correctamente en el backend;
  • asegúrese de que el servidor de actualización sea accesible y contenga instaladores y manifiestos .yaml actualizados.