179 lines
12 KiB
Markdown
179 lines
12 KiB
Markdown
# Fehlerprotokoll (ERRORS.md)
|
|
|
|
Alle Fehler, die beim Erstellen / Bauen / Releasen von RemminaMac aufgetreten sind — mit Ursache, Fix und Status. Wird bei jedem Build fortgeschrieben.
|
|
|
|
Stand: 2026-09-21 · Version 0.1.0 · macOS arm64 · Swift 5.9+ · Xcode 15+
|
|
|
|
## Übersicht
|
|
| # | Zeitpunkt | Phase | Fehler | Schwere | Status |
|
|
|---|-----------|-------|--------|---------|--------|
|
|
| 1 | 2026-09-21 | `swift build` (debug) | `WindowGroup<some View> has no member 'windowTitle'` | blockierend | ✅ behoben |
|
|
| 2 | 2026-09-21 | `swift build -c release` | keine Fehler, nur lange Link-Zeit (~40 s) | Info | ✅ ok |
|
|
| 3 | 2026-09-21 | Release-Skript | `dist/` war nicht in `.gitignore` → Binary drohte committet zu werden | mittel | ✅ behoben (ignoriert) |
|
|
| 4 | 2026-09-21 | Gitea-Upload | `GET /api/v1/user` → `401 invalid username, password or token` mit alten Credentials | blockierend (Push/Release) | ✅ behoben — neue Credentials ok, Push + Release v0.1.0 hochgeladen |
|
|
| 5 | 2026-09-21 | App-Bundle + DMG | keine Fehler: `build-app.sh` (Signatur ok), `build-dmg.sh` (UDZO, 200K), Mount-Verifikation ok (App + Applications/Programme-Links) | Info | ✅ ok |
|
|
| 6 | 2026-09-21 | SSH verbinden | kein Terminal öffnete sich: `SSHService.openInTerminal` nutzte `NSAppleScript` → scheitert still (keine `NSAppleEventsUsageDescription`, kein Error-Handling) | blockierend | ✅ behoben — In-App-PTY-Terminal (Dracula) + `.command`-Fallback |
|
|
| 7 | 2026-09-21 | ANSI-Parser (Test) | `feed()` flusht Chunk erst NACH `parseCSI` → Text bekam den neuen statt alten Stil (`rot` mit fg=nil statt 1) | mittel | ✅ behoben — Flush vor Stilwechsel |
|
|
| 8 | 2026-09-21 | SSH-Session stirbt instant ohne Meldung | stderr hing mit am PTY: macOS verwirft ungelesene Master-Daten bei Slave-Close → „Code 255" ohne Text | blockierend | ✅ behoben — stderr→Pipe, TCP-Vorab-Check, Fehler-Banner |
|
|
| 9 | 2026-09-21 | `swift build` | `Result<Void, String>`: String conformt nicht zu Error (Folgefehler: DispatchQueue-Overload) | blockierend | ✅ behoben — Completion als `(String?) -> Void` |
|
|
| 10 | 2026-09-21 | Icon-Generator (`RenderIcon.swift`) | 3 Swift-Fehler: `guard let x = f() ?? g()` (nicht optional), `Int * CGFloat`, falscher Preview-Pfad | klein | ✅ behoben |
|
|
| 11 | 2026-09-21 | Passwort-Feature | Wunsch: Passwort + Keys speichern UND nutzen (bisher nur gespeichert, nie benutzt) | Feature | ✅ umgesetzt — Auto-Login via sshpass, sonst interaktiv |
|
|
| 12 | 2026-09-21 | „Immer Verbindung falsch" | User-Report ohne Details (Ziel/Credentials unbekannt) | offen | ⬜ Teils: Editor-Validierung + kopierbarer Fehlerbericht; warte auf Bericht |
|
|
|
|
---
|
|
|
|
## #1 — `windowTitle` existiert nicht auf `WindowGroup`
|
|
**Phase:** erster `swift build`
|
|
**Log (gekürzt):**
|
|
```
|
|
Sources/RemminaMac/RemminaMacApp.swift:14:10: error: value of type 'WindowGroup<some View>' has no member 'windowTitle'
|
|
14 | .windowTitle("RemminaMac")
|
|
```
|
|
**Ursache:** `windowTitle(_:)` ist kein Modifier für `WindowGroup`. Der Fenstertitel wird im `WindowGroup`-Init übergeben.
|
|
**Fix:** `Sources/RemminaMac/RemminaMacApp.swift`:
|
|
```swift
|
|
// vorher (falsch):
|
|
WindowGroup { ... }.windowTitle("RemminaMac")
|
|
// nachher (korrekt):
|
|
WindowGroup("RemminaMac") { ... }
|
|
```
|
|
**Verifikation:** `swift build` → `Build complete! (1.31s)`.
|
|
**Status:** ✅ behoben, kein Re-Check offen.
|
|
|
|
## #2 — Release-Build langsam, aber fehlerfrei
|
|
**Phase:** `bash scripts/build-release.sh 0.1.0` → `swift build -c release`
|
|
**Log:**
|
|
```
|
|
Building for production...
|
|
[4/5] Linking RemminaMac
|
|
Build complete! (40.54s)
|
|
```
|
|
**Ursache:** keine — Release-Optimierung + Link brauchen beim ersten Mal ~40 s.
|
|
**Fix:** keiner nötig. Bei wiederholten Builds ist es schneller (Cache in `.build/`).
|
|
**Artefakte:**
|
|
```
|
|
dist/RemminaMac-0.1.0-macos-arm64.zip (186K)
|
|
dist/RemminaMac-0.1.0-macos-arm64.zip.sha256 (c476bb3c…)
|
|
```
|
|
**Status:** ✅ ok.
|
|
|
|
## #3 — `dist/` fast committet
|
|
**Phase:** Release-Vorbereitung
|
|
**Ursache:** `dist/` enthielt ZIP + entpacktes Binary, `.gitignore` kannte es noch nicht.
|
|
**Fix:** `.gitignore` ergänzt:
|
|
```
|
|
.build/
|
|
dist/
|
|
*.zip
|
|
*.sha256
|
|
```
|
|
**Verifikation:** `git status --short` zeigt kein `dist/` mehr.
|
|
**Status:** ✅ behoben.
|
|
|
|
## Vorlage für neue Fehler
|
|
```markdown
|
|
## #N — Titel
|
|
**Phase:** ...
|
|
**Log:** ...
|
|
**Ursache:** ...
|
|
**Fix:** ...
|
|
**Verifikation:** ...
|
|
**Status:** ⬜ offen / ✅ behoben
|
|
```
|
|
|
|
## Wie Fehler hierher kommen
|
|
- Jeder `swift build` / `swift build -c release` / Skript-Lauf mit Fehler → Log-Ausschnitt + Exit-Code hier eintragen.
|
|
- Gitea-Push/Release-Fehler (z. B. 401, Repo existiert schon, Asset-Upload schlägt fehl) ebenfalls hier dokumentieren.
|
|
- Neue Tests: `AnsiParser` per `swiftc`-Harness (`/tmp`, SGR/CRLF/Clear/Map), `PTYSession` per Smoke-Test (`/bin/echo` + `ssh -G` durchs echte PTY).
|
|
|
|
## #6 — SSH-Klick öffnet kein Terminal (User-Bugreport)
|
|
**Phase:** Laufzeit, SSH-Profil → Verbinden
|
|
**Ursache:** `Services/ConnectionServices.swift` nutzte `NSAppleScript(tell application "Terminal" to do script …)`. Ohne `NSAppleEventsUsageDescription` und ohne Error-Auswertung scheitert das still — es passiert schlicht nichts.
|
|
**Fix:**
|
|
- Neu: `Services/PTYSession.swift` — echte PTY-Session (`posix_openpt`, `ssh` mit TTY), `TerminalManager` pro Profil (überlebt Tab-Wechsel).
|
|
- Neu: `Views/EmbeddedTerminalView.swift` — In-App-Terminal im Dracula-Theme (`Services/TerminalTheme.swift`, `Services/AnsiParser.swift`), Auto-Connect per `onAppear`, Eingabezeile + Passwort-Modus + `^C`/`^D`.
|
|
- `SessionView` bettet das Terminal ein (min. 380 pt), `ContentView.connect()` öffnet nur noch den Tab.
|
|
- Extern-Fallback umgebaut auf `.command`-Datei via `NSWorkspace` (keine Automation-Rechte nötig).
|
|
**Verifikation:** `swift build` ok; Parser-Harness 8/8; PTY-Smoke (`/bin/echo` → Output + Exit 0); `ssh -G example.com` durchs PTY ok.
|
|
**Status:** ✅ behoben.
|
|
|
|
## #8 — Terminal verbindet nicht, „direkt gekappt" (User-Bugreport)
|
|
**Phase:** Laufzeit, SSH-Profil → Tab öffnet, sofort „Sitzung beendet (Code 255)." — ohne jede Meldung
|
|
**Reproduktion (Harness, exakter App-Pfad `ssh -p 1 nobody@127.0.0.1`):**
|
|
```
|
|
STATE: done(exitCode: Optional(255), message: "Sitzung beendet (Code 255).")
|
|
TEXT: "\n\n— Sitzung beendet (Code 255). —\n" # <- Fehlermeldung fehlt!
|
|
```
|
|
**Ground Truth (Python-pty):** Selbst `/bin/echo hello` liefert `b''`, wenn man erst NACH Child-Exit liest; bei sofortigem Lesen kommt `b'hello-py\r\n'`. → macOS verwirft ungelesene PTY-Master-Daten beim Slave-Close (danach EIO). Unser `DispatchSourceRead` verliert dieses Rennen bei Instant-Exit-Kindern — und ssh schreibt ALLES (inkl. „Connection refused") nach stderr, das mit am PTY hing.
|
|
**Fix (`Services/PTYSession.swift`, `Services/TCPCheck.swift`, `Views/EmbeddedTerminalView.swift`):**
|
|
- stderr → `Pipe` (gepufferte Daten überleben Child-Exit garantiert), stdin/stdout bleiben am PTY (TTY erhalten für interaktive Prompts)
|
|
- `finalFlush` (non-blocking Rest-Drain) + Epoch-guarded Lifecycle (kein State-/FD-Durcheinander bei Trennen→Neuverbinden)
|
|
- TCP-Vorab-Check (Network.framework, 4 s Timeout) mit deutschen Klartext-Meldungen (refused/DNS/Timeout/Port)
|
|
- Rotes Fehler-Banner mit letzter Meldung + Diagnose- und Erneut-Buttons
|
|
**Verifikation:** Refused-Harness zeigt jetzt `ssh: connect to host 127.0.0.1 port 1: Connection refused` (PASS); Roundtrip (`cat`) PASS; `ssh -G` PASS; TCP-Harness (closed/open/empty) PASS.
|
|
**Status:** ✅ behoben.
|
|
|
|
## #9 — Build: `Result<Void, String>` ungültig
|
|
**Log:** `error: type 'String' does not conform to protocol 'Error'` (+ Folgefehler an `DispatchQueue.main.async`)
|
|
**Fix:** `TCPCheck.check` nutzt `(String?) -> Void` (nil = ok, sonst deutsche Meldung).
|
|
**Status:** ✅ behoben.
|
|
|
|
## #11 — Passwort speichern UND benutzen (User-Wunsch)
|
|
**Stand:** Passwort/Key-Passphrase wurden in der Keychain gespeichert, aber nie zum Einloggen benutzt (ssh fragte immer interaktiv).
|
|
**Umsetzung:**
|
|
- `SSHService.loginSecret()` (Profil-Passwort → Key-Passphrase), `sessionConfig()` (rein, testbar): mit Secret + sshpass → `sshpass -e ssh/sftp …` + `SSHPASS`-Env (nie Befehlszeile/Logs); sonst direkter Aufruf + interaktiver Prompt.
|
|
- `PTYSession.customEnv` + `autoLogin`-Flag, `TerminalManager` verdrahtet alles; Status zeigt „Auto-Login via Keychain".
|
|
- Editor: Gespeichert-Anzeige (✓), Löschen-Button, sshpass-Hinweis; Titel-Bug (`UUID`-Vergleich mit neuem Random-Objekt) via `isNew` ersetzt.
|
|
**Verifikation:** Config-Harness 9/9 (inkl. „Passwort nie in Befehlszeile"); echter Keychain-Roundtrip 7/7 (save/load/delete + Priorität + Fallback).
|
|
**Hinweis:** Ohne `sshpass` (`brew install sshpass`) bleibt es beim interaktiven Prompt — hier auf dem Build-Mac ebenfalls nicht installiert, getestet wurde der interaktive Pfad + Logik.
|
|
**Status:** ✅ umgesetzt.
|
|
|
|
## #10 — Icon-Generator Buildfehler
|
|
**Log:** `guard let` auf nicht-optionalem Ausdruck (`??` unwrapt schon); `Int * CGFloat`; Preview lag in `.iconset/` statt `/tmp/`.
|
|
**Fix:** `??`-Fallback direkt zuweisen; `CGFloat(...)`; Pfad korrigiert.
|
|
**Status:** ✅ behoben. Icon: `Resources/AppIcon.icns` (per `scripts/generate-icon.sh` reproduzierbar), Vorschau `docs/icon-preview.png`.
|
|
|
|
## #7 — ANSI-Parser: Text bekam falschen Stil
|
|
**Phase:** `swiftc`-Harness während #6
|
|
**Log:** `text("rot", fg: nil)` statt `fg: 1`
|
|
**Ursache:** Chunk wurde erst nach dem SGR-Wechsel geflusht.
|
|
**Fix:** `Services/AnsiParser.swift` — `flush()` vor `parseCSI`.
|
|
**Verifikation:** Harness 8/8 grün.
|
|
**Status:** ✅ behoben.
|
|
|
|
## #4 — Gitea-Upload: 401 trotz erreichbarem Server
|
|
**Phase:** `POST /api/v1/user/repos` + `GET /api/v1/user` auf `https://git.sysdaemon.xyz` (Version 1.27.3, per `/api/v1/version` bestätigt)
|
|
**Log:**
|
|
```
|
|
GET /user -> 401
|
|
{"message":"invalid username, password or token","url":"https://git.sysdaemon.xyz/api/swagger"}
|
|
```
|
|
Getestet mit Login `x3` und `x3@sysdaemon.xyz` — beide 401. Kein Quote-/Encoding-Problem (Basic-Auth via Python, kein Shell-Escaping).
|
|
**Mögliche Ursachen:**
|
|
1. Passwort falsch/ablaufen bzw. Sonderzeichen-Typo
|
|
2. Account braucht App-Token statt Passwort (Gitea: User → Einstellungen → Anwendungen → Token erzeugen)
|
|
3. Falscher Owner-/Repo-Name
|
|
**Fix (manuell, sobald Credentials stimmen):**
|
|
```bash
|
|
cd RemminaMac
|
|
git remote add origin https://<user>@git.sysdaemon.xyz/<owner>/remmina-mac.git
|
|
git push -u origin main
|
|
export GITEA_HOST="https://git.sysdaemon.xyz" GITEA_OWNER="<owner>" GITEA_REPO="remmina-mac" GITEA_TOKEN="<token>" VERSION="0.1.0"
|
|
./scripts/publish-gitea-release.sh
|
|
```
|
|
Oder mit Token als Passwort: `git push https://<owner>:<token>@git.sysdaemon.xyz/<owner>/remmina-mac.git main`.
|
|
**Lokaler Stand:** Commit `cd834dc` + `dist/RemminaMac-0.1.0-macos-arm64.zip` sind fertig und warteten nur auf den Push.
|
|
**Nachtrag 2026-09-21:** ✅ behoben — mit korrigierten Credentials: `GET /api/v1/user → 200 (login x3)`, Repo `x3/remmina-mac` erstellt (201), `git push -u origin main` ok, Release `v0.1.0` (id 1) + 2 Assets (ZIP + SHA256) hochgeladen.
|
|
**Status:** ✅ behoben.
|
|
|
|
## #12 — „Immer Verbindung falsch" (User-Report, Details offen)
|
|
**Stand:** Gemeldet ohne Ziel-Host, Banner-Text oder Credentials — aus der Ferne nicht reproduzierbar. Systematische App-Fehler als Ursache weitgehend ausgeschlossen (PTY/ssh-Pfad, Fehlertext-Anzeige, TCP-Check und Keychain-Fluss sind per Harness verifiziert).
|
|
**Häufigste reale Ursachen (Checkliste):**
|
|
1. `user@host` im Host-Feld oder `ssh://`-Präfix → jetzt Live-Warnung im Editor
|
|
2. Leerzeichen/Vertipper in Host/User → wird jetzt getrimmt + gewarnt
|
|
3. Falsches Passwort / Key ohne Passphrase-Eintrag → Banner + Diagnose nutzen
|
|
4. Server blockt (Fail2ban, nur Key-Login erlaubt) → Server-Logs prüfen
|
|
**Umgesetzt:** `Models/ProfileValidation.swift` (trimmen + Warnungen, Harness 7/7), Passwort direkt unter Benutzername, „Bericht kopieren" im Fehler-Banner (ohne Secrets).
|
|
**Offen:** Bitte Banner-Text oder kopierten Bericht hierher schicken — dann steht die Ursache in einer Zeile.
|
|
**Status:** ⬜ wartet auf Fehlerbericht.
|