- App prüft version.json beim Start (nur exportierte Desktop-Builds) - Dialog, Download mit SHA-256-Prüfung, Installation je Plattform - manueller Menüpunkt, übersprungene Version in user://update.cfg - Endpunkt unter rinkplanner.programmschmiede.de/version.json - tools/publish_version.sh und Doku in docs/updates.md - Version 0.2.0
9.4 KiB
Updates und Versions-Endpunkt
Stand: 2026-11-11, veröffentlichte Version 0.2.0 (nur macOS).
Die App prüft beim Start und über Datei → Nach Updates suchen…, ob eine
neuere Version veröffentlicht ist. Der Endpunkt ist ein statisches JSON auf
der Rinkplanner-Subdomain. Es gibt keinen PHP-Dienst und keine Datenbank.
Beteiligte Dateien
| Datei | Aufgabe |
|---|---|
rinkplanner/src/core/update/update_info.gd |
Versionsvergleich, JSON-Prüfung, Plattformwahl, gemerkte übersprungene Version |
rinkplanner/src/core/update/update_client.gd |
Blockierender HTTPS-Check und Download mit SHA-256-Prüfung |
rinkplanner/src/core/update/update_job.gd |
Thread-Aufgabe für Check/Download |
rinkplanner/src/whiteboard/ctrl/whiteboard_controller.gd |
Startprüfung, Dialog, menüpunkt, Installation |
rinkplanner/scenes/whiteboard/whiteboard.tscn |
UpdateDialog mit UpdateText |
rinkplanner/tests/run_update_tests.gd |
Headless-Tests (kein Netzwerk) |
rinkplanner/tests/manual/check_update.gd |
Manueller Check gegen den Live-Endpunkt |
tools/publish_version.sh |
Erzeugt version.json, bildet Prüfsummen, lädt hoch |
docs/updates.md |
Diese Datei |
Versionsquelle
Die Laufzeitversion steht in rinkplanner/project.godot:
config/version="0.2.0"
Beim Versionssprung alle Stellen anpassen:
rinkplanner/project.godot:config/versionrinkplanner/export_presets.cfg:- Windows:
application/file_versionundapplication/product_version(viersegmentig, z. B.0.2.0.0) - macOS:
application/short_versionundapplication/version - Android:
version/name, außerdemversion/codeerhöhen
- Windows:
tools/windows_installer.nsiundtools/export_windows_installer.sh: nur Fallback-Werte, falls das Preset nicht gelesen werden kann
UpdateInfo.current_version() liest application/config/version zur Laufzeit.
Die Tests prüfen, dass der Wert gesetzt und numerisch ist, aber nicht eine
bestimmte Versionsnummer.
Endpunkt
https://rinkplanner.programmschmiede.de/version.json
Ablage auf dem Webspace: FTP-Login-Root → Verzeichnis
rinkplanner.programmschmiede.de/ (Docroot der Subdomain). Die Datei wird
als application/json ausgeliefert; es gibt keine Cache-Control-Header.
version.json ist die einzige Quelle für die App – die HTML-Seite ist davon
unabhängig.
Schema:
{
"version": "0.2.0",
"released": "2026-11-11",
"notes": "Neu: …",
"downloads": {
"macos": {
"url": "https://programmschmiede.de/rinkplanner/download/rinkplanner-setup.dmg",
"sha256": "…",
"size": 71302221
},
"windows": {
"url": "https://programmschmiede.de/rinkplanner/download/rinkplanner-setup.exe",
"sha256": "…",
"size": 0
}
}
}
versionist Pflicht und muss numerisch beginnen (v-Präfix und Suffixe werden ignoriert).downloadsist Pflicht und darf nicht leer sein; Schlüssel sindmacos,windows,linux(klein geschrieben).urlmuss mithttps://beginnen, sonst wird der Eintrag verworfen.sha256undsizesind optional; fehltsha256, wird der Download nicht verifiziert. Für Releases immer setzen (machtpublish_version.sh).notesdarf ein String oder eine Liste von Zeilen sein.releasedwird alsJJJJ-MM-TTerwartet und im Dialog alsTT.MM.JJJJangezeigt.
Veröffentlichen
Voraussetzungen: Installer sind gebaut, docs/credentials.txt enthält die
FTP-Zugänge, der Build entspricht der Version in project.godot.
./tools/export_macos_installer.sh
./tools/publish_version.sh --notes "Neu: …"
Optionen:
| Option | Wirkung |
|---|---|
--windows |
Nimmt build/windows/rinkplanner-setup.exe mit auf. Vorher neu bauen; die Version lässt sich nicht zuverlässig aus der EXE lesen. |
--notes "Text" |
Neuerungen für den Update-Dialog. |
--no-upload |
Schreibt nur build/version.json. |
--check |
Gibt den live ausgelieferten Endpunkt aus. |
Das Skript:
- liest die Version aus
project.godot, - bildet SHA-256 und Größe der vorhandenen Installer,
- schreibt
build/version.json, - lädt sie per FTP nach
rinkplanner.programmschmiede.de/version.json, - vergleicht die live abgerufene Datei mit der lokalen und bricht bei Abweichung mit Exit-Code 2 ab (Cache/Hosting prüfen).
Es werden nur Plattformen veröffentlicht, die ausdrücklich vorliegen. Ein fehlender Eintrag bedeutet: Für diese Plattform gibt es keinen automatischen Update-Hinweis.
Live prüfen:
./tools/publish_version.sh --check
curl -fsSL https://rinkplanner.programmschmiede.de/version.json
/Applications/Godot.app/Contents/MacOS/Godot --headless \
--path rinkplanner --script res://tests/manual/check_update.gd
Der letzte Befehl nutzt denselben UpdateClient wie die App und zeigt
installierte Version, veröffentlichte Version, Plattform und Download-Eintrag.
Verhalten in der App
- Automatisch: nur in exportierten Desktop-Builds
(
OS.has_feature("template"), nicht Web, Plattform macOS/Windows/Linux). Editor, Android und die Headless-Tests prüfen nicht automatisch. - Manuell:
Datei → Nach Updates suchen…funktioniert überall und zeigt auch „bereits aktuell“ oder Fehler an. - Ablauf: Hintergrund-Thread → Dialog bei neuerer Version → Download nach
user://updates/→ SHA-256-Prüfung → Installation. - Fehler beim automatischen Check werden nur als Warning geloggt, damit ein Offline-Start nicht stört. Manuelle Fehler erscheinen im Dialog.
- „Später“ speichert die übersprungene Version in
user://update.cfg. Beim nächsten Start wird dieselbe Version nicht erneut automatisch gemeldet; manuell schon. - Downloadordner:
user://updates/(macOS:~/Library/Application Support/Godot/app_userdata/Rinkplanner/updates). Nach erfolgreicher macOS-Installation wird die DMG gelöscht. - Größenlimit: 512 MB als Schutz vor kaputten Endpunkten.
Installation je Plattform
- macOS: DMG mit
hdiutil attach -nobrowse -readonlyeinhängen, die.appim Image perdittoüber das laufende Bundle kopieren, aushängen, neue Instanz mitopen -nstarten und die alte beenden. Das Ziel ist das Bundle, aus dem die App gerade läuft (OS.get_executable_path()), nicht zwangsweise/Applications. Schlägt Einhängen oder Kopieren fehl (Rechte, Translocation, Editor-Lauf), öffnet sich das DMG im Finder mit dem Hinweis, die App manuell zu ersetzen. - Windows: Der heruntergeladene
rinkplanner-setup.exewird gestartet, die App beendet sich nach ca. einer Sekunde, damit der Installer die laufende EXE ersetzen kann. Der Installer ist per-user und unsigniert. - Linux: Es gibt noch keinen Installer; die Datei wird im Dateimanager geöffnet.
Sicherheit
- Endpunkt und Download nur über HTTPS mit Zertifikatsprüfung
(
TLSOptions.client()). - SHA-256 aus dem Endpunkt schützt gegen unvollständige oder vertauschte Downloads, nicht gegen einen kompromittierten Server. Die Installation startet erst nach ausdrücklicher Bestätigung.
- Keine Tokens oder Zugangsdaten im Endpunkt.
docs/credentials.txtbleibt gitignored. - macOS-Builds sind ad-hoc signiert und nicht notarisiert. Der Download über
Godot setzt kein Quarantäne-Attribut; falls Gatekeeper dennoch blockiert:
xattr -cr /Applications/Rinkplanner.app.
Tests
./tools/test.sh # enthält run_update_tests.gd
run_update_tests.gd deckt ab: Versionsvergleich (auch 0.10 > 0.9), Präfixe
und Suffixe, Plattformzuordnung, JSON-Validierung, HTTPS-Pflicht,
Datumsformat, gemerkte Version und die Dialog-/Menü-Verdrahtung. Es findet
kein Netzwerkzugriff statt.
Fehlersuche
| Symptom | Ursache/Prüfung |
|---|---|
| Kein Hinweis in der App | Automatischer Check nur im exportierten Desktop-Build; --check am Endpunkt; Version wirklich erhöht? |
| „ungültige Antwort“ | downloads fehlt/leer, version nicht numerisch oder JSON kaputt. |
| Download startet nicht | url ohne https://, HTTP-Status ≠ 200, Datei zu groß. |
| „Prüfsumme stimmt nicht“ | Endpunkt und hochgeladener Installer passen nicht zusammen; publish_version.sh erneut laufen lassen. |
| Endpunkt liefert Altes | --check; ggf. Hosting-Cache; FTP-Ziel rinkplanner.programmschmiede.de/version.json prüfen. |
| Windows bekommt keinen Hinweis | Windows-Build fehlt im Endpunkt; mit --windows veröffentlichen. |
Aktueller Stand und Übergang
- 0.2.0 ist für macOS veröffentlicht (DMG und Endpunkt).
- Windows ist noch nicht im Endpunkt, weil der vorhandene Installer noch
0.1.0 ist. Nach einem Windows-Build 0.2.0:
./tools/publish_version.sh --windows --notes "…". - Übergang von 0.1.0: Die Version 0.1.0 enthält die Update-Prüfung noch nicht. Wer sie installiert hat, muss 0.2.0 einmal manuell installieren; danach greifen die Hinweise automatisch.
- Android ist bewusst nicht Teil der automatischen Prüfung.
Checkliste für das nächste Release
- Version an allen Stellen erhöhen (siehe oben).
./tools/sync_assets.sh --check(Assets vorhanden?)../tools/test.sh.- Installer bauen (
export_macos_installer.sh, ggf.export_windows_installer.sh). - Installer nach
programmschmiede.de/rinkplanner/download/hochladen. ./tools/publish_version.sh --notes "…"(und--windows, falls gebaut)../tools/publish_version.sh --checkundtests/manual/check_update.gdgegen den Live-Endpunkt laufen lassen.