Files
remmina-mac/docs/ERRORS.md
T

4.6 KiB

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

#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:

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

## #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.

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