Danila Poyarkov 904f3ca390

fix: use official Homebrew cask installation guidance (#712 )

* fix: use official Homebrew cask installation guidance

* docs: guide localized pages through the old Homebrew tap

The translated getting-started pages documented the official cask but not
the migration from the archived tap, so readers of those pages had no
uninstall step for the old formula.

2026-09-17 13:36:17 +03:00

3.7 KiB

Raw Blame History

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 wydań.

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

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ł

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ą tsgo
`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

Zainstaluj Rust z toolchain stable-msvc:
```
rustup default stable-msvc
```
Zainstaluj Visual Studio Build Tools i wybierz workload Desktop development with C++.
WebView2 jest już częścią Windows 10 w wersji 1803 lub nowszej oraz Windows 11.
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

3.7 KiB Raw Blame History