Files
shtil/docs/environment.md
T
TMSHandDevin 0e5f36fa27 docs: записана проверка hello world Tauri и Go на Windows
Окружение подтверждено сборкой: Tauri 2 собирает exe и установщик NSIS, Go собирается под Windows и Linux. Инструкция для повторной проверки — в docs/environment.md.

Refs: 1.3.9

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-11-09 16:44:45 +03:00

104 lines
6.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Окружение разработчика
Задача #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` | Последний стабильный |
| lefthook | 2.2.2 | `.mise.toml` | Git-хуки: формат коммитов, gofmt, gitleaks (`lefthook.yml`) |
| gitleaks | 8.30.1 | `.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
lefthook 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 && lefthook 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
Делается в `tmp/` (папка в `.gitignore`), чтобы версии Node и Rust брались из настроек проекта. В git ничего не попадает.
**Tauri** (первая сборка 5–10 минут — компилируются зависимости Rust):
```bash
mkdir -p tmp && cd tmp
pnpm dlx create-tauri-app@4.7.5 hello-tauri --manager pnpm --template vue-ts --identifier ru.tbsoft.shtil.hello --yes
cd hello-tauri && pnpm install
pnpm tauri build --bundles nsis # Linux: --bundles deb
```
Готово, если собрался `src-tauri/target/release/hello-tauri(.exe)`, установщик в `src-tauri/target/release/bundle/` и приложение открывает окно.
**Go:**
```bash
mkdir -p tmp/hello-go && cd tmp/hello-go && go mod init hello
# main.go: package main; import "fmt"; func main() { fmt.Println("hello") }
go build -o hello.exe . # Windows
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o hello-linux . # Linux
```
**Результаты:**
| Кто | ОС | Tauri | Go | Дата |
|---|---|---|---|---|
| Frontend | Windows 11 | ✓ exe 4,2 МБ, установщик NSIS 1,4 МБ, окно открывается | ✓ windows/amd64, ✓ сборка linux/amd64 | 2026-11-08 |
| Frontend | Linux | — нужна машина #1.3.7 | запуск linux-бинарника — на машине #1.3.7 | — |
| Backend | Windows | — | — | — |
| Backend | Linux | — | — | — |