================================================================
  Was auf sva.tyrveil.com muss  -  Version __VERSION__
================================================================

Lade den Inhalt dieses Ordners in das Wurzelverzeichnis der Subdomain,
außer dieser Anleitung selbst:

    SquadManager-__VERSION__.zip
    SquadManager-Setup-__VERSION__.exe
    icon.png
    index.html                  die Downloadseite
    version.json                als Letztes

Die Reihenfolge ist wichtig: version.json zuletzt. Solange sie noch auf
die alte Version zeigt, bekommt niemand einen Link auf eine Datei, die
noch gar nicht oben liegt.

Danach müssen diese Adressen erreichbar sein:

    https://sva.tyrveil.com/
    https://sva.tyrveil.com/version.json
    https://sva.tyrveil.com/SquadManager-__VERSION__.zip
    https://sva.tyrveil.com/SquadManager-Setup-__VERSION__.exe


ALTE DATEIEN ENTFERNEN
----------------------
Nach dem Hochladen die Zip- und Setup-Dateien früherer Fassungen vom
Server löschen, also alle SquadManager-*.zip und SquadManager-Setup-*.exe
mit einer anderen Nummer als __VERSION__, und falls noch vorhanden:

    SquadVoiceActivation-3.2.zip
    SquadVoiceActivation-Setup-3.2.exe

Solange sie online liegen, kann jemand mit einer alten Fassung anfangen.


ZUM VERTEILEN
-------------
Deinen Freunden gibst du nur noch diesen Link. Er ändert sich nie:

    https://sva.tyrveil.com

Die Seite liest beim Öffnen version.json und bietet immer den neuesten
Installer an. Sie erklärt auch die Windows-Warnung beim ersten Start
("Der Computer wurde durch Windows geschützt" -> Weitere Informationen
-> Trotzdem ausführen).


NGINX
-----
Meist genügt die vorhandene Konfiguration. Hilfreich im server-Block:

    location ~* \.(zip|exe)$ {
        add_header Content-Disposition "attachment";
    }

    location = /version.json {
        add_header Cache-Control "no-cache";
        default_type application/json;
    }

    location = /index.html {
        add_header Cache-Control "no-cache";
    }

Die Zeile zu version.json ist die wichtigste: Ohne sie kann ein
zwischengeschalteter Zwischenspeicher noch die alte Versionsnummer
ausliefern, nachdem du längst eine neue hochgeladen hast.

Zeigt https://sva.tyrveil.com/ trotz hochgeladener index.html weiter
"403 Forbidden", fehlt im server-Block die Zeile

    index index.html;


WIE DAS UPDATE FUNKTIONIERT
---------------------------
Das Programm ruft beim Start version.json ab. Steht dort eine höhere
Versionsnummer als die installierte, erscheint unten im Fenster ein
Hinweisbalken mit einer Schaltfläche. Ein Klick lädt die ZIP, prüft die
Prüfsumme, ersetzt die Programmdateien und startet neu.

Ist der Server nicht erreichbar, passiert schlicht nichts - das
Programm läuft dann ganz normal ohne Hinweis weiter.


NEUE VERSION VERÖFFENTLICHEN
----------------------------
1. In squad_manager.py VERSION anpassen und BUILD um eins erhöhen.
   Der Bau vergleicht BUILD mit dem Server und warnt, wenn es nicht
   höher ist - dann bekäme niemand das Update.
2. Im Quellordner ausführen:

       .venv\Scripts\python.exe werkzeuge\baue_release.py

3. Den Inhalt von dist\server\ hochladen, wie oben beschrieben

Der Bauvorgang berechnet die Prüfsumme selbst und trägt sie in
version.json ein. Diese Datei niemals von Hand bearbeiten: Stimmt die
Prüfsumme nicht mit der ZIP überein, verweigert das Programm das
Update - genau so ist es gedacht.

In version.json steht "version" immer auf 4.1, die echte Nummer unter
"anzeige". Das ist Absicht: Programme bis 4.0 lesen nur "version" und
bekommen so das Update auf die neue Zählung ab 1.5.0.

Das Feld "hinweis" darfst du füllen, es erscheint im Hinweisbalken des
Programms und auf der Downloadseite:

    "hinweis": "Mikrofonliste aufgeräumt"

Halte es kurz, es steht neben der Schaltfläche.


WARUM HTTPS PFLICHT IST
-----------------------
Das Programm lädt ausschließlich über HTTPS und lehnt http:// ab. Ein
Updater, der Programmcode über eine unverschlüsselte Verbindung holt,
ließe sich in einem fremden WLAN umleiten - dann käme fremder Code auf
die Rechner deiner Freunde. Die Prüfsumme allein schützt davor nicht,
weil ein Angreifer auch sie mitliefern könnte.
