feat: improve build system and add release workflow

Build System Improvements:
- Separate build directories (build-debug/ vs build-release/)
- Fix LIVEKIT_VERSION default to 0.0.0
- Fix Ninja clean to avoid CMake reconfiguration
- Remove -j flag issue in build.cmd
CI/CD Workflows:
- Add Windows support with vcpkg in builds.yml
- Use build.sh/build.cmd scripts instead of raw cmake commands
- Add SDK bundle creation and artifact upload
- Add make-release.yml for automated GitHub releases
- Support tag-triggered releases (v* tags)
- Build for Linux x64, macOS arm64/x64, Windows x64
Documentation:
- Update README_BUILD.md with new build directory structure
- Add build-debug/ and build-release/ to .gitignore

Author: Sqhh99

.github/workflows/builds.yml

@@ -31,7 +31,7 @@ on:
 
 env:
   CARGO_TERM_COLOR: always
-  # vcpkg binary caching only needed for Windows
+  # vcpkg binary caching for Windows
   VCPKG_BINARY_SOURCES: "clear;x-gha,readwrite"
 
 jobs:
@@ -41,12 +41,19 @@ jobs:
       matrix:
         include:
           - os: ubuntu-latest
-            preset: linux-release-examples
+            name: linux-x64
+            build_cmd: ./build.sh release-examples
+            build_dir: build-release
           - os: macos-latest
-            preset: macos-release-examples
+            name: macos-arm64
+            build_cmd: ./build.sh release-examples
+            build_dir: build-release
           - os: windows-latest
-            preset: windows-release-examples
-    name: ${{ matrix.os }}
+            name: windows-x64
+            build_cmd: .\build.cmd release-examples
+            build_dir: build-release
+
+    name: Build (${{ matrix.name }})
     runs-on: ${{ matrix.os }}
 
     steps:
@@ -56,6 +63,7 @@ jobs:
           submodules: recursive
           fetch-depth: 0
 
+      # ---------- vcpkg caching for Windows ----------
       - name: Export GitHub Actions cache environment variables
         if: runner.os == 'Windows'
         uses: actions/github-script@v7
@@ -70,7 +78,8 @@ jobs:
         with:
           vcpkgGitCommitId: 'c82f74667287d3dc386bce81e44964370c91a289'
 
-      - name: Install system deps (Ubuntu)
+      # ---------- OS-specific deps ----------
+      - name: Install deps (Ubuntu)
         if: runner.os == 'Linux'
         run: |
           set -eux
@@ -85,18 +94,20 @@ jobs:
             libssl-dev \
             libprotobuf-dev protobuf-compiler \
             libabsl-dev \
-            libwayland-dev libdecor-0-dev  # For SDL3
+            libwayland-dev libdecor-0-dev
 
-      - name: Install system deps (macOS)
+      - name: Install deps (macOS)
         if: runner.os == 'macOS'
         run: |
           set -eux
           brew update
           brew install cmake ninja protobuf abseil
 
+      # ---------- Rust toolchain ----------
       - name: Install Rust (stable)
         uses: dtolnay/rust-toolchain@stable
 
+      # ---------- Cache Cargo ----------
       - name: Cache Cargo registry
         uses: actions/cache@v4
         with:
@@ -114,35 +125,42 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-cargo-target-
 
+      # ---------- Build environment setup ----------
       - name: Set Linux build environment
         if: runner.os == 'Linux'
         run: |
           echo "CXXFLAGS=-Wno-deprecated-declarations" >> $GITHUB_ENV
           echo "CFLAGS=-Wno-deprecated-declarations" >> $GITHUB_ENV
-          # Find libclang path
           LLVM_VERSION=$(llvm-config --version | cut -d. -f1)
           echo "LIBCLANG_PATH=/usr/lib/llvm-${LLVM_VERSION}/lib" >> $GITHUB_ENV
 
-      - name: Configure CMake
-        run: cmake --preset ${{ matrix.preset }}
+      # ---------- Build ----------
+      - name: Build (Unix)
+        if: runner.os != 'Windows'
+        shell: bash
+        run: |
+          chmod +x build.sh
+          ${{ matrix.build_cmd }}
 
-      - name: Build
-        run: cmake --build --preset ${{ matrix.preset }}
+      - name: Build (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: ${{ matrix.build_cmd }}
 
+      # ---------- Smoke test examples ----------
       - name: Smoke test examples (Unix)
         if: runner.os != 'Windows'
         shell: bash
         run: |
           set -x
           failed=false
           for exe in SimpleRoom SimpleRpc SimpleDataStream; do
-            exe_path="build/bin/${exe}"
+            exe_path="${{ matrix.build_dir }}/bin/${exe}"
             if [[ -x "${exe_path}" ]]; then
               echo "Testing ${exe}..."
-              # Capture output to verify program actually runs
               output=$("${exe_path}" --help 2>&1) || true
               if [[ -z "${output}" ]]; then
-                echo "ERROR: ${exe} produced no output - may have failed to start"
+                echo "ERROR: ${exe} produced no output"
                 failed=true
               else
                 echo "${output}"
@@ -163,11 +181,9 @@ jobs:
           $examples = @('SimpleRoom', 'SimpleRpc', 'SimpleDataStream')
           $failed = $false
           foreach ($exe in $examples) {
-            $exePath = "build/bin/Release/${exe}.exe"
+            $exePath = "${{ matrix.build_dir }}/bin/Release/${exe}.exe"
             if (Test-Path $exePath) {
               Write-Host "Testing ${exe}..."
-              # Capture output to verify program actually runs
-              # Use Start-Process to avoid PowerShell error handling issues
               $pinfo = New-Object System.Diagnostics.ProcessStartInfo
               $pinfo.FileName = $exePath
               $pinfo.Arguments = "--help"
@@ -182,7 +198,7 @@ jobs:
               $p.WaitForExit()
               $output = $stdout + $stderr
               if ([string]::IsNullOrWhiteSpace($output)) {
-                Write-Host "ERROR: ${exe} produced no output - may have failed to start"
+                Write-Host "ERROR: ${exe} produced no output"
                 $failed = $true
               } else {
                 Write-Host $output
@@ -195,22 +211,24 @@ jobs:
           }
           if ($failed) { exit 1 } else { exit 0 }
 
+      # ---------- Upload artifacts ----------
       - name: Upload build artifacts
         uses: actions/upload-artifact@v4
         with:
-          name: livekit-sdk-${{ matrix.os }}
+          name: livekit-sdk-${{ matrix.name }}
           path: |
-            build/lib/
-            build/include/
-            build/bin/
+            ${{ matrix.build_dir }}/lib/
+            ${{ matrix.build_dir }}/include/
+            ${{ matrix.build_dir }}/bin/
           retention-days: 7
 
+      # ---------- Cleanup ----------
       - name: Clean after build (best-effort)
         if: always()
         shell: bash
         run: |
           if [[ "$RUNNER_OS" == "Windows" ]]; then
-            rm -rf build || true
+            rm -rf build-release build-debug || true
           else
-            [[ -x build.sh ]] && ./build.sh clean || true
+            ./build.sh clean-all || true
           fi