Herunterladen und Aktualisieren der Desktop-App

So funktionieren Passwork-Desktop-Downloads

In diesem Artikel wird erläutert, was passiert, wenn ein Benutzer in der Weboberfläche auf Desktopanwendung Passwork herunterladen klickt oder wenn eine bereits installierte App nach Updates sucht.

Auswahl der richtigen App-Version

• Der Passwork-Server weiß, welche App-Versionen mit der aktuellen Backend-Version kompatibel sind.
• Die Backend-Konfiguration definiert die Update-Server-Basis URL in der Umgebungsvariablen DESKTOP_SERVER_BASE_URL.
• Mithilfe dieses Basis-URL fordert das Backend spezielle .yaml-Dateien vom Update-Server an (z. B. latest.yml, latest-linux.yml, latest-mac.yml) mit verfügbaren Build-Metadaten:
  • spezifische App-Version (Format XXYYZZ);
  • Installer URLs für verschiedene Plattformen;
  • Prüfsummen und Hilfsfelder.
• Basierend auf dieser Datei und der unterstützten Desktop-Feature-Version ist das Backend:
  • wählt eine passende und kompatible App-Version für diesen Server aus;
  • Erstellt den endgültigen Installationslink für die Plattform des Benutzers.

Wichtig: Das Backend „errät“ keine Versionen und ruft Installationsprogramme nicht direkt aus einem öffentlichen Repository ab. Es kommt immer darauf an:

• sein eigenes Verständnis der unterstützten Desktop-Funktionsversion;
• .yaml-Manifeste sind unter DESKTOP_SERVER_BASE_URL verfügbar.

Einzelheiten zur Struktur des Update-Servers und zu den latest*.yml-Dateien finden Sie unter Allgemeine Übersicht über den Update-Server.

Rückgabe des Links und clientseitiger Download

Nachdem das Backend eine Version ausgewählt und URL erstellt hat:

• Der generierte URL wird vom Backend an den Client zurückgegeben:
  • entweder als Antwort auf eine Webschnittstellenanfrage;
  • oder im Rahmen der Update-Prüfung für eine bereits installierte App.
• Die Client-Seite sendet dann eine HTTP-Anfrage an den Update-Server:
  • die Anfrage geht direkt an einen URL wie DESKTOP_SERVER_BASE_URL/XXYY/XXYYZZ/ und lädt eine bestimmte Datei herunter (.exe, .dmg, .deb, .rpm usw.);
  • Die Datei wird von der automatischen Aktualisierungslogik installiert oder verbraucht (je nach Plattform und Szenario).

Zusamenfassend:

• Der Passwork-Anwendungsserver übernimmt die Versionsauswahllogik und generiert den richtigen URL;
• Der Update-Server (definiert durch DESKTOP_SERVER_BASE_URL) übernimmt die eigentliche Dateiverteilung;
• Der Client (Browser oder installierte Passwork Desktop-App) führt Downloads, Installationen oder Updates durch.

Für Administratoren bedeutet das:

• Damit Benutzer die App herunterladen und aktualisieren können, reicht es aus:
  • DESKTOP_SERVER_BASE_URL im Backend korrekt konfigurieren;
  • Stellen Sie sicher, dass der Update-Server erreichbar ist und aktuelle .yaml-Manifeste und Installationsprogramme enthält.