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
6.6 KiB
Markdown
131 lines
6.6 KiB
Markdown
# Начало работы
|
||
|
||
## Веб-версия
|
||
|
||
OpenPencil работает прямо в браузере и не требует установки. Чтобы начать работу, откройте [app.openpencil.dev](https://app.openpencil.dev).
|
||
|
||
Если вы хотите создать на основе OpenPencil собственный продукт, а не только пользоваться готовым приложением, перейдите в раздел [Программирование и автоматизация](/programmable/) или прочитайте документацию [Vue SDK](/programmable/sdk/).
|
||
|
||
## Приложение для компьютера
|
||
|
||
Готовые версии для macOS, Windows и Linux опубликованы на [странице релизов](https://github.com/open-pencil/open-pencil/releases/latest).
|
||
|
||
| Платформа | Файл |
|
||
| --------------------- | -------------------- |
|
||
| macOS (Apple Silicon) | `.dmg` (aarch64) |
|
||
| macOS (Intel) | `.dmg` (x64) |
|
||
| Windows (x64) | `.msi` / `.exe` |
|
||
| Windows (ARM) | `.msi` / `.exe` |
|
||
| Linux (x64) | `.AppImage` / `.deb` |
|
||
|
||
## Системные требования
|
||
|
||
OpenPencil отрисовывает графику через CanvasKit на WebGL и использует современные возможности веб-платформы, поэтому нужен свежий движок браузера. Веб-версия работает в Chrome 111, Edge 111, Firefox 128 и Safari 16.4 или новее; браузеры на основе Chromium, например Brave и Opera, ориентируются на версию своего Chrome. Приложение для компьютера отрисовывает интерфейс в системном WebView, поэтому нижняя граница определяется движком операционной системы:
|
||
|
||
| Платформа | Требование |
|
||
| --------- | ---------- |
|
||
| macOS | macOS 13 Ventura или новее с актуальными обновлениями Safari (Safari 16.4 вышел вместе с macOS 13.3). |
|
||
| Windows | Windows 10 или новее со средой Microsoft Edge WebView2 Evergreen, которая обновляется сама. |
|
||
| Linux | WebKitGTK 2.40 или новее (`webkit2gtk-4.1`). |
|
||
|
||
Если движок слишком старый, OpenPencil вместо пустого окна показывает, что нужно обновить. Если вы видите такое уведомление в системе, которая подходит под требования, воспользуйтесь ссылкой «Report a problem»: в ней уже указаны сведения о браузере и движке.
|
||
|
||
## Установка в macOS через Homebrew
|
||
|
||
```sh
|
||
brew install --cask openpencil
|
||
```
|
||
|
||
Команда устанавливает подписанное приложение для Mac с Apple Silicon или Intel из [официального каталога Homebrew](https://formulae.brew.sh/cask/openpencil). Обновления проходят проверку в Homebrew и могут появляться позже релизов на GitHub. До обновления каталога используйте [прямую загрузку](https://github.com/open-pencil/open-pencil/releases/latest). CLI устанавливается отдельно: `npm install -g @open-pencil/cli`.
|
||
|
||
Если вы использовали архивный собственный tap, перейдите так:
|
||
|
||
```sh
|
||
brew uninstall open-pencil/tap/open-pencil
|
||
brew install --cask openpencil
|
||
```
|
||
|
||
## Сборка из исходного кода
|
||
|
||
### Что потребуется
|
||
|
||
- [Bun](https://bun.sh/) — среда выполнения и менеджер пакетов;
|
||
- [Rust](https://rustup.rs/) — только для приложения Tauri.
|
||
|
||
### Установка
|
||
|
||
```sh
|
||
git clone https://github.com/open-pencil/open-pencil.git
|
||
cd open-pencil
|
||
bun install
|
||
```
|
||
|
||
### Сервер для разработки
|
||
|
||
```sh
|
||
bun run dev
|
||
```
|
||
|
||
Редактор будет доступен по адресу `http://localhost:1420`.
|
||
|
||
### Команды
|
||
|
||
| Команда | Назначение |
|
||
| ------------------------------- | -------------------------------------------------------------------- |
|
||
| `bun run dev` | Запустить сервер разработки с HMR |
|
||
| `bun run build` | Собрать версию для публикации |
|
||
| `bun run check` | Запустить oxlint и проверку типов с помощью tsgo |
|
||
| `bun run test` | Запустить сквозные тесты и сравнение внешнего вида в Playwright |
|
||
| `bun run test:update` | Обновить эталонные снимки экрана |
|
||
| `bun run test:unit` | Запустить модульные тесты с помощью bun:test |
|
||
| `bun run docs:dev` | Запустить сервер разработки документации |
|
||
| `bun run docs:build` | Быстро собрать документацию для локальной проверки |
|
||
| `bun run docs:build:production` | Полностью собрать документацию для публикации, включая файлы для LLM |
|
||
|
||
## Приложение Tauri
|
||
|
||
Для сборки приложения Tauri нужны Rust и системные компоненты выбранной платформы.
|
||
|
||
### macOS
|
||
|
||
```sh
|
||
xcode-select --install
|
||
cargo install tauri-cli --version "^2"
|
||
bun run tauri dev
|
||
```
|
||
|
||
### Windows
|
||
|
||
1. Установите [Rust](https://rustup.rs/) с toolchain `stable-msvc`:
|
||
```sh
|
||
rustup default stable-msvc
|
||
```
|
||
2. Установите [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) и выберите workload **Desktop development with C++**.
|
||
3. WebView2 уже входит в Windows 10 версии 1803 и новее, а также в Windows 11.
|
||
4. Выполните:
|
||
```sh
|
||
bun run tauri dev
|
||
```
|
||
|
||
### Linux
|
||
|
||
В Debian или Ubuntu установите системные зависимости:
|
||
|
||
```sh
|
||
sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
|
||
libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev
|
||
```
|
||
|
||
Затем выполните:
|
||
|
||
```sh
|
||
bun run tauri dev
|
||
```
|
||
|
||
### Сборка установочного пакета
|
||
|
||
```sh
|
||
bun run tauri build # Текущая платформа
|
||
bun run tauri build --target universal-apple-darwin # Universal binary для macOS
|
||
```
|