doc: document building of SDL tests with CMake #7097
This file contains 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: Build (MSVC) | |
| on: [push, pull_request] | |
| concurrency: | |
| group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.run_id }} | |
| cancel-in-progress: true | |
| jobs: | |
| Build: | |
| name: ${{ matrix.platform.name }} | |
| runs-on: windows-latest | |
| strategy: | |
| fail-fast: false | |
| matrix: | |
| platform: | |
| - { name: Windows (x64), flags: -A x64, project: VisualC/SDL.sln, projectflags: '/p:Platform=x64', artifact: 'SDL-VC-x64' } | |
| - { name: Windows (x86), flags: -A Win32, project: VisualC/SDL.sln, projectflags: '/p:Platform=Win32', artifact: 'SDL-VC-x86' } | |
| - { name: Windows static VCRT (x64), flags: -A x64 -DSDL_FORCE_STATIC_VCRT=ON, artifact: 'SDL-VC-static-VCRT-x64' } | |
| - { name: Windows static VCRT (x86), flags: -A Win32 -DSDL_FORCE_STATIC_VCRT=ON, artifact: 'SDL-VC-static-VCRT-x86' } | |
| - { name: Windows (clang-cl x64), flags: -T ClangCL -A x64, artifact: 'SDL-clang-cl-x64' } | |
| - { name: Windows (clang-cl x86), flags: -T ClangCL -A Win32, artifact: 'SDL-clang-cl-x86' } | |
| - { name: Windows (ARM), flags: -A ARM, artifact: 'SDL-VC-arm32' } | |
| - { name: Windows (ARM64), flags: -A ARM64, artifact: 'SDL-VC-arm64' } | |
| - { name: UWP (x64), flags: -A x64 -DCMAKE_SYSTEM_NAME=WindowsStore -DCMAKE_SYSTEM_VERSION="10.0" -DSDL_TESTS=OFF, nowerror: true, | |
| project: VisualC-WinRT/SDL-UWP.sln, projectflags: '/p:Platform=x64 /p:WindowsTargetPlatformVersion=10.0.17763.0', artifact: 'SDL-VC-UWP' } | |
| steps: | |
| - uses: actions/checkout@v3 | |
| - name: Create CMake project using SDL as a subproject | |
| shell: python | |
| run: | | |
| import os | |
| import textwrap | |
| srcdir = r"${{ github.workspace }}".replace("\\", "/") | |
| builddir = f"{ srcdir }/build" | |
| os.makedirs(builddir) | |
| with open(f"{ builddir }/CMakeLists.txt", "w") as f: | |
| f.write(textwrap.dedent(f"""\ | |
| cmake_minimum_required(VERSION 3.0) | |
| project(sdl_user) | |
| add_subdirectory("{ srcdir }" SDL) | |
| """)) | |
| - name: Configure (CMake) | |
| run: cmake -S build -B build ` | |
| -Wdeprecated -Wdev -Werror ` | |
| -DSDL_WERROR=${{ !matrix.platform.nowerror }} ` | |
| -DSDL_SHARED=ON ` | |
| -DSDL_STATIC=ON ` | |
| -DSDL_TESTS=ON ` | |
| -DSDL_INSTALL_TESTS=ON ` | |
| -DSDL_VENDOR_INFO="Github Workflow" ` | |
| -DSDL_DISABLE_INSTALL=OFF ` | |
| -DSDL_DISABLE_INSTALL_CPACK=OFF ` | |
| ${{ matrix.platform.flags }} ` | |
| -DCMAKE_INSTALL_PREFIX=prefix | |
| - name: Build (CMake) | |
| run: cmake --build build/ --config Release --parallel | |
| - name: Run build-time tests | |
| if: "! contains(matrix.platform.name, 'ARM')" | |
| run: | | |
| $env:SDL_TESTS_QUICK=1 | |
| ctest -VV --test-dir build/ -C Release | |
| - name: Install (CMake) | |
| run: | | |
| echo "SDL3_DIR=$Env:GITHUB_WORKSPACE/prefix" >> $Env:GITHUB_ENV | |
| cmake --install build/ | |
| - name: Package (CPack) | |
| run: | | |
| cmake --build build/ --config Release --target PACKAGE | |
| - name: Verify CMake configuration files | |
| if: ${{ !contains(matrix.platform.name, 'UWP') }} # FIXME: cmake/test/CMakeLists.txt should support UWP | |
| run: | | |
| cmake -S cmake/test -B cmake_config_build ` | |
| -DCMAKE_PREFIX_PATH=${{ env.SDL3_DIR }} ` | |
| ${{ matrix.platform.flags }} | |
| cmake --build cmake_config_build --config Release | |
| - name: Add msbuild to PATH | |
| if: ${{ matrix.platform.project != '' }} | |
| uses: microsoft/[email protected] | |
| - name: Build msbuild | |
| if: ${{ matrix.platform.project != '' }} | |
| run: msbuild ${{ matrix.platform.project }} /m /p:BuildInParallel=true /p:Configuration=Release ${{ matrix.platform.projectflags }} | |
| - uses: actions/upload-artifact@v3 | |
| with: | |
| if-no-files-found: error | |
| name: ${{ matrix.platform.artifact }} | |
| path: build/dist/SDL3* |