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.
132 lines
4.7 KiB
Markdown
132 lines
4.7 KiB
Markdown
# 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 <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)
|
||
|
||
```bash
|
||
./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
|
||
|
||
```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 |
|