72 lines
4.4 KiB
Markdown
72 lines
4.4 KiB
Markdown
# Окружение разработчика
|
||||
|
|
|
|||
|
|
Задача #1.3. Версии одинаковые у обоих разработчиков и в CI. Источник истины — `.mise.toml` и `rust-toolchain.toml`, этот документ объясняет выбор.
|
|||
|
|
|
|||
|
|
## Версии
|
|||
|
|
|
|||
|
|
Зафиксировано 2026-11-08.
|
|||
|
|
|
|||
|
|
| Инструмент | Версия | Где зафиксирована | Почему эта |
|
|||
|
|
|---|---|---|---|
|
|||
|
|
| Go | 1.27.3 | `.mise.toml` | Последний стабильный выпуск; Go поддерживает две последние версии, патчи безопасности выходят ежемесячно |
|
|||
|
|
| Node.js | 26.13.0 | `.mise.toml` | Active LTS «Lithium», поддержка до апреля 2029 — самая долгая из доступных |
|
|||
|
|
| pnpm | 12.17.0 | `.mise.toml` | Последняя мажорная, выпуску больше 7 дней |
|
|||
|
|
| Task | 3.54.0 | `.mise.toml` | Последний стабильный |
|
|||
|
|
| Rust | 1.99.1 | `rust-toolchain.toml` | Последний stable; `rustup` ставит его сам при первой сборке в папке проекта |
|
|||
|
|
| Tauri | 2.x (CLI 2.12.4) | `package.json` приложений (#2.14) | Стабильная ветка. Tauri 3 пока alpha — не используем |
|
|||
|
|
| mise | 2026.10.25 | вручную | Менеджер версий, ставит Go, Node, pnpm, Task по `.mise.toml` |
|
|||
|
|
| Docker | 29.x | вручную | Для `deploy/dev` (PostgreSQL, NATS, MinIO, Mailpit) |
|
|||
|
|
|
|||
|
|
Правила:
|
|||
|
|
- Обновление версии — отдельным PR `chore(ci): …` с правкой этой таблицы. Оба обновляются в тот же день.
|
|||
|
|
- Новые версии берём не раньше чем через 7 дней после выхода (кроме срочных исправлений безопасности).
|
|||
|
|
- Не используем alpha, beta, rc и версии Node без LTS (нечётные).
|
|||
|
|
- Версии фронтенд-библиотек (Vue, Vite, TypeScript, Tailwind, Reka UI) фиксируются в `pnpm-lock.yaml` в шаге 2 (#2.14).
|
|||
|
|
|
|||
|
|
## Установка на Windows
|
|||
|
|
|
|||
|
|
1. **Системные программы** (один раз):
|
|||
|
|
- Git, Docker Desktop (с WSL2);
|
|||
|
|
- Visual Studio 2022 Build Tools или Community с компонентом «Desktop development with C++»;
|
|||
|
|
- WebView2 Runtime (в Windows 11 уже есть);
|
|||
|
|
- Rust через `rustup` (https://rustup.rs).
|
|||
|
|
2. **mise**: скачать `mise-v<версия>-windows-x64.zip` из релизов `jdx/mise` на GitHub, сверить SHA256 с `SHASUMS256.txt`, распаковать `mise.exe` и `mise-shim.exe` в `%LOCALAPPDATA%\mise\bin`.
|
|||
|
|
3. **PATH пользователя**: добавить в начало `%LOCALAPPDATA%\mise\shims` и `%LOCALAPPDATA%\mise\bin`.
|
|||
|
|
4. **Подключить mise в терминалах** — иначе системные Node и Go, установленные в `C:\Program Files`, перекрывают версии проекта:
|
|||
|
|
- PowerShell (`$PROFILE`):
|
|||
|
|
```powershell
|
|||
|
|
$env:MISE_PWSH_CHPWD_WARNING = 0 # только для Windows PowerShell 5.1
|
|||
|
|
(& "$env:LOCALAPPDATA\mise\bin\mise.exe" activate pwsh) | Out-String | Invoke-Expression
|
|||
|
|
```
|
|||
|
|
- Git Bash (`~/.bashrc`):
|
|||
|
|
```bash
|
|||
|
|
eval "$("$LOCALAPPDATA/mise/bin/mise.exe" activate bash)"
|
|||
|
|
```
|
|||
|
|
5. **В папке проекта**:
|
|||
|
|
```
|
|||
|
|
mise trust
|
|||
|
|
mise install
|
|||
|
|
```
|
|||
|
|
6. **VS Code**: открыть проект и поставить рекомендуемые расширения (`.vscode/extensions.json`).
|
|||
|
|
7. **Перезапустить редактор и терминалы.**
|
|||
|
|
|
|||
|
|
## Установка на Linux (Astra 1.8 / Debian 12)
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
sudo apt install build-essential curl git libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev libssl-dev
|
|||
|
|
curl https://sh.rustup.rs -sSf | sh
|
|||
|
|
curl https://mise.run | sh # затем подключить: eval "$(~/.local/bin/mise activate bash)" в ~/.bashrc
|
|||
|
|
cd shtil && mise trust && mise install
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Проверка
|
|||
|
|
|
|||
|
|
В папке проекта (новый терминал):
|
|||
|
|
```
|
|||
|
|
node -v # v26.13.0
|
|||
|
|
pnpm -v # 12.17.0
|
|||
|
|
go version # go1.27.3
|
|||
|
|
task --version # 3.54.0
|
|||
|
|
rustc --version # 1.99.1
|
|||
|
|
```
|
|||
|
|
Итоговая проверка #1.3.9 — «hello world» Tauri и Go собираются под Windows и Linux у обоих.
|