openpencil/packages/docs/it/getting-started.md

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

Requisiti di sistema

OpenPencil esegue il rendering con CanvasKit su WebGL e usa funzionalità recenti della piattaforma web, quindi richiede un motore del browser aggiornato. L’app web supporta Chrome 111, Edge 111, Firefox 128 e Safari 16.4 o versioni successive; i browser basati su Chromium, come Brave e Opera, seguono la versione di Chrome. L’app desktop usa il WebView di sistema, quindi il requisito minimo dipende dal motore del sistema operativo:

Piattaforma	Requisito
macOS	macOS 13 Ventura o successivo con gli aggiornamenti correnti di Safari installati (Safari 16.4 è incluso in macOS 13.3).
Windows	Windows 10 o successivo con il runtime Evergreen di Microsoft Edge WebView2, che si aggiorna da solo.
Linux	WebKitGTK 2.40 o successivo (webkit2gtk-4.1).

Se il motore è troppo vecchio, OpenPencil mostra cosa aggiornare invece di una finestra vuota. Se vedi questo avviso su un sistema che soddisfa i requisiti, usa il link «Report a problem», che precompila i dettagli di browser e motore.

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

1. Installa Rust con il toolchain stable-msvc:

   rustup default stable-msvc
   

2. Installa Visual Studio Build Tools e seleziona il workload Desktop development with C++.
3. WebView2 è già incluso in Windows 10 dalla versione 1803 e in Windows 11.
4. 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