Konfiguracja na Windows

Prace deweloperskie nad projektem Speedwave w systemie Windows odbywają się natywnie za pośrednictwem powłoki Git Bash oraz narzędzi kompilacji MSVC. Po wstępnej konfiguracji zestaw celów make działa identycznie jak w systemie macOS.

Konfiguracja środowiska

1. W Git Bash uruchom jednorazową konfigurację. Wymaga ona uprawnień administratora i sama o nie poprosi:

   make setup-dev-windows

   Skrypt instaluje za pośrednictwem Chocolatey zestaw narzędzi (Git, GNU Make, rustup, Node.js, CMake, LLVM, Ninja, gitleaks oraz Visual Studio 2022 C++ Build Tools), a także określoną wersję Vulkan SDK wymaganą do kompilacji modułu transkrypcji Whisper. Włącza obsługę długich ścieżek w rejestrze i w systemowej konfiguracji Gita, zapisuje plik ~/msvc-env.sh ze środowiskiem MSVC i CMAKE_GENERATOR=Ninja oraz tworzy ignorowany przez Gita plik desktop/src-tauri/.cargo/config.toml ze skróconą ścieżką target-dir dla Cargo. Jeśli jakiegoś komponentu nie uda się zainstalować, skrypt nie przerywa pracy, lecz wyświetla listę brakujących elementów na końcu.

2. Otwórz nowe okno Git Bash, aby zaczęły obowiązywać zaktualizowany PATH i zmienne środowiskowe. Następnie zainstaluj zależności projektu i uruchom aplikację:

   cd ~/Projects/speedwave
   make setup-dev
   make dev

GNU Make 4.x musi znajdować się na początku zmiennej PATH: przestarzała wersja GnuWin32 Make 3.81 niepoprawnie interpretuje wielowierszowe rozwinięcia w regułach Makefile. Kompilacja transkrypcji z biblioteką Vulkan jest wrażliwa na długość ścieżek i pozostawia na katalog docelowy Cargo zaledwie dziewięć znaków. Z tego względu konfiguracja definiuje krótki target-dir. Możesz wskazać inne położenie, ustawiając własny skrócony target-dir albo zmienną środowiskową CARGO_TARGET_DIR.

Ogólne wymagania i cele pliku Makefile opisano na stronie Konfiguracja środowiska deweloperskiego. Szczegóły procedur testowych na platformie Windows znajdziesz w rozdziale Testowanie i weryfikacja.