builds.yml

name: Build examples against latest LiveKit SDK (via CMake)

on:
  push:
    branches: ["main"]
  pull_request:
    branches: ["main"]
  workflow_dispatch:

permissions:
  contents: read

env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

jobs:
  license-check:
    name: License Check
    uses: ./.github/workflows/license_check.yml
    permissions:
      contents: read

  pin-check:
    name: Pin Check
    uses: ./.github/workflows/pin_check.yml
    permissions:
      contents: read

  build:
    needs:
      - license-check
      - pin-check
    strategy:
      fail-fast: false
      matrix:
        include:
          - os: ubuntu-latest
            name: linux-x64
          - os: macos-latest
            name: macos-arm64
          - os: windows-latest
            name: windows-x64

    name: Build (${{ matrix.name }})
    runs-on: ${{ matrix.os }}
    permissions:
      contents: read

    steps:
      - name: Checkout
        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1

      # ---------- deps ----------
      - name: Install deps (Ubuntu)
        if: runner.os == 'Linux'
        shell: bash
        run: |
          set -eux
          sudo apt-get update
          sudo apt-get install -y \
            cmake ninja-build pkg-config \
            protobuf-compiler libprotobuf-dev \
            libasound2-dev libpulse-dev \
            libx11-dev libxext-dev libxrandr-dev libxcursor-dev libxfixes-dev \
            libxi-dev libxss-dev libxtst-dev libxkbcommon-dev \
            libdrm-dev libgbm-dev libgl1-mesa-dev libgles2-mesa-dev \
            libegl1-mesa-dev libdbus-1-dev libibus-1.0-dev libudev-dev \
            libpipewire-0.3-dev libwayland-dev libdecor-0-dev liburing-dev \
            libssl-dev \
            libspdlog-dev \
            curl

      - name: Install deps (macOS)
        if: runner.os == 'macOS'
        shell: bash
        run: |
          set -eux
          brew update
          brew install cmake ninja protobuf
          brew install spdlog

      - name: Install deps (Windows)
        if: runner.os == 'Windows'
        shell: pwsh
        run: |
          choco install -y cmake --installargs 'ADD_CMAKE_TO_PATH=System'
          choco install -y ninja

      - name: Setup MSVC (Windows)
        if: runner.os == 'Windows'
        uses: ilammy/msvc-dev-cmd@0b201ec74fa43914dc39ae48a89fd1d8cb592756 # v1.13.0
        with:
          arch: x64

      # ---------- configure + build ----------
      - name: Configure (Unix)
        if: runner.os != 'Windows'
        shell: bash
        env:
          GITHUB_TOKEN: ${{ github.token }}
        run: |
          set -eux
          cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release

      - name: Build (Unix)
        if: runner.os != 'Windows'
        shell: bash
        run: |
          set -eux
          cmake --build build --config Release

      - name: Configure (Windows)
        if: runner.os == 'Windows'
        shell: pwsh
        run: |
          cmake -S . -B build -G Ninja `
            -DCMAKE_BUILD_TYPE=Release `
            -DCMAKE_C_COMPILER=cl `
            -DCMAKE_CXX_COMPILER=cl

      - name: Build (Windows)
        if: runner.os == 'Windows'
        shell: pwsh
        run: |
          cmake --build build --config Release

      # ---------- smoke test ----------
      - name: Smoke test (Linux/macOS)
        if: runner.os != 'Windows'
        shell: bash
        run: |
          set -euo pipefail

          sdk_root="$(ls -d build/_deps/livekit-sdk/* | head -n 1)"
          echo "SDK root: ${sdk_root}"
          ls -la "${sdk_root}/lib" || true
          # Locate executable (it may not be directly under build/)
          exe="$(find build -type f -name basic_room -perm -111 | head -n 1)"
          if [[ -z "${exe}" ]]; then
            echo "basic_room executable not found under build/"
            find build -maxdepth 3 -type f -print
            exit 1
          fi
          echo "Running: ${exe} --self-test"
          if [[ "$RUNNER_OS" == "Linux" ]]; then
            export LD_LIBRARY_PATH="${sdk_root}/lib:${LD_LIBRARY_PATH:-}"
          else
            export DYLD_LIBRARY_PATH="${sdk_root}/lib:${DYLD_LIBRARY_PATH:-}"
          fi
          "${exe}" --self-test


      - name: Smoke test (Windows)
        if: runner.os == 'Windows'
        shell: pwsh
        run: |
          # Locate SDK root
          $sdkRoot = Get-ChildItem -Directory "build/_deps/livekit-sdk" | Select-Object -First 1
          if (-not $sdkRoot) {
          throw "SDK root not found under build/_deps/livekit-sdk"
          }
          Write-Host "SDK root: $($sdkRoot.FullName)"
          # Make sure DLLs are found at runtime
          $env:PATH = "$($sdkRoot.FullName)\bin;$($sdkRoot.FullName)\lib;$env:PATH"
          # Locate the built executable
          $exe = Get-ChildItem -Recurse build -Filter basic_room.exe | Select-Object -First 1
          if (-not $exe) {
            throw "basic_room.exe not found in build directory"
          }
          Write-Host "Running $($exe.FullName) --help"
          # Try to execute it. We only care that it launches.
          $out = & $exe.FullName --self-test 2>&1
          $code = $LASTEXITCODE
          if ($code -ne 0) {
            Write-Host $out
            throw "basic_room.exe --self-test failed with exit code $code"
          }
          Write-Host $out

      # ---------- upload build output ----------
      - name: Upload binary
        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
        with:
          name: basic_room-${{ matrix.name }}
          path: |
            build/basic_room*
            build/basic_room.exe
          retention-days: 7