Bisher waren beim Release sechs Stellen von Hand zu ändern; vergisst man eine, fällt es erst im Build oder beim Update-Dialog auf. - `tools/set_version.sh <x.y.z>` schreibt alle Ableitungen aus `project.godot` config/version: Windows `x.y.z.0`, macOS/Android `x.y.z`, Android `version/code = major*10000+minor*100+patch`, NSIS-Fallbacks. - `--check` prüft nur und schlägt bei Abweichung fehl; läuft jetzt in `./tools/test.sh` als erster Schritt. - `version/code` ist damit abgeleitet (0.4.0 -> 400) statt handgezählt. - Neu: `docs/deployment.md` beschreibt für Menschen die Regeln und den Ablauf über alle drei Build-Rechner (Version, Build, Upload, Endpunkt, Website, Nachkontrolle, häufige Fehler). - `docs/updates.md` verweist für Version und Checkliste dorthin, statt die Stellen doppelt zu führen.
4.7 KiB
Deployment-Leitfaden
Stand: 2026-11-13. Diese Seite beschreibt, wie aus dem Repo eine veröffentlichte Version wird: welche Zahl woher kommt, wer was baut, wohin es geht und was danach auf der Website passiert.
Die Details der einzelnen Teile stehen in docs/builds.md (Builds),
docs/updates.md (Update-Endpunkt) und docs/website.md (Seite). Hier steht,
wie sie zusammenhängen.
Die eine Quelle
rinkplanner/project.godot→config/versionist die einzige Wahrheit.
Alles andere wird daraus abgeleitet. Die Laufzeit liest sie
(UpdateInfo.current_version()), publish_version.sh liest sie, und
tools/set_version.sh schreibt die Ableitungen.
| Stelle | Ableitung | Warum |
|---|---|---|
project.godot → config/version |
x.y.z |
Quelle |
Presets → application/file_version, product_version |
x.y.z.0 |
Windows will vier Segmente |
Presets → application/short_version, application/version |
x.y.z |
macOS |
Presets → version/name |
x.y.z |
Android-Anzeige |
Presets → version/code |
major×10000 + minor×100 + patch |
Android vergleicht nur „größer“ |
windows_installer.nsi → APP_VERSION |
x.y.z.0 |
Fallback, falls das Preset fehlt |
export_windows_installer.sh → VERSION-Default |
x.y.z.0 |
dito |
Beispiel: 0.4.0 → Windows 0.4.0.0, Android-Code 400; 0.4.1 → 401;
1.0.0 → 10000.
Version setzen und prüfen
./tools/set_version.sh 0.4.1 # schreibt alle Stellen
./tools/set_version.sh --check # prüft nur, Exit 1 bei Abweichung
--check läuft in ./tools/test.sh. Wer die Version an einer Stelle von Hand
ändert und die anderen vergisst, bekommt also eine rote Suite statt eines
stillen Fehlers im Build.
Der Ablauf eines Releases
Die Builds entstehen auf drei Rechnern: Linux (Windows, Android), Mac (macOS), Tablet (Abnahme). Ein Skript für alles wäre eine Illusion — die Reihenfolge ist deshalb bewusst zweistufig.
1. Vorbereiten
./tools/set_version.sh 0.5.0
./tools/test.sh # enthält set_version --check und check_rules.sh
2. Android (nur Testgerät, nicht im Endpunkt)
./tools/export_android.sh debug --install
Prüfen: ./tools/verify_apk.sh (Paketname, Version, ABI, Landscape, Signatur).
Ein verteilbares APK braucht einen Release-Keystore — offen (Roadmap).
3. Windows (auf Linux)
./tools/export_windows_installer.sh
# hochladen nach <FTP_DIRECTORY>/download/rinkplanner-setup.exe
./tools/publish_version.sh --windows --notes "…"
Nur der Installer wird verteilt, nicht die rinkplanner.exe davor.
4. macOS (auf dem Mac)
./tools/export_macos_installer.sh
# DMG hochladen nach <FTP_DIRECTORY>/download/rinkplanner-setup.dmg
./tools/publish_version.sh --notes "…"
publish_version.sh übernimmt den Eintrag der jeweils anderen Plattform aus
dem Live-Endpunkt, sofern die Version dort schon dieselbe ist. Wer zuerst
veröffentlicht, hat also nur seine Plattform drin — das ist normal und wird
mit dem zweiten Lauf ergänzt.
5. Endpunkt prüfen
./tools/publish_version.sh --check
Erwartet: beide Plattformen, Prüfsummen, notes, released = heute. Ein
Gegencheck aus der App: godot --headless --path rinkplanner --script res://tests/manual/check_update.gd.
6. Website
In web/i18n.php einen Block release.N.* oben einfügen (beide Sprachen),
die Zähler der bestehenden Blöcke nach unten schieben und das Badge
„Aktuell“/„Current“ mitnehmen. Datum in hero.meta und downloads.lede
nachziehen, Dateigrößen in web/template.php prüfen (stehen dort als Text).
./tools/deploy_web.sh --all
7. Nachkontrolle
https://rinkplanner.programmschmiede.de/version.jsonzeigt beide Plattformen (Browser, ohne Cache).- Beide Download-URLs antworten mit
200und der erwartetenContent-Length. deploy_web.sh --allmeldet „Alle Prüfungen bestanden“.
Was bewusst Handarbeit bleibt
- Die Stichpunkte im Website-Block und
notesim Endpunkt. Version und Datum ließen sich erzeugen, die Aussage „was ist wirklich neu“ nicht. - Der Zeitpunkt der macOS-Veröffentlichung. Sie hängt am Mac, nicht am Repo.
Häufige Fehler
| Symptom | Ursache |
|---|---|
set_version.sh --check schlägt fehl |
eine Stelle von Hand geändert — Skript laufen lassen |
| Update-Dialog nennt alte Neuerungen | notes beim zweiten publish_version.sh vergessen |
| Mac bekommt keinen Hinweis | 0.5.0 veröffentlicht, DMG fehlt im Endpunkt (downloads.macos) |
| „Prüfsumme stimmt nicht“ | Endpunkt und hochgeladener Installer passen nicht zusammen |
| Android installiert nicht | version/code nicht größer als die installierte Fassung |