b9753aa016
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.
131 lines
4.8 KiB
Markdown
131 lines
4.8 KiB
Markdown
# Primi passi
|
||
|
||
## Versione web
|
||
|
||
OpenPencil funziona direttamente nel browser e non richiede installazione. Apri [app.openpencil.dev](https://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](/programmable/) e la documentazione del [Vue SDK](/programmable/sdk/).
|
||
|
||
## Applicazione desktop
|
||
|
||
Le versioni pronte per macOS, Windows e Linux sono disponibili nella [pagina delle versioni](https://github.com/open-pencil/open-pencil/releases/latest).
|
||
|
||
| 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
|
||
|
||
```sh
|
||
brew install --cask openpencil
|
||
```
|
||
|
||
Il comando installa l’app firmata per Mac con Apple Silicon o processore Intel dal [catalogo ufficiale Homebrew](https://formulae.brew.sh/cask/openpencil). Gli aggiornamenti vengono verificati da Homebrew e possono arrivare dopo le versioni su GitHub. Nel frattempo, usa il [download diretto](https://github.com/open-pencil/open-pencil/releases/latest). La CLI si installa separatamente: `npm install -g @open-pencil/cli`.
|
||
|
||
Se usavi il tap personalizzato archiviato, migra con:
|
||
|
||
```sh
|
||
brew uninstall open-pencil/tap/open-pencil
|
||
brew install --cask openpencil
|
||
```
|
||
|
||
## Compilazione dal codice sorgente
|
||
|
||
### Requisiti
|
||
|
||
- [Bun](https://bun.sh/) come runtime e package manager;
|
||
- [Rust](https://rustup.rs/) soltanto per l'applicazione Tauri.
|
||
|
||
### Installazione
|
||
|
||
```sh
|
||
git clone https://github.com/open-pencil/open-pencil.git
|
||
cd open-pencil
|
||
bun install
|
||
```
|
||
|
||
### Server di sviluppo
|
||
|
||
```sh
|
||
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
|
||
|
||
```sh
|
||
xcode-select --install
|
||
cargo install tauri-cli --version "^2"
|
||
bun run tauri dev
|
||
```
|
||
|
||
### Windows
|
||
|
||
1. Installa [Rust](https://rustup.rs/) con il toolchain `stable-msvc`:
|
||
```sh
|
||
rustup default stable-msvc
|
||
```
|
||
2. Installa [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-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:
|
||
```sh
|
||
bun run tauri dev
|
||
```
|
||
|
||
### Linux
|
||
|
||
In Debian o Ubuntu, installa le dipendenze di sistema:
|
||
|
||
```sh
|
||
sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
|
||
libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev
|
||
```
|
||
|
||
Quindi esegui:
|
||
|
||
```sh
|
||
bun run tauri dev
|
||
```
|
||
|
||
### Generare un pacchetto di installazione
|
||
|
||
```sh
|
||
bun run tauri build # Piattaforma corrente
|
||
bun run tauri build --target universal-apple-darwin # Universal Binary per macOS
|
||
```
|