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
|
|
|
|
# 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
|
|
|
|
|
|
```
|
|
|
|
|
|
|
2026-10-30 11:35:15 +01:00
|
|
|
|
**Windows:** Die .exe enthält Icon, Produktname, Beschreibung und Version.
|
|
|
|
|
|
Godot bettet sie mit `rcedit` ein; auf Linux läuft `rcedit` über ein
|
|
|
|
|
|
portables Wine. Einmalig einrichten (kein Root nötig):
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
./tools/setup_windows_export.sh
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Das Skript lädt Wine (Kron4ek-Build) und `rcedit` nach
|
|
|
|
|
|
`~/.local/share/rinkplanner-toolchain`, legt einen Wrapper an und trägt ihn
|
|
|
|
|
|
als `export/windows/rcedit` in die Godot-Editor-Settings ein. Die Werte
|
|
|
|
|
|
selbst stehen im Preset unter `application/*` (Icon `app_icon.png`,
|
|
|
|
|
|
Version `0.1.0.0`).
|
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
|
|
|
|
|
|
|
|
|
|
**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
|
2026-10-30 11:30:42 +01:00
|
|
|
|
- App-Icon aus der Silhouetten-Vorlage, erzeugt mit
|
|
|
|
|
|
`tools/make_app_icons.py` (Launcher-Icons unter
|
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
|
|
|
|
`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.
|