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.8 KiB

Raw Blame History

Primi passi

Versione web

OpenPencil funziona direttamente nel browser e non richiede installazione. Apri app.openpencil.dev per iniziare a progettare.

Se vuoi creare un prodotto basato su OpenPencil invece di utilizzare soltanto l'applicazione predefinita, consulta la sezione Automazione e la documentazione del Vue SDK.

Applicazione desktop

Le versioni pronte per macOS, Windows e Linux sono disponibili nella pagina delle versioni.

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

Installazione in macOS con Homebrew

brew install --cask openpencil

Il comando installa l’app firmata per Mac con Apple Silicon o processore Intel dal catalogo ufficiale Homebrew. Gli aggiornamenti vengono verificati da Homebrew e possono arrivare dopo le versioni su GitHub. Nel frattempo, usa il download diretto. La CLI si installa separatamente: npm install -g @open-pencil/cli.

Se usavi il tap personalizzato archiviato, migra con:

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

Compilazione dal codice sorgente

Requisiti

Bun come runtime e package manager;
Rust soltanto per l'applicazione Tauri.

Installazione

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

Server di sviluppo

bun run dev

L'editor sarà disponibile all'indirizzo http://localhost:1420.

Comandi

Comando	Funzione
`bun run dev`	Avvia il server di sviluppo con HMR
`bun run build`	Genera la versione di produzione
`bun run check`	Esegue oxlint e controlla i tipi con tsgo
`bun run test`	Esegue i test E2E e di regressione visiva con Playwright
`bun run test:update`	Aggiorna gli screenshot di riferimento
`bun run test:unit`	Esegue gli unit test con bun:test
`bun run docs:dev`	Avvia il server di sviluppo della documentazione
`bun run docs:build`	Genera rapidamente la documentazione per la verifica locale
`bun run docs:build:production`	Genera la documentazione completa per la pubblicazione, inclusi i file per gli LLM

Applicazione Tauri

Per compilare l'applicazione Tauri sono necessari Rust e i componenti di sistema specifici della piattaforma.

macOS

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

Windows

Installa Rust con il toolchain stable-msvc:
```
rustup default stable-msvc
```
Installa Visual Studio Build Tools e seleziona il workload Desktop development with C++.
WebView2 è già incluso in Windows 10 dalla versione 1803 e in Windows 11.
Esegui:
```
bun run tauri dev
```

Linux

In Debian o Ubuntu, installa le dipendenze di sistema:

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

Quindi esegui:

bun run tauri dev

Generare un pacchetto di installazione

bun run tauri build                                    # Piattaforma corrente
bun run tauri build --target universal-apple-darwin    # Universal Binary per macOS

3.8 KiB Raw Blame History Unescape Escape