# 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/version` ist 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 ```bash ./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 ```bash ./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) ```bash ./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) ```bash ./tools/export_windows_installer.sh # hochladen nach /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) ```bash ./tools/export_macos_installer.sh # DMG hochladen nach /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 ```bash ./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). ```bash ./tools/deploy_web.sh --all ``` ### 7. Nachkontrolle - `https://rinkplanner.programmschmiede.de/version.json` zeigt beide Plattformen (Browser, ohne Cache). - Beide Download-URLs antworten mit `200` und der erwarteten `Content-Length`. - `deploy_web.sh --all` meldet „Alle Prüfungen bestanden“. ## Was bewusst Handarbeit bleibt - **Die Stichpunkte im Website-Block und `notes` im 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 |