Eleven translated pages changed in English since the last release without matching updates: system requirements, the Lint tab, AI chat diff tools, collaboration with agents, design JSX imports and export fidelity, Storybook and live-app export, lint fixes, page navigation, and Checking Designs. Bring de, es, fr, it, pl, and ru up to date, add the sections the abridged translations lacked where a change landed, use each language's UI labels, and point the export page at documents list.
4.9 KiB
Erste Schritte
Webversion
OpenPencil läuft direkt im Browser und muss nicht installiert werden. Öffnen Sie app.openpencil.dev, um mit der Gestaltung zu beginnen.
Wenn Sie ein eigenes Produkt auf OpenPencil aufbauen möchten, lesen Sie den Bereich Automatisierung und die Dokumentation zum Vue SDK.
Desktop-Anwendung
Fertige Versionen für macOS, Windows und Linux finden Sie auf der Release-Seite.
| Plattform | Datei |
|---|---|
| macOS (Apple Silicon) | .dmg (aarch64) |
| macOS (Intel) | .dmg (x64) |
| Windows (x64) | .msi / .exe |
| Windows (ARM) | .msi / .exe |
| Linux (x64) | .AppImage / .deb |
Systemvoraussetzungen
OpenPencil rendert mit CanvasKit über WebGL und nutzt aktuelle Webplattform-Funktionen, daher ist eine neuere Browser-Engine erforderlich. Die Webversion unterstützt Chrome 111, Edge 111, Firefox 128 und Safari 16.4 oder neuer; Chromium-basierte Browser wie Brave und Opera richten sich nach ihrer Chrome-Version. Die Desktop-Anwendung rendert im WebView des Systems, daher bestimmt die Engine des Betriebssystems die Untergrenze:
| Plattform | Voraussetzung |
|---|---|
| macOS | macOS 13 Ventura oder neuer mit den aktuellen Safari-Updates (Safari 16.4 wurde mit macOS 13.3 ausgeliefert). |
| Windows | Windows 10 oder neuer mit der Laufzeitumgebung Microsoft Edge WebView2 Evergreen, die sich selbst aktualisiert. |
| Linux | WebKitGTK 2.40 oder neuer (webkit2gtk-4.1). |
Ist die Engine zu alt, zeigt OpenPencil an, was aktualisiert werden muss, statt ein leeres Fenster darzustellen. Erscheint dieser Hinweis auf einem System, das die Voraussetzungen erfüllt, verwenden Sie den Link „Report a problem“, der die Angaben zu Browser und Engine vorausfüllt.
Installation unter macOS mit Homebrew
brew install --cask openpencil
Der Befehl installiert die signierte App für Macs mit Apple Silicon oder Intel-Prozessor aus dem offiziellen Homebrew-Katalog. Updates werden von Homebrew geprüft und können später als GitHub-Releases erscheinen. Bis dahin steht der direkte Download bereit. Die CLI wird separat installiert: npm install -g @open-pencil/cli.
Wenn du den archivierten eigenen Tap verwendet hast, wechsle so:
brew uninstall open-pencil/tap/open-pencil
brew install --cask openpencil
Aus dem Quellcode erstellen
Voraussetzungen
Installation
git clone https://github.com/open-pencil/open-pencil.git
cd open-pencil
bun install
Entwicklungsserver
bun run dev
Der Editor ist anschließend unter http://localhost:1420 erreichbar.
Befehle
| Befehl | Zweck |
|---|---|
bun run dev |
Entwicklungsserver mit HMR starten |
bun run build |
Produktionsversion erstellen |
bun run check |
oxlint und Typprüfung mit tsgo ausführen |
bun run test |
E2E- und visuelle Regressionstests mit Playwright ausführen |
bun run test:update |
Referenz-Screenshots aktualisieren |
bun run test:unit |
Unit-Tests mit bun:test ausführen |
bun run docs:dev |
Entwicklungsserver der Dokumentation starten |
bun run docs:build |
Dokumentation schnell zur lokalen Prüfung erstellen |
bun run docs:build:production |
Vollständige veröffentlichungsfähige Dokumentation einschließlich LLM-Dateien erstellen |
Tauri-Anwendung
Zum Erstellen der Tauri-Anwendung werden Rust und plattformspezifische Systemkomponenten benötigt.
macOS
xcode-select --install
cargo install tauri-cli --version "^2"
bun run tauri dev
Windows
- Installieren Sie Rust mit der Toolchain
stable-msvc:rustup default stable-msvc - Installieren Sie die Visual Studio Build Tools mit der Workload Desktop development with C++.
- WebView2 ist in Windows 10 ab Version 1803 und in Windows 11 bereits enthalten.
- Führen Sie Folgendes aus:
bun run tauri dev
Linux
Installieren Sie unter Debian oder Ubuntu die Systemabhängigkeiten:
sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev
Führen Sie anschließend aus:
bun run tauri dev
Installationspaket erstellen
bun run tauri build # Aktuelle Plattform
bun run tauri build --target universal-apple-darwin # Universal Binary für macOS