- 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
194 lines
8.6 KiB
Markdown
194 lines
8.6 KiB
Markdown
# 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.sh` installiert JDK, SDK, Godot-Templates und den
|
||
Debug-Keystore nach `~/.jdks`, `~/Android/Sdk`,
|
||
`~/.local/share/godot/export_templates/4.7.2.stable` und
|
||
`~/.local/share/godot/keystores`. Es trägt die Pfade in
|
||
`editor_settings-4.7.tres` ein (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`, ABI `arm64-v8a`
|
||
- Landscape, Immersive Mode, `resizeableActivity=true`,
|
||
Berechtigung `INTERNET`
|
||
- Template-Export ohne Gradle (`gradle_build/use_gradle_build=false`)
|
||
- `tools/verify_apk.sh` prüft Paket, Version, SDK, ABI, Landscape, Label und
|
||
Signatur (aapt2 + apksigner; apksigner braucht `java` im 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_REQUEST` und schreibt das Autosave.
|
||
Verifiziert per `pidof` vor/nach `KEYCODE_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 `rcedit` ein.
|
||
`rcedit` ist ein Windows-Programm; auf Linux läuft es über portables Wine.
|
||
- `tools/setup_windows_export.sh` lädt Wine (Kron4ek-Build) und rcedit nach
|
||
`~/.local/share/rinkplanner-toolchain`, legt einen Wrapper an und setzt
|
||
`export/windows/rcedit` in 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_VERSION`
|
||
mit 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.py` erzeugt 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 `MKD` an.
|
||
- 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_modify` je 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.
|
||
- `StreamPeerTLS` nutzt `disconnect_from_stream()`, nicht
|
||
`disconnect_from_host()`.
|
||
- `get_available_bytes()` vor der Statusprüfung erzeugt mbedTLS-Fehler;
|
||
erst Status prüfen, dann lesen.
|
||
- Downloads lesen exakt `SIZE` Bytes, damit die letzte Paketcharge nicht
|
||
verloren geht.
|
||
- Uploads über `name.uploading` + `RNFR/RNTO`, Downloads über `.part` und
|
||
`.bak` (atomare Ersetzung, kein Datenverlust bei Abbruch).
|
||
|
||
## Labels
|
||
|
||
- `PathSegment.label` (max. 40 Zeichen) mit Undo/Redo, Dirty-State und
|
||
Persistenz; `_clone_segment` kopiert 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
|
||
|
||
1. **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.
|
||
2. **Sync-Komfort:** kein automatischer Abgleich, keine Konflikt-Zusammenführung
|
||
in der UI, keine Löschweitergabe, kein Locking zwischen Geräten.
|
||
3. **Zugangsdaten:** `user://sync.cfg` liegt im Klartext im app-privaten
|
||
Speicher. Für echte Konten wäre ein Token/Backend besser als FTP.
|
||
4. **Release:** Android nutzt den Debug-Keystore; macOS ist ad-hoc signiert und
|
||
nicht notarisiert; Windows-Ressourcen brauchen das rcedit-Setup.
|
||
5. **Datenpflege:** benannte Kürläufe haben keinen „Löschen“-Befehl in der App;
|
||
Dateien müssen über den Dateimanager entfernt werden.
|
||
6. **Labels:** keine Vorlagen/Elementkürzel-Auswahl.
|
||
7. **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.
|