- FTP-Sync durch Cloud-Backends ersetzt (Dropbox, Google Drive) - OAuth-Flow mit nutzereigenen Tokens und App-Key-Konfiguration - Zeit-Tooltips für Timeline-Labels und Abschnittsbanner beim Playback - Tests, Build-Konfiguration und Doku aktualisiert
7.7 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 |
80 MB |
| Windows x86_64 | Windows |
build/windows/rinkplanner.exe |
116 MB |
| macOS universal | macOS |
build/macos/rinkplanner.zip |
67 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. Seit die Skater-GLB samt
Texturen in den Exporten liegt (docs/assets.md), sind die Builds etwa
6 MB größer; die Werte sind Richtwerte.
Voraussetzungen
- Godot 4.7.2 (oder
GODOT=/pfad/zu/godotsetzen) - Für die 3D-Vorschau im Build:
tools/sync_assets.sh --sync(GLB plus Texturen unterassets/external/characters/); ohne diese Dateien baut der Export den Platzhalter. - Export-Templates derselben Version unter
~/.local/share/godot/export_templates/4.7.2.stable/ - Für den Cloud-Sync:
rinkplanner/sync_apps.cfgmit den OAuth-App-Zugängen. Die Datei wird ausdocs/credentials.txterzeugt:./tools/sync_apps_config.sh; Einrichtung indocs/cloud-setup.md. Ohne die Datei baut die App, zeigt beim Verbinden aber einen Konfigurationshinweis. - 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: 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):
./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).
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 der Silhouetten-Vorlage, erzeugt mit
tools/make_app_icons.py(Launcher-Icons unterrinkplanner/assets/icons/android/); aktuell die invertierte Variante (weiße Kachel, schwarze Figur) 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 Zielgerät verifiziert
Galaxy Tab S9+ (SM-X810), 2800 × 1752, 340 dpi (Skalierung 2,125), Landscape:
- Installation per
adb install -r(Incremental Install, ca. 2 s) - Start, Zeichnen, Tippen, Labels und Zurück-Geste (beendet und speichert)
- UI-Skalierung: 56-Pixel-Ziele entsprechen echten 56 CSS-Pixeln
- App-Daten einsehbar über
adb shell run-as de.rinkplanner.app ls files/
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
-
Linux: einmalig die udev-Regel installieren, sonst meldet
adb„no permissions“ (auf einem frisch eingerichteten Rechner fehlt sie):sudo install -m 644 tools/51-android.rules /etc/udev/rules.d/ sudo udevadm control --reload-rules && sudo udevadm triggerDanach das Tablet neu anstecken.
-
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.json 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.json > kuer.json
Export-Smoke-Test
tools/check_export.sh baut den Linux-Release in ein temporäres Verzeichnis,
startet ihn headless und bricht bei Start-/Autoload-Fehlern ab. Zusätzlich
prüft es, dass keine Testskripte im Build landen und die Skater-Szene samt
Texturen enthalten ist, sofern die GLB lokal unter
assets/external/characters/ liegt.
./tools/check_export.sh
# oder zusammen mit den Headless-Tests:
./tools/test.sh --export
Fehlt die GLB auf einem frischen Checkout, bricht der Test mit einem Hinweis
auf tools/sync_assets.sh --sync ab. Für einen reinen Starttest ohne
3D-Asset: ./tools/check_export.sh --allow-placeholder.
Bekannte Grenzen
- Die obere Werkzeugleiste hat eine Mindestbreite von ca. 994 logischen Pixeln. Hochformat, geteilter Bildschirm und kleine DeX-Fenster beschneiden sie; Vollbild-Landscape ist korrekt.
- Die Android-APK enthält nur
arm64-v8a. - Die Windows-Ressourcen (Icon/Version) werden nur eingebettet, wenn
tools/setup_windows_export.shgelaufen ist. - macOS ist ad-hoc signiert, nicht notarisiert.
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).
Kontosync
Der manuelle Sync über Google Drive oder Dropbox lädt die neuesten
.json-Dateien (Legacy-.tres weiterhin) je Kür hoch bzw. herunter,
Konflikte bleiben als Kopien mit Zeitstempel erhalten. Jedes Gerät verbindet
das eigene Cloud-Konto; Refresh-Tokens liegen in den App-Einstellungen
(user://), nicht im Repository. Details in docs/sync.md und
docs/cloud-setup.md.