# Installation

## Voraussetzungen
- macOS 14+
- Xcode 15+ (für GUI-Run) oder nur Swift-Toolchain 5.9+ (für CLI-Build)

## Variante A: Xcode (empfohlen für GUI)
1. `open Package.swift` in `RemminaMac/`
2. Target `RemminaMac` wählen, Destination `My Mac`
3. `Cmd+R` → App startet
4. Erster Start legt an:
   - `~/Library/Application Support/RemminaMac/profiles.json`
   - `~/Library/Application Support/RemminaMac/sshkeys.json`

## Variante B: Swift CLI
```bash
cd RemminaMac
swift build
.build/debug/RemminaMac
```

## Variante C: Release-Binary (ohne Xcode)
```bash
./scripts/build-release.sh
unzip dist/RemminaMac-*-macos-arm64.zip -d /tmp/rmm
/tmp/rmm/RemminaMac
```

## Variante D: Installer-DMG (Empfohlen für Endnutzer)
1. `RemminaMac-0.1.0-macos-arm64.dmg` aus dem Gitea-Release laden (oder lokal: `./scripts/build-app.sh 0.1.0 && ./scripts/build-dmg.sh 0.1.0`)
2. DMG doppelklicken → Finder-Fenster mit `RemminaMac.app` + `Programme`-Link
3. `RemminaMac.app` auf `Programme` ziehen → liegt in `/Applications/RemminaMac.app`
4. Auswerfen, aus Programme starten. Beim ersten Start: Rechtsklick → Öffnen (ad-hoc-Signatur, kein Apple-Notarization).
```bash
# Prüfen:
spctl -a -vv dist/RemminaMac.app
hdiutil verify dist/RemminaMac-0.1.0-macos-arm64.dmg
```

## RDP-Voraussetzungen
```bash
# Für volle RDP-Unterstützung:
brew install freerdp
which xfreerdp
# Ohne FreeRDP: Microsoft Remote Desktop aus dem App Store installieren
```

## Troubleshooting
- `swift build` schlägt fehl → `swift --version` prüfen (>= 5.9), Xcode Command Line Tools: `xcode-select --install`
- Keychain-Prompt → einmal erlauben, Service `RemminaMac`
- `xfreerdp` nicht gefunden → Fallback nutzt `rdc://`, braucht MS Remote Desktop