rinkplanner/docs/builds.md
torsten dd8cc20de8 feat: Windows-EXE mit Icon und Versionsinformationen
- Windows-Preset bettet Icon (app_icon.png), Produktname, Beschreibung
  und Version 0.1.0.0 ein (application/modify_resources=true)
- tools/setup_windows_export.sh richtet portables Wine + rcedit ohne
  Root ein, legt einen Wrapper an und setzt export/windows/rcedit
- docs/builds.md beschreibt die Einrichtung
- geprüft: 6 Icon-Größen, RT_GROUP_ICON, Version-Ressource mit
  ProductName/FileDescription/FileVersion/ProductVersion
2026-10-30 11:35:15 +01:00

5.2 KiB
Raw Blame History

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

./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):

  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

./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 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
~/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 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.