Version auf 0.2.2 erhöht (project.godot, Export-Presets, Android-Code 3), Windows-Installer gebaut und hochgeladen, version.json mit Notizen veröffentlicht. Website: 0.2.2 als aktuelles Release, 0.2.1 ohne Badge; docs/updates.md nachgezogen. macOS bleibt bei 0.2.0 – das DMG lässt sich nur auf macOS bauen und ist deshalb nicht im Endpunkt.
11 KiB
Updates und Versions-Endpunkt
Stand: 2026-11-12, veröffentlichte Version 0.2.2 (Windows); macOS bleibt bei 0.2.0.
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.2 ist seit 2026-11-12 für Windows veröffentlicht: Die Oberfläche
lässt sich über Datei → Sprache auf Englisch umschalten, die Wahl wird in
user://app.cfggespeichert. Übersetzt sind Menüs, Dialoge, Prüfbericht, Cloud-/Update-Meldungen und die PDF-/SVG-Blätter (Katalog:rinkplanner/assets/i18n/strings.csv). - 0.2.1 (2026-11-12, Windows): neuer Skater im Kürkleid, kontrastreichere 3D-Bande und ein schlankerer Build (frühere Modellvarianten entfernt, Installer 29 statt 32 MB).
- macOS bleibt bei 0.2.0. Für macOS gibt es im Endpunkt bewusst keinen Eintrag; die App zeigt dort keinen Update-Hinweis, bis ein neues DMG gebaut ist (dauert nur auf macOS).
- Windows ist seit 2026-11-11 im Endpunkt; die Installer enthalten die Update-Prüfung.
- Übergang von 0.1.0: Die Version 0.1.0 enthält die Update-Prüfung noch nicht. Wer sie installiert hat, muss einmal manuell installieren (Windows: 0.2.1, macOS: 0.2.0); danach greifen die Hinweise automatisch.
- Android ist bewusst nicht Teil der automatischen Prüfung.
„Was ist neu“ auf der Website
Die Rinkplanner-Seite (https://rinkplanner.programmschmiede.de/) hat seit
dem 2026-11-12 einen Abschnitt Was ist neu mit den letzten Releases. Sie
ist zweisprachig (/de/, /en/), Quelle im Repo unter web/ (siehe
docs/website.md). Für eine neue Version:
- In
web/i18n.phpeinen neuen Blockrelease.N.*oben einfügen (beide Sprachen!), die Zähler der bestehenden Blöcke nach unten verschieben und das Badge „Aktuell“/„Current“ zum neuen Block wandern lassen. - Download-Texte mitziehen: Datum in
hero.metaunddownloads.lede, Dateigröße in der Windows-/macOS-Karte (steht direkt inweb/template.php). - Stichpunkte knapp halten und nur belegen, was wirklich drin ist – die
Formulierungen sollen zur
notes-Zeile inversion.jsonpassen. ./tools/deploy_web.sh --syncund danach--checklaufen lassen.
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).- „Was ist neu“ auf der Website ergänzen (siehe unten).
./tools/publish_version.sh --checkundtests/manual/check_update.gdgegen den Live-Endpunkt laufen lassen.