Add instructions for running the runtime tests on iOS platforms (#86045)
authorMilos Kotlar <kotlarmilos@gmail.com>
Wed, 10 May 2023 15:21:43 +0000 (17:21 +0200)
committerGitHub <noreply@github.com>
Wed, 10 May 2023 15:21:43 +0000 (17:21 +0200)
docs/workflow/testing/libraries/testing-apple.md

index 2911e16..09e08d1 100644 (file)
@@ -89,6 +89,18 @@ A functional test can be run the same way as any library test suite, e.g.:
 
 Currently functional tests are expected to return `42` as a success code so please be careful when adding a new one.
 
+### Running the runtime tests
+
+Currently, only the `tracing/eventpipe` subset of runtime tests is enabled on iOS platforms.
+
+The subset of runtime tests can be built by executing the following shell script:
+```sh
+./build.sh -arch arm64 -os ios -s mono+libs -c Release
+./src/tests/build.sh os ios arm64 Release -mono tree tracing/eventpipe /p:LibrariesConfiguration=Release
+```
+
+The script generates an Apple bundle that can be executed using Xcode or XHarness.
+
 ### Viewing logs
 - see the logs generated by the XHarness tool
 - use the `Console` app on macOS: