- 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
4.9 KiB
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/godotsetzen) - 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
./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:
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
./tools/setup_android.sh
Das Skript (idempotent, ca. 1,6 GB Download):
- Temurin JDK 17 →
~/.jdks/temurin-17 - Android command-line tools →
~/Android/Sdk platform-tools,build-tools;36.0.0,build-tools;35.0.0,platforms;android-36- Godot-4.7.2-Export-Templates
- Debug-Keystore →
~/.local/share/godot/keystores/debug.keystore - Trägt
java_sdk_path,android_sdk_pathunddebug_keystorein~/.config/godot/editor_settings-4.7.tresein (Backup als.bak)
APK bauen
./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):
./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 unterrinkplanner/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
- Auf dem Tablet: Einstellungen → Info zu Tablet → 7× „Buildnummer“ → Entwickleroptionen → USB-Debugging an
- Tablet per USB anschließen, „Dateizugriff zulassen“ bestätigen
adb devicesprüfen, dann
~/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:
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 releasebauen. 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.