rinkplanner/docs/builds.md
torsten c4488a8eb5 feat: Native Builds für Linux, Windows, macOS und Android
- Web-Export, Web-Preset und Web-Doku entfernt; Zielplattformen sind nur
  noch Desktop und Android
- Export-Presets mit vollständigen Optionssätzen für Linux, Windows,
  macOS (universal, ad-hoc) und Android (arm64-v8a, minSdk 24,
  targetSdk 36, Landscape, Immersive Mode, INTERNET-Permission)
- tools/export_linux.sh, export_windows.sh, export_macos.sh,
  export_android.sh mit gemeinsamen Helfern und tools/verify_apk.sh
- tools/setup_android.sh richtet JDK 17, Android SDK, Godot-4.7.2-
  Templates und Debug-Keystore ein und trägt die Pfade in die
  Editor-Settings ein (mit Backup)
- Eigenes App-Icon (SVG) inklusive Android-Launcher-Icons
- ETC2/ASTC-Import für Android aktiviert, Tests/Prototyp/Addon aus dem
  Export ausgeschlossen
- docs/builds.md: Bauen, Installieren per adb, Datenpfade, Release-Hinweise
2026-10-30 09:57:14 +01:00

144 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Builds: Desktop und Android
Rinkplanner wird als **Desktop-Anwendung** (Linux/Windows/macOS) und als
**Android-App** gebaut. Einen Web-Build gibt es nicht mehr: Die App braucht
lokalen Dateizugriff, ein eigenes Fenster und später einen Kontosync, der
nicht von Browser-Speicherlimits abhängt.
## Übersicht
| Ziel | Preset | Ausgabe | Größe (ca.) |
| :--- | :--- | :--- | :--- |
| Linux x86_64 | `Linux` | `build/linux/rinkplanner.x86_64` | 77 MB |
| Windows x86_64 | `Windows` | `build/windows/rinkplanner.exe` | 113 MB |
| macOS universal | `macOS` | `build/macos/rinkplanner.zip` | 64 MB |
| Android arm64 | `Android` | `build/android/rinkplanner-debug.apk` | 31 MB |
Die PCK ist bei Linux und Windows **eingebettet** (eine Datei zum
Weitergeben). `build/` ist nicht versioniert.
## Voraussetzungen
- Godot **4.7.2** (oder `GODOT=/pfad/zu/godot` setzen)
- Export-Templates derselben Version unter
`~/.local/share/godot/export_templates/4.7.2.stable/`
- Für Android zusätzlich JDK 17 + Android SDK (siehe unten)
## Desktop bauen
```bash
./tools/export_linux.sh
./tools/export_windows.sh
./tools/export_macos.sh
```
**Windows:** Icon und Versionsinformationen sind deaktiviert
(`application/modify_resources=false`), damit der Export ohne `rcedit` auf
Linux läuft. Wer das will, installiert `rcedit` und schaltet die Option im
Preset ein.
**macOS:** Das Bundle ist ad-hoc signiert, aber **nicht notarisiert**. Beim
ersten Start auf einem Mac:
```bash
xattr -cr Rinkplanner.app
open Rinkplanner.app # ggf. Rechtsklick → Öffnen
```
Für eine verteilbare App ist eine Signierung mit Developer ID und
Notarisierung auf einem Mac nötig (Preset: `codesign/codesign=3`).
## Android
### Einmalig: Toolchain einrichten
```bash
./tools/setup_android.sh
```
Das Skript (idempotent, ca. 1,6 GB Download):
1. Temurin **JDK 17** → `~/.jdks/temurin-17`
2. Android **command-line tools** → `~/Android/Sdk`
3. `platform-tools`, `build-tools;36.0.0`, `build-tools;35.0.0`,
`platforms;android-36`
4. Godot-**4.7.2-Export-Templates**
5. **Debug-Keystore** → `~/.local/share/godot/keystores/debug.keystore`
6. Trägt `java_sdk_path`, `android_sdk_path` und `debug_keystore` in
`~/.config/godot/editor_settings-4.7.tres` ein (Backup als `.bak`)
### APK bauen
```bash
./tools/export_android.sh # Debug-APK
./tools/export_android.sh debug --install # bauen + per adb installieren
```
Ausgabe: `build/android/rinkplanner-debug.apk`
Prüfen (Paketname, Version, SDK-Stufen, ABI, Landscape, Signatur):
```bash
./tools/verify_apk.sh
```
`aapt2` warnt beim Debug-APK über ein ungenutztes `mipmap/themed_icon` aus
dem Godot-Template. Das Manifest referenziert nur `@mipmap/icon`; die Warnung
ist folgenlos.
- Paket: `de.rinkplanner.app`, Label „Rinkplanner“, Version 0.1.0
- App-Icon aus `rinkplanner/icon.svg` (Launcher-Icons unter
`rinkplanner/assets/icons/android/`)
- `minSdk 24`, `targetSdk 36`, ABI **arm64-v8a** (Galaxy Tab S9+)
- Landscape, Immersive Mode, `resizeableActivity=true`
- Berechtigung `INTERNET` (für den späteren Sync)
- Template-Export ohne Gradle-Projekt (`gradle_build/use_gradle_build=false`)
### Auf dem Tablet installieren
1. Auf dem Tablet: Einstellungen → Info zu Tablet → 7× „Buildnummer“ →
Entwickleroptionen → **USB-Debugging** an
2. Tablet per USB anschließen, „Dateizugriff zulassen“ bestätigen
3. `adb devices` prüfen, dann
```bash
~/Android/Sdk/platform-tools/adb install -r build/android/rinkplanner-debug.apk
```
Alternativ die APK direkt aufs Tablet kopieren und dort öffnen
(„Unbekannte Quellen“ erlauben).
### Wo liegen die Daten?
Godot schreibt `user://` pro Plattform getrennt:
| Plattform | Pfad |
| :--- | :--- |
| Linux | `~/.local/share/godot/app_userdata/Rinkplanner/` |
| Windows | `%APPDATA%\Godot\app_userdata\Rinkplanner\` |
| macOS | `~/Library/Application Support/Godot/app_userdata/Rinkplanner/` |
| Android | App-interner Speicher (`/data/data/de.rinkplanner.app/files/`) |
Dort liegen `routines/`, `autosave.tres` und `exports/`. Die Android-Daten
sind ohne Root nicht direkt sichtbar – der Export-Dialog der App schreibt
nach `user://exports/`, von dort kann man Dateien über einen Dateimanager
mit App-Zugriff oder `adb pull` holen:
```bash
adb shell run-as de.rinkplanner.app ls files/
adb exec-out run-as de.rinkplanner.app cat files/routines/kuer.tres > kuer.tres
```
## Release-Builds
- **Android Release:** eigener Keystore nötig; im Preset
`keystore/release*` setzen und `./tools/export_android.sh release` bauen.
Der Debug-Keystore ist nur zum Testen.
- **Windows/macOS:** siehe Hinweise oben (rcedit, Codesign/Notarization).
## Nächster Schritt: Kontosync
Geplant ist ein manueller Sync über FTP: Ein Button lädt die neuesten
`.tres`-Dateien je Kür hoch bzw. herunter, Konflikte bleiben als Kopien mit
Zeitstempel erhalten. Zugangsdaten liegen in den App-Einstellungen
(`user://`), nicht im Repository.