52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
# 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
|