Dokumentation

Installieren & aktualisieren

Was du hier lernst

Die App unter macOS, Windows oder Linux installieren, den Befehl vitrine im Terminal verfügbar machen, aktuell halten – oder aus dem Quellcode bauen.

Download

Releases erscheinen auf GitHub Releases (verlinkt auf der Download-Seite):

PlattformAppNur Kommandozeilen-Tool
macOS 11 oder neuer (Apple Silicon und Intel)VitrineStudio_macos_universal.dmgvitrine-cli_macos_universal.tar.gz
Windows 10/11 (x64)VitrineStudio_windows_x64-setup.exevitrine-cli_windows_x64.zip
Linux (x86_64)VitrineStudio_linux_x86_64.AppImage, …_amd64.deb, …_x86_64.rpmvitrine-cli_linux_x86_64.tar.gz
Linux (aarch64 / arm64)–vitrine-cli_linux_aarch64.tar.gz
Linux, statischer Build (jede Distribution, Alpine)–vitrine-cli_linux_x86_64-musl.tar.gz, vitrine-cli_linux_aarch64-musl.tar.gz

Die Archive „nur Kommandozeilen-Tool“ sind für Build-Server und CI gedacht, wo du die App nicht brauchst. Die normalen Linux-Builds brauchen glibc 2.35 oder neuer (Ubuntu 22.04, Debian 12 und neuer); die statischen -musl-Builds haben keine Abhängigkeiten und laufen auf jedem Linux, auch auf Alpine. Für CI gibt es außerdem ein Container-Image mit dem Kommandozeilen-Tool (amd64 und arm64): ghcr.io/vitrinestudio-app/vitrine-cli – siehe Automatisierung.

Jedes Release enthält außerdem SHA256SUMS.txt, mit dem du deinen Download prüfen kannst:

sha256sum -c SHA256SUMS.txt --ignore-missing

Installieren

macOS: Öffne die .dmg und zieh Vitrine Studio in Programme.

Windows: Starte das Setup. Es installiert nur für dein Benutzerkonto (keine Administratorrechte nötig) und bietet an, den Befehl vitrine zu deinem PATH hinzuzufügen.

Linux: Mach das AppImage ausführbar (chmod +x) und starte es, oder installiere .deb / .rpm mit deinem Paketmanager.

Warnungen „unbekannter Entwickler“

In den Versionshinweisen steht, welche Versionen signiert sind. Eine (noch) nicht signierte Version zeigt beim ersten Start eine Warnung:

  • macOS: Rechtsklick auf die App → Öffnen, oder Systemeinstellungen → Datenschutz & Sicherheit → Dennoch öffnen.
  • Windows SmartScreen: Weitere Informationen → Trotzdem ausführen.

Zu Windows: Die Windows-Version ist vorerst nicht code-signiert, deshalb zeigt jede Version diese Warnung. Windows meldet „Der Computer wurde durch Windows geschützt“ mit Herausgeber: Unbekannter Herausgeber – das heißt nur, dass das Setup kein Zertifikat trägt, nicht dass etwas damit nicht stimmt. Wenn du magst, prüfst du den Download vorher mit SHA256SUMS.txt (Get-FileHash in der PowerShell zeigt die SHA-256-Prüfsumme) und wählst dann Weitere Informationen → Trotzdem ausführen. Updates, die du in der App installierst, werden gegen die eigene Update-Signatur von Vitrine Studio geprüft.

Beim ersten Start einer neu signierten Version fragt macOS eventuell einmal, ob Vitrine Studio seine eigenen Schlüsselbund-Einträge weiter verwenden darf – erlaube es (ein Eintrag ist an die Signatur der App gebunden, die sich geändert hat). Gemeint sind nur die Einträge, die Vitrine Studio selbst angelegt hat: die Store-Schlüssel, die du in der App eingetragen hast, und gegebenenfalls deine Anmeldung bei der Vorlagen-Galerie (Dienst app.vitrinestudio). Andere Einträge in deinem Schlüsselbund liest die App nicht.

Das Kommandozeilen-Tool

Das Kommandozeilen-Tool vitrine steckt schon in der App – du musst nichts extra laden:

