The purpose of this test suite is to provide automated and manual tests to verify XR SDK input providers. Both automated and manual tests are executed through Test Runner to enable continuous integration systems.

Branches are named based on new input provider interface versions. There is at most only one new interface version per dot release of unity (for example, 2019.2 and 2019.3 are different dot releases). New versions of Unity may or may not contain a changed interface version. Select the branch named for the most recent Unity version that does not exceed the version you wish to test.

• Import the target XR SDK package
• Configure ProjectSettings -> XR -> XR Manager to the target XR SDK Loader
• Adjust project build settings to target the appropriate build platform.
• If your platform needs extra time to warm up before it returns valid information, you can set a timer to compensate in Tools > Manual Certification Configuration

Tests are run through the Unity Test Runner. This enables the collection of pass/fail status and debug logs that can help point implementers toward items to fix.

• For any platform, you can run the tests on your target device by navigating from the Unity Editor menu bar to Window -> General -> Test Runner -> Playmode Tests -> Run All in Player
• For a PC-based XR platform, you can run individual playmode tests from the Test Runner Panel. If you have a specific test scene open, you can also run that test in editor playmode. If you run a test in editor playmode then pass/fail information and debug logs will not be captured through the Unity Test Runner.
• For continuous integration purposes, you can run tests through the Test Runner command line interface. For example: Unity.exe -runTests -projectPath PATH_TO_YOUR_PROJECT -testResults C:\temp\results.xml -testPlatform PS4. A complete list of command line arguments can be found in the Unity manual here.

• If your Input Provider runs on PC, you can navigate to Window -> General -> Test Runner -> Playmode Tests. Select a test or set of tests, right click on them, and Run.
• If running through command line interface, you can use the option with the option -testFilter "regexString". This allows you to filter by namespaces, class names, or test names.

• If your Input Provider runs on PC, you can open the scene you want to run and use editor playmode.
• Otherwise, refer to The section on running a subset of tests.

Manual test scenes are located in Packages\com.unity.xr.certinputmanual\Runtime\ManualTests. Each test scene has a corresponding TestFacilitator script located in Packages\com.unity.xr.certinputmanual\Runtime\ManualTests\_TestRunnerEntry which controls the flow of the manual test in that scene and captures test runner status.

• Navigate to Packages\com.unity.xr.certinputmanual\Runtime\ManualTests
• Copy an existing scene and rename it.
• Create a new TestFacilitator in Packages\com.unity.xr.certinputmanual\Runtime\ManualTests\_TestRunnerEntry. This can be a copy of an existing TestFacilitator renamed to reflect your new test name. The TestFacilitator script controls the flow of your test and ultimately reports status back to the Test Runner.
• In your new scene replace the existing TestFacilitator script, located on the "TestFacilitator" GameObject, with your new TestFacilitator script. Link the InstructionCanvas to this new Component.
• Edit the new scene and TestFacilitator script to match your desired functionality. Packages\com.unity.test-runner-manual-tests\Samples\Example\Tests\TestScripts contains examples of manual checkpoints and correct status reporting.
• Add your new scene to the build settings scene list
• Add your Test Runner test to Packages\com.unity.xr.certinputmanual\Runtime\InputManual.cs. Use the existing tests as a template.

• Automated input tests are in a separate package located at https://github.com/Unity-Technologies/com.unity.xr.certinputauto/
• This repository is pulled into xr.sdk.validation through the Packages/manifest.json file. In order to pull in a new test version, you may need to delete the "lock" set of attributes in this file.