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

6.1 KiB
Raw Blame History

Окружение разработчика

Задача #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):
      $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):
      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)

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):

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:

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 — — —