- docs/findings-2026-10-30.md: Gerät, Toolchain, Android-APK, Windows- Ressourcen, Icon-Pipeline, Sync-Regeln und -Fehler, Labels, Tests, offene Punkte - Roadmap: Tablet-Test, Icons und rcedit als erledigt markiert; nächste Session auf Element-Marker gesetzt, danach Sync-Komfort und Layout - builds.md: Zielgerät-Verifikation, invertiertes Icon, bekannte Grenzen (Hochformat/DeX, arm64, rcedit-Setup, macOS-Signierung) - sync.md: Erfahrungen mit dem Zielserver (FTPS-Zertifikat, MLSD/MDTM, Ordneranlage) - architecture.md: Sync-Testanzahl und Verweis auf die Findings
8.6 KiB
8.6 KiB
Findings – Session 2026-10-30
Zusammenfassung der Erkenntnisse aus der Session, in der Rinkplanner von der Web-Idee auf native Builds umgestellt, um Labels und den FTP-Sync erweitert und erstmals auf dem Ziel-Tablet getestet wurde.
Ziel und Ergebnis
| Ziel | Ergebnis |
|---|---|
| Web-Build aufgeben, native Builds | Linux, Windows, macOS, Android gebaut |
| Tablet-Test | Galaxy Tab S9+ installiert, gestartet, bedient |
| Segment-Labels | umgesetzt inkl. Ein-/Ausblenden und Export |
| Kontosync | manueller FTP-/FTPS-Sync, gegen den echten Server geprüft |
| App-Icon | Silhouette, dunkle und invertierte Variante |
| Windows-EXE | Icon + Versionsinfos über rcedit (Wine) |
Gerät und Umgebung
- Tablet: Samsung Galaxy Tab S9+ (SM-X810), Auflösung 2800 × 1752, Dichte 340 dpi → Skalierung 2,125, logische Fläche ca. 1317 × 824. Die Android-Version wurde vor dem Abstecken nicht protokolliert.
- Host: Pop!_OS/Ubuntu (Noble), Godot 4.7.2, Temurin JDK 17.0.21,
Android build-tools 36.0.0 und 35.0.0, Platform
android-36, portables Wine 11.20, rcedit 2.0.0. - Builds: Linux 71 MB, Windows 105 MB, macOS 58 MB, Android-Debug-APK 28 MB.
Android
Toolchain
tools/setup_android.shinstalliert JDK, SDK, Godot-Templates und den Debug-Keystore nach~/.jdks,~/Android/Sdk,~/.local/share/godot/export_templates/4.7.2.stableund~/.local/share/godot/keystores. Es trägt die Pfade ineditor_settings-4.7.tresein (Backups als.bak).- Der Debug-Keystore war die fehlende Zutat für den ersten Fehlschlag
(
keytool-Aufruf ohne-genkeypair); danach signierte Godot das APK. - ETC2/ASTC muss importiert werden
(
rendering/textures/vram_compression/import_etc2_astc=true), sonst bricht der Android-Export ab. - Export ausschließen:
tests/*,prototype/*,addons/*,assets/models/*– spart ca. 2,5 MB und hält Editor-/Testcode aus dem APK.
APK
de.rinkplanner.app, Version 0.1.0, Label „Rinkplanner“minSdk 24,targetSdk 36, ABIarm64-v8a- Landscape, Immersive Mode,
resizeableActivity=true, BerechtigungINTERNET - Template-Export ohne Gradle (
gradle_build/use_gradle_build=false) tools/verify_apk.shprüft Paket, Version, SDK, ABI, Landscape, Label und Signatur (aapt2 + apksigner; apksigner brauchtjavaim PATH).
Installation und Betrieb
adb install -r …nutzt Incremental Install (ca. 2 s).- Debug-APK ist debuggbar: App-Daten über
adb shell run-as de.rinkplanner.app ls files/routines/einsehbar. - Beenden: Zurück-Geste (oder Nav-Bar-Zurück) beendet die App; dabei
greift
NOTIFICATION_WM_CLOSE_REQUESTund schreibt das Autosave. Verifiziert perpidofvor/nachKEYCODE_BACK. - Entwickleroptionen: Die Buildnummer liegt in One UI unter Info zu Tablet → Softwareinformationen, nicht direkt in „Info zu Tablet“.
Beobachtungen
- Direkt nach dem Start steht das Fenster kurz im Hochformat (1752 × 2800), bevor Android auf Landscape dreht. In diesem Moment ist die obere Leiste zu breit und wird beschnitten – rein kosmetisch, nach der Drehung korrekt.
- Die UI-Skalierung (
content_scale_factor = screen_get_scale()) ergibt auf dem Gerät echte 56-CSS-Pixel-Ziele (≈ 1,3 cm) und scharfe Darstellung. - Godot emuliert auf Android Maus aus Touch
(
emulate_mouse_from_touch); der Guard gegen synthetische Maus-Events aus der Web-Phase bleibt deshalb sinnvoll.
Windows-Export mit Ressourcen
- Godot bettet Icon, Produktname, Beschreibung und Version per
rceditein.rceditist ein Windows-Programm; auf Linux läuft es über portables Wine. tools/setup_windows_export.shlädt Wine (Kron4ek-Build) und rcedit nach~/.local/share/rinkplanner-toolchain, legt einen Wrapper an und setztexport/windows/rceditin den Editor-Settings.- Godot konvertiert das PNG-Icon selbst in ein ICO (6 Größen, 16–256 px).
- Verifikation mit
pefile:RT_ICON(6),RT_GROUP_ICON,RT_VERSIONmit ProductName „Rinkplanner“, FileDescription „2D-Whiteboard für Eiskunstlauf“, FileVersion/ProductVersion 0.1.0.0.
Icons
- Vorlage:
figure-skating-silhouette-small.png(454 × 454, Alphakanal) aus dem externen Workbench-Archiv. tools/make_app_icons.pyerzeugt Master (1024 px, abgerundet), Legacy-, Adaptive- und Monochrom-Icon. Varianten:--inverted(weiß/schwarz) bzw.--background/--figure.- Gewählt wurde die invertierte Variante: weiße Kachel, schwarze Biellmann-Silhouette. Auf dem Tablet im Launcher geprüft.
Sync (FTP)
Server-Eigenschaften
- Erreichbar auf Port 21, unterstützt
AUTH TLS(explizites FTPS),MLST,MDTM,MFMT,EPSV,CCC,LANG. - Das TLS-Zertifikat hat keinen zum Host passenden Namen (leeres CN/SAN). Strenge Prüfung schlägt fehl; die App braucht dafür die Option „Server-Zertifikat prüfen“ aus. Die Verbindung bleibt verschlüsselt.
- Zielordner existiert in Kleinschreibung; die App wechselt direkt hinein
und legt ihn bei Bedarf per
MKDan. - Schreib- und Löschtest über den Client bestanden; ein Testlauf gegen den echten Server (Upload, Skip, Download, Übernahme, Konflikt, Aufräumen) lief grün.
Regeln
- Zuordnung über den Dateinamen (aus dem Kür-Titel).
- Gemeinsamer Stand in
user://sync_state.cfg(local_mtime,remote_modifyje Datei). - Nur lokal → Upload; nur Server → Download; einseitig geändert → Richtung.
- Beide seit dem letzten Sync geändert → Konflikt: lokale Fassung bleibt
Hauptdatei, Serverfassung als
(Server …)-Kopie. - Beide vorhanden, aber kein gemeinsamer Stand (neues Gerät) →
Server übernimmt den Namen, lokale Fassung als
(Lokal …)-Kopie. - Löschungen werden nicht übertragen; Umbenennen erzeugt zwei Dateien.
- Ablauf im Thread, Fortschritt in der Statusleiste, Zusammenfassung im Dialog; geöffnete Kür wird nur neu geladen, wenn sie nicht dirty ist.
Behobene Fehler beim Bau des Clients
- TLS-Handshake auf dem Datenkanal muss nach dem Transferbefehl
(
RETR/STOR/MLSD) erfolgen, nicht direkt nach dem Verbinden. StreamPeerTLSnutztdisconnect_from_stream(), nichtdisconnect_from_host().get_available_bytes()vor der Statusprüfung erzeugt mbedTLS-Fehler; erst Status prüfen, dann lesen.- Downloads lesen exakt
SIZEBytes, damit die letzte Paketcharge nicht verloren geht. - Uploads über
name.uploading+RNFR/RNTO, Downloads über.partund.bak(atomare Ersetzung, kein Datenverlust bei Abbruch).
Labels
PathSegment.label(max. 40 Zeichen) mit Undo/Redo, Dirty-State und Persistenz;_clone_segmentkopiert das Feld.- Dialog über „Label“ in der Timing-Leiste, Enter übernimmt, leeres Feld entfernt; globaler Schalter „Labels“ blendet die Ansicht aus.
- Canvas: Pill am Segmentmittelpunkt, gelber Rahmen bei Auswahl, keine Labels auf Ghosting-Abschnitten.
- SVG:
<text>mit weißer Kontur (paint-order="stroke"), korrekt escaped. PNG: Labels immer enthalten.
Tests
./tools/test.sh ist grün mit 500 Assertions:
| Suite | Assertions |
|---|---|
| Model | 55 |
| Canvas | 90 |
| Whiteboard (inkl. Labels, Sync-Dialog) | 149 |
| History | 53 |
| Playback | 38 |
| Timing | 41 |
| Export | 19 |
| Touch/Layout | 21 |
| Performance (480 Segmente) | 2 |
| Sync (Plan, Parser, State) | 32 |
Zusätzlich manuell/visuell geprüft: Launcher-Icon, App-Start, Landscape, Zeichnen/Tippen, Labels, Back-Geste, Windows-Ressourcen, FTP-E2E.
Offene Punkte und Risiken
- Hochformat / Multi-Window / DeX: Die obere Leiste hat eine minimale Breite von ca. 994 logischen Pixeln. Unterhalb (Hochformat, geteilter Bildschirm, kleines DeX-Fenster) wird sie beschnitten. Lösung: umbruchfähige Werkzeugleiste oder zweite Zeile.
- Sync-Komfort: kein automatischer Abgleich, keine Konflikt-Zusammenführung in der UI, keine Löschweitergabe, kein Locking zwischen Geräten.
- Zugangsdaten:
user://sync.cfgliegt im Klartext im app-privaten Speicher. Für echte Konten wäre ein Token/Backend besser als FTP. - Release: Android nutzt den Debug-Keystore; macOS ist ad-hoc signiert und nicht notarisiert; Windows-Ressourcen brauchen das rcedit-Setup.
- Datenpflege: benannte Kürläufe haben keinen „Löschen“-Befehl in der App; Dateien müssen über den Dateimanager entfernt werden.
- Labels: keine Vorlagen/Elementkürzel-Auswahl.
- Protokollierung: Android-Version des Testgeräts nicht erfasst.
Nächste Schritte
Empfohlen für die nächste Session: Element-Marker (Sprungpunkte,
Pirouettenzentren, Sequenzbereiche) inklusive Inspector, Darstellung und
Export – siehe docs/roadmap.md. Danach Sync-Komfort und Layout-Härtung.