Add workflow with customParameters in it about unity-test-runner

[timcassell]

customParameters are extra parameters for Unity's test runner which this project doesn't explicitly support (see test runner docs for the arguments that you can use as customParameters).

This project currently doesn't support target platform tests, as they do not work in Docker. For obvious reasons, Android tests will never be able to work in Docker unless you could somehow hook up an Android emulator. If you are using a self-hosted runner instead of github-hosted runner, you may be able to get Android or any other target platform tests to work, but not with this repo as it currently is.

I made a fork of this repo where I tried to get target platform tests to work, but was unable to simply because they do not work in Docker. If you are using a self-hosted runner, you could try using my fork (on the targetPlatform branch) to see if it will work for you. Just pass testMode: Android.

P.S. The default target is not Standalone, it is actually both EditMode and PlayMode (which run in editor).

[webbertakken]

Yes, but also keep in mind that our actions use a docker image under the hood.

The images have a package installed for the targetPlatform.

You can specify targetPlatform in builder, but not in test-runner. Though what you can do is use a specific image using customImage.

All of these parameters are also documented in builder, and we're open to contributions that would bring builder features to test-runner. Also long term we're looking to consolidate the core of these actions into one repository.

[dginovker]

Super handy info and links. Test runner docs linked as a note to the customParameters info in the gameci documentation would probably have saved me that time 👍

Out of curiosity - I can't run the Android platform tests, but can I set the Editor to Android before running them?

Many thanks!

[timcassell]

Super handy info and links. Test runner docs linked as a note to the customParameters info in the gameci documentation would probably have saved me that time +1

I agree. Perhaps you could make a PR with that change?

Out of curiosity - I can't run the Android platform tests, but can I set the Editor to Android before running them?

game-ci will use whatever configuration your project is already set to. If you need to change the build target during your CI, I think you can pass -buildTarget Android as a customParameters (see https://docs.unity3d.com/Manual/EditorCommandLineArguments.html). That's an editor argument, so I'm not 100% if it also works with the test runner, but if it doesn't, you can also manually edit the project settings file before running the tests.

[timcassell]

Ah yeah, I forgot about that part. That's a pretty niche use-case, but I do see the value in it.

Unity is currently working on official Docker support, and I'm really hoping target platform tests will just work once they finally do, then it would be nice to support it fully in game-ci.

Also see for more information: https://forum.unity.com/threads/unity-test-framework-2-0-ready-for-feedback.1230126/#post-7896961