Skip to content

testing-and-conformance.md

Latest commit

 

History

History
82 lines (56 loc) · 2.35 KB

testing-and-conformance.md

File metadata and controls

82 lines (56 loc) · 2.35 KB
Raw

Testing And Conformance

Scope

This document covers the runtime test suite, Home support tests, and the optional OpenXR-CTS lane.

Runtime Tests

Build and run host-native runtime checks with:

cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Debug
cmake --build build
ctest --test-dir build --output-on-failure

The default test layers are:

  • oxrsys_runtime_tests
  • oxrsys_runtime_status_tests
  • oxrsys_runtime_api_tests

oxrsys_runtime_api_tests is Apple-only in this pass because it exercises the loader-backed Metal path. Linux builds still run the runtime, config, input, protocol, and status tests.

Home Tests

The macOS Home has a small Swift test runner for bundle inspection, launcher persistence merging, server config serialization, preference persistence, and Terminal command quoting:

swiftc -parse-as-library \
  "clients/Apple/oxrsys-home/OXRSys Home/HomeSupport.swift" \
  "clients/Apple/oxrsys-home/OXRSys Home/OXRSysServerConfig.swift" \
  "clients/Apple/oxrsys-home/OXRSys Home/HomeLauncher.swift" \
  "clients/Apple/oxrsys-home/OXRSys Home/HomePreferences.swift" \
  tests/HomeLauncherTests.swift \
  -o /tmp/oxrsys_home_launcher_tests && /tmp/oxrsys_home_launcher_tests

The Qt Home core tests are part of the top-level CTest run when OXRSYS_BUILD_QT_FRONTENDS is enabled and Qt6 is available.

CTS Lane

Enable and run the optional OpenXR-CTS lane with:

cmake -B build_cts -G Ninja -DCMAKE_BUILD_TYPE=Debug -DOXRSYS_ENABLE_CTS=ON
cmake --build build_cts --target openxr_cts_run

Reports:

  • build_cts/reports/openxr-cts/baseline.txt
  • build_cts/reports/openxr-cts/automated_metal.xml

Current Baseline

As of March 17, 2026, the pinned non-interactive baseline is:

  • 63 passed
  • 36 skipped
  • 0 failed

Merge Expectations

Before considering a change ready:

  • run the macOS build and tests
  • run the Linux/Qt build on a Linux host when touching Linux runtime or Qt frontend code
  • run the Home Swift test runner when changing the Home launcher, preferences, or server config helpers
  • run the Android build if Android code changed
  • run the CTS lane when runtime API, extension behavior, swapchain handling, action handling, or conformance-sensitive behavior changed

Documentation Updates

Update this file when:

  • test commands change
  • test targets change
  • CTS reports move
  • the tracked CTS baseline changes