2.9 KiB
title, linkTitle, weight, toc
| title | linkTitle | weight | toc |
|---|---|---|---|
| Installation | Installation | 2 | true |
Schritt-für-Schritt-Anleitung für die Installation der Desktop-App.
Voraussetzungen
| Plattform | Status | Versionen |
|---|---|---|
| macOS Apple Silicon (M1 – M4) | ✅ Unterstützt | macOS 12+ |
| macOS Intel | ⚠ Build auf Anfrage | macOS 12+ |
| Linux | 🕐 Geplant | — |
| Windows | 🕐 Geplant | — |
Eine Portierung auf Linux und Windows ist mit Tauri 2 möglich. Issue erstellen, wenn du eine Plattform brauchst.
1 · Download
Aktueller Build: Downloads-Seite oder direkt Releases auf Gitea.
| Datei | Plattform |
|---|---|
RAPPORT_<version>_aarch64.dmg |
macOS Apple Silicon |
RAPPORT_<version>_x86_64.dmg |
macOS Intel (auf Anfrage) |
2 · DMG öffnen & installieren
- DMG doppelklicken
- Rapport.app in den Applications-Ordner ziehen
- DMG auswerfen
3 · Erster Start (macOS Gatekeeper)
Beim ersten Start verweigert macOS den Start, weil die Pre-Release-Builds Tauri-signiert, aber (noch) nicht Apple-notarisiert sind.
Lösung
- Systemeinstellungen → Datenschutz & Sicherheit öffnen
- Bis ganz nach unten scrollen — es erscheint:
"Rapport" wurde blockiert, da es nicht von einem identifizierten Entwickler stammt.
- Auf "Trotzdem öffnen" klicken
- Bestätigen
Ab dem zweiten Start läuft Rapport ohne Rückfragen.
Alternative (Terminal)
Falls der GUI-Weg nicht funktioniert:
xattr -d com.apple.quarantine /Applications/Rapport.app
Das entfernt das Quarantäne-Flag und macOS akzeptiert den Start.
4 · Erstes Setup
Beim ersten Start zeigt Rapport den Setup-Bildschirm. Hier werden die Stammdaten erfasst — siehe Einrichtung.
5 · Update-Strategie
Ab Version 0.7.0 prüft Rapport beim Start automatisch auf neue Versionen (siehe Auto-Updater). Updates können in den Einstellungen deaktiviert werden.
Manuelle Updates: einfach das neuere DMG installieren — die Daten bleiben erhalten, da sie unabhängig von der App liegen (siehe Datenhaltung).
Deinstallation
# App entfernen
rm -rf /Applications/Rapport.app
# Daten entfernen (optional!)
rm -rf "~/Library/Application Support/com.rapport.app"
# Caches
rm -rf "~/Library/Caches/com.rapport.app"
rm -rf "~/Library/WebKit/com.rapport.app"
Achtung: Schritt 2 löscht alle Rapport-Daten unwiederbringlich. Vorher Backup machen — siehe Datenhaltung.
Bekannte Probleme
| Problem | Lösung |
|---|---|
| App lässt sich nicht öffnen trotz Freigabe | Terminal-Variante mit xattr |
| "Rapport is damaged" | DMG erneut von Gitea ziehen (Browser-Cache hat evtl. Müll) |
| Schwarzer Bildschirm beim Start | ~/Library/WebKit/com.rapport.app löschen, neu starten |
Mehr unter Troubleshooting.