Skip to content

AI-native design editor. Open-source Figma alternative.

4.8 KB
Raw Blame

Pierwsze kroki

Wersja internetowa

OpenPencil działa bezpośrednio w przeglądarce i nie wymaga instalacji. Otwórz app.openpencil.dev, aby rozpocząć pracę.

Jeśli chcesz zbudować własny produkt na bazie OpenPencil, a nie tylko korzystać z gotowej aplikacji, przejdź do sekcji Automatyzacja lub dokumentacji Vue SDK.

Aplikacja na komputer

Gotowe wersje dla macOS, Windows i Linux są dostępne na stronie pobierania.

Platforma Plik
macOS (Apple Silicon) .dmg (aarch64)
macOS (Intel) .dmg (x64)
Windows (x64) .msi / .exe
Windows (ARM) .msi / .exe
Linux (x64) .AppImage / .deb

Wymagania systemowe {#system-requirements}

OpenPencil renderuje przez CanvasKit na WebGL i korzysta z nowoczesnych funkcji platformy webowej, dlatego wymaga aktualnego silnika przeglądarki. Wersja internetowa działa w Chrome 111, Edge 111, Firefox 128 i Safari 16.4 lub nowszych; przeglądarki oparte na Chromium, takie jak Brave i Opera, odpowiadają wersji Chrome, na której bazują. Aplikacja na komputer renderuje w systemowym WebView, więc jej minimum wyznacza silnik systemu operacyjnego:

Platforma Wymaganie
macOS macOS 13 Ventura lub nowszy z zainstalowanymi bieżącymi aktualizacjami Safari (Safari 16.4 trafiło do systemu w macOS 13.3).
Windows Windows 10 lub nowszy z środowiskiem Microsoft Edge WebView2 Evergreen, które aktualizuje się samo.
Linux WebKitGTK 2.40 lub nowszy (webkit2gtk-4.1).

Gdy silnik jest zbyt stary, OpenPencil zamiast pustego okna pokazuje, co należy zaktualizować. Jeśli widzisz to powiadomienie w systemie spełniającym wymagania, użyj odnośnika „Report a problem”, który uzupełnia dane przeglądarki i silnika.

Instalacja w macOS przez Homebrew

brew install --cask openpencil

Polecenie instaluje podpisaną aplikację dla komputerów Mac z Apple Silicon lub procesorem Intel z oficjalnego katalogu Homebrew. Aktualizacje są weryfikowane przez Homebrew i mogą pojawiać się później niż wydania na GitHubie. W tym czasie skorzystaj z bezpośredniego pobierania. CLI instaluje się osobno: npm install -g @open-pencil/cli.

Jeśli używałeś zarchiwizowanego własnego tapa, przeprowadź migrację:

brew uninstall open-pencil/tap/open-pencil
brew install --cask openpencil

Budowanie ze źródeł {#building-from-source}

Wymagania

  • Bun — runtime i package manager;
  • Rust — tylko do aplikacji Tauri.

Instalacja

git clone https://github.com/open-pencil/open-pencil.git
cd open-pencil
bun install

Serwer deweloperski

bun run dev

Edytor będzie dostępny pod adresem http://localhost:1420.

Polecenia

Polecenie Zastosowanie
bun run dev Uruchamia serwer deweloperski z HMR
bun run build Buduje wersję produkcyjną
bun run check Uruchamia oxlint i sprawdzanie typów za pomocą TypeScript 7
bun run test Uruchamia testy E2E i testy wyglądu w Playwright
bun run test:update Aktualizuje wzorcowe zrzuty ekranu
bun run test:unit Uruchamia testy jednostkowe za pomocą bun:test
bun run docs:dev Uruchamia serwer deweloperski dokumentacji
bun run docs:build Szybko buduje dokumentację do lokalnej weryfikacji
bun run docs:build:production Buduje pełną wersję dokumentacji do publikacji, w tym pliki dla LLM

Aplikacja Tauri

Do zbudowania aplikacji Tauri potrzebne są Rust i składniki systemowe właściwe dla danej platformy.

macOS

xcode-select --install
cargo install tauri-cli --version "^2"
bun run tauri dev

Windows

  1. Zainstaluj Rust z toolchain stable-msvc:
    rustup default stable-msvc
    
  2. Zainstaluj Visual Studio Build Tools i wybierz workload Desktop development with C++.
  3. WebView2 jest już częścią Windows 10 w wersji 1803 lub nowszej oraz Windows 11.
  4. Uruchom:
    bun run tauri dev
    

Linux

W Debianie lub Ubuntu zainstaluj zależności systemowe:

sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
  libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev

Następnie uruchom:

bun run tauri dev

Budowanie pakietu instalacyjnego

bun run tauri build                                    # Bieżąca platforma
bun run tauri build --target universal-apple-darwin    # Universal binary dla macOS