Skip to content
Speedwave

Windows development environment

Speedwave development on Windows executes natively using Git Bash alongside MSVC compilation toolchains. Once initialized, the standard make workflow operates identically to macOS and Linux development environments.

Toolchain configuration

Section titled “Toolchain configuration”

  1. Install prerequisites via Chocolatey from an elevated PowerShell terminal:

    Terminal window
    choco install -y git make rustup.install nodejs-lts cmake llvm `
                      visualstudio2022buildtools visualstudio2022-workload-vctools `
                      bats-core

    Note: Ensure GNU Make 4.4+ is installed. Legacy GnuWin32 Make 3.81 fails to parse multiline recipe expansions.

  2. Pin the MSVC linker path in .cargo/config.toml (gitignored in repository root) pointing to Visual Studio’s link.exe. This prevents Git Bash from mistakenly executing Cygwin/MSYS2 link utilities, which trigger LNK1146 and LNK1206 errors.

  3. Export the Visual C++ environment by sourcing MSVC toolchain paths within your ~/.bashrc file, ensuring cl.exe and dumpbin.exe precede standard /usr/bin utilities on PATH.

  4. Execute build targets inside an interactive Git Bash session:

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

For testing instructions on Windows, refer to the Testing and validation guide.