InstallationWo vitrine liegt
macOS-App/Applications/Vitrine Studio.app/Contents/MacOS/vitrine
Windows-Setupvitrine.exe im Installationsordner
Linux deb/rpm/usr/bin/vitrine (schon im PATH)

Damit du es in jedem Terminal einfach als vitrine aufrufen kannst: App-Einstellungen → Kommandozeilen-Tool → Kommandozeilen-Tool installieren…

  • macOS legt die Verknüpfung /usr/local/bin/vitrine an (und fragt nach deinem Administrator-Passwort, wenn der Ordner nicht beschreibbar ist).
  • Windows fügt den Installationsordner zu deinem Benutzer-PATH hinzu – öffne danach ein neues Terminal.
  • deb/rpm: nichts zu tun.
  • AppImage: aus dem Image heraus nicht möglich; lade stattdessen das CLI-Archiv.

Ein anderes Programm namens vitrine wird nie ersetzt. Im Terminal geht das Gleiche mit dem vollen Pfad: vitrine install-cli (--status zeigt den Stand, --remove macht es rückgängig, --yes spart die Rückfrage).

Updates

Die App sucht beim Start einmal am Tag nach einer neuen Version (App-Einstellungen → Updates → Einmal am Tag nach Updates suchen, standardmäßig an) und immer dann, wenn du Nach Updates suchen… wählst (☰-Menü, macOS-App-Menü oder App-Einstellungen). Sie fragt nur GitHub, ob es eine neuere Version gibt – keine persönlichen Daten, keine Statistik.

Gibt es ein Update, wählst du Später, Versionshinweise oder Installieren und neu starten. Ohne deinen Klick wird nichts installiert; der Download wird zuerst gegen seine Signatur geprüft, dann startet die App neu (dein Projekt ist ohnehin gespeichert – jede Änderung wird es).

  • macOS-App, Windows-Setup und AppImage aktualisieren sich selbst.
  • deb/rpm-Installationen zeigen nur den Hinweis – installiere das neue Paket von der Release-Seite.
  • Selbst gebaute Versionen suchen nie nach Updates.

Wo Vitrine Studio seine Daten ablegt

Projekte liegen, wo du sie hinlegst. Die eigenen Daten der App – Einstellungen, zuletzt geöffnete Projekte, importierte Geräte-Frames, deine Vorlagen – liegen hier:

SystemOrdner
macOS~/Library/Application Support/app.vitrinestudio/
Windows%APPDATA%\vitrinestudio\ (config\ und data\)
Linux~/.config/vitrinestudio/ (Einstellungen) und ~/.local/share/vitrinestudio/ (Daten)

Store-Schlüssel liegen nicht in diesen Ordnern, sondern im Schlüsselbund des Systems (siehe Store-Upload). Um einen eigenen App-Datenordner zu nutzen (für Tests oder CI), setze VITRINE_APP_DIR=<dir> oder gib --app-dir an, wo ein Befehl das anbietet.

Aus dem Quellcode bauen

Du brauchst rustup (die festgelegte Rust-Toolchain installiert sich selbst) und für die Desktop-App die Tauri-2-Voraussetzungen deines Systems.

git clone https://github.com/vitrinestudio-app/vitrine.git
cd vitrine
cargo run -p vitrine-gui --release              # die Desktop-App
cargo install --path crates/cli                  # das Kommandozeilen-Tool `vitrine`
vitrine export --project tests/fixtures/example  # am Beispielprojekt ausprobieren

tests/fixtures/example ist Fernwood, ein ausgedachter Gartenplaner mit sechs Smartphone-Seiten sowie iPad-, Mac-, Web- und Banner-Zielen auf Englisch, Deutsch, Französisch und kanadischem Französisch – ein guter Spielplatz.

Lizenz

Vitrine Studio ist freie Software unter der GNU GPL v3 oder neuer. Die App bringt ihre Lizenztexte und Hinweise zu Drittkomponenten mit (macOS: Vitrine Studio.app/Contents/Resources/licenses/); der Quellcode eines Releases ist sein Git-Tag. Name und Logo fallen nicht unter die GPL.

Diese Seite auf GitHub verbessern