Move all examples to cpp-example-collection #332
Workflow file for this run
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Builds | |
| on: | |
| push: | |
| branches: ["main"] | |
| paths: | |
| - src/** | |
| - include/** | |
| - cpp-example-collection/** | |
| - bridge/** | |
| - client-sdk-rust/** | |
| - CMakeLists.txt | |
| - build.sh | |
| - build.cmd | |
| - vcpkg.json | |
| - CMakePresets.json | |
| - docker/Dockerfile | |
| - .github/workflows/** | |
| pull_request: | |
| branches: ["main"] | |
| paths: | |
| - src/** | |
| - include/** | |
| - cpp-example-collection/** | |
| - bridge/** | |
| - client-sdk-rust/** | |
| - CMakeLists.txt | |
| - build.sh | |
| - build.cmd | |
| - vcpkg.json | |
| - CMakePresets.json | |
| - docker/Dockerfile | |
| - .github/workflows/** | |
| workflow_dispatch: | |
| permissions: | |
| contents: read | |
| env: | |
| CARGO_TERM_COLOR: always | |
| # vcpkg binary caching for Windows | |
| VCPKG_DEFAULT_TRIPLET: x64-windows-static-md | |
| VCPKG_DEFAULT_HOST_TRIPLET: x64-windows-static-md | |
| VCPKG_TARGET_TRIPLET: x64-windows-static-md | |
| jobs: | |
| build: | |
| strategy: | |
| fail-fast: false | |
| matrix: | |
| include: | |
| - os: ubuntu-latest | |
| name: linux-x64 | |
| build_cmd: ./build.sh release-examples | |
| build_dir: build-release | |
| - os: ubuntu-24.04-arm | |
| name: linux-arm64 | |
| build_cmd: ./build.sh release-examples | |
| build_dir: build-release | |
| - os: macos-latest | |
| name: macos-arm64 | |
| build_cmd: ./build.sh release-examples | |
| build_dir: build-release | |
| - os: macos-latest | |
| name: macos-x64 | |
| build_cmd: ./build.sh release-examples --macos-arch x86_64 | |
| build_dir: build-release | |
| - os: windows-latest | |
| name: windows-x64 | |
| build_cmd: .\build.cmd release-examples | |
| build_dir: build-release | |
| name: Build (${{ matrix.name }}) | |
| runs-on: ${{ matrix.os }} | |
| steps: | |
| - name: Checkout (with submodules) | |
| uses: actions/checkout@v4 | |
| with: | |
| 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 | |
| with: | |
| script: | | |
| core.exportVariable('ACTIONS_CACHE_URL', process.env.ACTIONS_CACHE_URL || ''); | |
| core.exportVariable('ACTIONS_RUNTIME_TOKEN', process.env.ACTIONS_RUNTIME_TOKEN || ''); | |
| - name: Setup vcpkg (Windows only) | |
| if: runner.os == 'Windows' | |
| uses: lukka/run-vcpkg@v11 | |
| with: | |
| vcpkgGitCommitId: 'fb87e2bb3fe69e16c224989acb5a61349166c782' | |
| # ---------- OS-specific deps ---------- | |
| - name: Install deps (Ubuntu) | |
| if: runner.os == 'Linux' | |
| run: | | |
| set -eux | |
| sudo apt-get update | |
| sudo apt-get install -y \ | |
| build-essential cmake ninja-build pkg-config \ | |
| llvm-dev libclang-dev clang \ | |
| libva-dev libdrm-dev libgbm-dev libx11-dev libgl1-mesa-dev \ | |
| libxext-dev libxcomposite-dev libxdamage-dev libxfixes-dev \ | |
| libxrandr-dev libxi-dev libxkbcommon-dev \ | |
| libasound2-dev libpulse-dev \ | |
| libssl-dev \ | |
| libprotobuf-dev protobuf-compiler \ | |
| libabsl-dev \ | |
| libwayland-dev libdecor-0-dev \ | |
| libspdlog-dev | |
| - name: Install deps (macOS) | |
| if: runner.os == 'macOS' | |
| run: | | |
| set -eux | |
| brew update | |
| brew install cmake ninja protobuf abseil spdlog | |
| # ---------- Rust toolchain ---------- | |
| - name: Install Rust (stable) | |
| uses: dtolnay/rust-toolchain@stable | |
| - name: Install Rust cross-compilation target | |
| if: matrix.name == 'macos-x64' | |
| run: rustup target add x86_64-apple-darwin | |
| # ---------- Cache Cargo ---------- | |
| - name: Cache Cargo registry | |
| uses: actions/cache@v4 | |
| with: | |
| path: | | |
| ~/.cargo/registry | |
| ~/.cargo/git | |
| key: ${{ runner.os }}-${{ matrix.name }}-cargo-reg-${{ hashFiles('**/Cargo.lock') }} | |
| restore-keys: ${{ runner.os }}-${{ matrix.name }}-cargo-reg- | |
| - name: Cache Cargo target | |
| uses: actions/cache@v4 | |
| with: | |
| path: client-sdk-rust/target | |
| key: ${{ runner.os }}-${{ matrix.name }}-cargo-target-${{ hashFiles('**/Cargo.lock') }} | |
| restore-keys: | | |
| ${{ runner.os }}-${{ matrix.name }}-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 | |
| LLVM_VERSION=$(llvm-config --version | cut -d. -f1) | |
| echo "LIBCLANG_PATH=/usr/lib/llvm-${LLVM_VERSION}/lib" >> $GITHUB_ENV | |
| # ---------- Build ---------- | |
| - name: Build (Unix) | |
| if: runner.os != 'Windows' | |
| shell: bash | |
| run: | | |
| chmod +x build.sh | |
| ${{ matrix.build_cmd }} | |
| - name: Build (Windows) | |
| if: runner.os == 'Windows' | |
| shell: pwsh | |
| run: ${{ matrix.build_cmd }} | |
| # ---------- Smoke test cpp-example-collection binaries ---------- | |
| # Built under cpp-example-collection-build/ (not build-dir/bin). Visual Studio | |
| # multi-config places executables in per-target Release/ (or Debug/) subdirs. | |
| - name: Smoke test examples (Unix) | |
| if: runner.os != 'Windows' | |
| shell: bash | |
| run: | | |
| set -x | |
| failed=false | |
| examples_base="${{ matrix.build_dir }}/cpp-example-collection-build" | |
| resolve_exe() { | |
| local dir="$1" name="$2" | |
| local p="${examples_base}/${dir}/${name}" | |
| if [[ -x "${p}" ]]; then | |
| printf '%s' "${p}" | |
| return 0 | |
| fi | |
| p="${examples_base}/${dir}/Release/${name}" | |
| if [[ -x "${p}" ]]; then | |
| printf '%s' "${p}" | |
| return 0 | |
| fi | |
| return 1 | |
| } | |
| for pair in "SimpleRoom:simple_room" "SimpleRpc:simple_rpc" "SimpleDataStream:simple_data_stream"; do | |
| exe="${pair%%:*}" | |
| dir="${pair#*:}" | |
| if ! exe_path="$(resolve_exe "${dir}" "${exe}")"; then | |
| echo "ERROR: ${exe} not found under ${examples_base}/${dir}/" | |
| failed=true | |
| continue | |
| fi | |
| echo "Testing ${exe}..." | |
| output=$("${exe_path}" --help 2>&1) || true | |
| if [[ -z "${output}" ]]; then | |
| echo "ERROR: ${exe} produced no output" | |
| failed=true | |
| else | |
| echo "${output}" | |
| echo "${exe} ran successfully" | |
| fi | |
| done | |
| if [[ "$failed" == "true" ]]; then exit 1; fi | |
| - name: Smoke test examples (Windows) | |
| if: runner.os == 'Windows' | |
| shell: pwsh | |
| run: | | |
| $ErrorActionPreference = 'Continue' | |
| $examplesBase = "${{ matrix.build_dir }}/cpp-example-collection-build" | |
| $examples = @( | |
| @{ Name = 'SimpleRoom'; Dir = 'simple_room' }, | |
| @{ Name = 'SimpleRpc'; Dir = 'simple_rpc' }, | |
| @{ Name = 'SimpleDataStream'; Dir = 'simple_data_stream' } | |
| ) | |
| $failed = $false | |
| foreach ($ex in $examples) { | |
| $name = $ex.Name | |
| $dir = $ex.Dir | |
| $inDir = Join-Path $examplesBase $dir | |
| $candidates = @( | |
| (Join-Path $inDir "$name.exe"), | |
| (Join-Path (Join-Path $inDir 'Release') "$name.exe") | |
| ) | |
| $exePath = $null | |
| foreach ($p in $candidates) { | |
| if (Test-Path -LiteralPath $p) { | |
| $exePath = $p | |
| break | |
| } | |
| } | |
| if ($null -ne $exePath) { | |
| Write-Host "Testing ${name}..." | |
| $pinfo = New-Object System.Diagnostics.ProcessStartInfo | |
| $pinfo.FileName = $exePath | |
| $pinfo.Arguments = "--help" | |
| $pinfo.RedirectStandardOutput = $true | |
| $pinfo.RedirectStandardError = $true | |
| $pinfo.UseShellExecute = $false | |
| $p = New-Object System.Diagnostics.Process | |
| $p.StartInfo = $pinfo | |
| $p.Start() | Out-Null | |
| $stdout = $p.StandardOutput.ReadToEnd() | |
| $stderr = $p.StandardError.ReadToEnd() | |
| $p.WaitForExit() | |
| $output = $stdout + $stderr | |
| if ([string]::IsNullOrWhiteSpace($output)) { | |
| Write-Host "ERROR: ${name} produced no output" | |
| $failed = $true | |
| } else { | |
| Write-Host $output | |
| Write-Host "${name} ran successfully" | |
| } | |
| } else { | |
| Write-Host "ERROR: ${name} not found under ${examplesBase}/${dir}/" | |
| $failed = $true | |
| } | |
| } | |
| if ($failed) { exit 1 } else { exit 0 } | |
| # ---------- Upload artifacts ---------- | |
| - name: Upload build artifacts | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: livekit-sdk-${{ matrix.name }} | |
| path: | | |
| ${{ 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-release build-debug || true | |
| else | |
| ./build.sh clean-all || true | |
| fi | |
| docker-build-x64: | |
| name: Build (docker-linux-x64) | |
| runs-on: ubuntu-latest | |
| steps: | |
| - name: Checkout (with submodules) | |
| uses: actions/checkout@v4 | |
| with: | |
| submodules: recursive | |
| fetch-depth: 0 | |
| # Default ubuntu-latest images are tight on disk; this Dockerfile builds GCC | |
| # from source plus Rust — BuildKit export/import needs several extra GB. | |
| - name: Free disk space | |
| uses: jlumbroso/free-disk-space@v1.3.1 | |
| with: | |
| tool-cache: false | |
| android: true | |
| dotnet: true | |
| haskell: true | |
| large-packages: true | |
| swap-storage: true | |
| - name: Set up Docker Buildx | |
| uses: docker/setup-buildx-action@v3 | |
| - name: Build Docker image | |
| run: | | |
| docker buildx build \ | |
| --platform linux/amd64 \ | |
| --load \ | |
| -t livekit-cpp-sdk-x64:${{ github.sha }} \ | |
| . \ | |
| -f docker/Dockerfile | |
| - name: Verify installed SDK inside image | |
| run: | | |
| docker run --rm livekit-cpp-sdk-x64:${{ github.sha }} bash -c \ | |
| 'test -f /opt/livekit-sdk/lib/cmake/LiveKit/LiveKitConfig.cmake' | |
| - name: Save Docker image artifact | |
| run: | | |
| docker save livekit-cpp-sdk-x64:${{ github.sha }} | gzip > livekit-cpp-sdk-x64-docker.tar.gz | |
| - name: Upload Docker image artifact | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: livekit-cpp-sdk-docker-x64 | |
| path: livekit-cpp-sdk-x64-docker.tar.gz | |
| retention-days: 7 | |
| docker-build-linux-arm64: | |
| name: Build (docker-linux-arm64) | |
| runs-on: ubuntu-24.04-arm | |
| steps: | |
| - name: Checkout (with submodules) | |
| uses: actions/checkout@v4 | |
| with: | |
| submodules: recursive | |
| fetch-depth: 0 | |
| - name: Free disk space | |
| uses: jlumbroso/free-disk-space@v1.3.1 | |
| with: | |
| tool-cache: false | |
| android: true | |
| dotnet: true | |
| haskell: true | |
| large-packages: true | |
| swap-storage: true | |
| - name: Set up Docker Buildx | |
| uses: docker/setup-buildx-action@v3 | |
| - name: Build Docker image | |
| run: | | |
| docker buildx build \ | |
| --platform linux/arm64 \ | |
| --load \ | |
| -t livekit-cpp-sdk:${{ github.sha }} \ | |
| . \ | |
| -f docker/Dockerfile | |
| - name: Verify installed SDK inside image | |
| run: | | |
| docker run --rm livekit-cpp-sdk:${{ github.sha }} bash -c \ | |
| 'test -f /opt/livekit-sdk/lib/cmake/LiveKit/LiveKitConfig.cmake' | |
| - name: Save Docker image artifact | |
| run: | | |
| docker save livekit-cpp-sdk:${{ github.sha }} | gzip > livekit-cpp-sdk-arm64-docker.tar.gz | |
| - name: Upload Docker image artifact | |
| uses: actions/upload-artifact@v4 | |
| with: | |
| name: livekit-cpp-sdk-docker-arm64 | |
| path: livekit-cpp-sdk-arm64-docker.tar.gz | |
| retention-days: 7 | |
| build-collections-linux-arm64: | |
| name: Build (cpp-example-collection-linux-arm64) | |
| runs-on: ubuntu-24.04-arm | |
| needs: docker-build-linux-arm64 | |
| steps: | |
| - name: Download Docker image artifact | |
| uses: actions/download-artifact@v4 | |
| with: | |
| name: livekit-cpp-sdk-docker-arm64 | |
| - name: Load Docker image | |
| run: gzip -dc livekit-cpp-sdk-arm64-docker.tar.gz | docker load | |
| - name: Build cpp-example-collection against installed SDK | |
| run: | | |
| docker run --rm livekit-cpp-sdk:${{ github.sha }} bash -lc ' | |
| set -euxo pipefail | |
| git clone https://github.com/livekit-examples/cpp-example-collection.git /tmp/cpp-example-collection | |
| cd /tmp/cpp-example-collection | |
| git checkout sderosa/examples-migration | |
| cmake -S . -B build -DLIVEKIT_LOCAL_SDK_DIR=/opt/livekit-sdk | |
| cmake --build build --parallel | |
| ' | |
| build-collections-x64: | |
| name: Build (cpp-example-collection-x64) | |
| runs-on: ubuntu-latest | |
| needs: docker-build-x64 | |
| steps: | |
| - name: Download Docker image artifact | |
| uses: actions/download-artifact@v4 | |
| with: | |
| name: livekit-cpp-sdk-docker-x64 | |
| - name: Load Docker image | |
| run: gzip -dc livekit-cpp-sdk-x64-docker.tar.gz | docker load | |
| - name: Build cpp-example-collection against installed SDK | |
| run: | | |
| docker run --rm livekit-cpp-sdk-x64:${{ github.sha }} bash -lc ' | |
| set -euxo pipefail | |
| git clone https://github.com/livekit-examples/cpp-example-collection.git /tmp/cpp-example-collection | |
| cd /tmp/cpp-example-collection | |
| git checkout sderosa/examples-migration | |
| cmake -S . -B build -DLIVEKIT_LOCAL_SDK_DIR=/opt/livekit-sdk | |
| cmake --build build --parallel | |
| ' |