diff options
author | jashook <jashoo@microsoft.com> | 2017-06-14 10:01:58 -0700 |
---|---|---|
committer | jashook <jashoo@microsoft.com> | 2017-06-14 10:21:11 -0700 |
commit | ba2acbdfe136cb5ab1b875368ed2768193d59b5e (patch) | |
tree | d35c1ccf85fcd7002018355c351c0cd59e7468f6 /Documentation | |
parent | b386a62a3b191d01723fa9a5c65fa4914dcb4854 (diff) | |
download | coreclr-ba2acbdfe136cb5ab1b875368ed2768193d59b5e.tar.gz coreclr-ba2acbdfe136cb5ab1b875368ed2768193d59b5e.tar.bz2 coreclr-ba2acbdfe136cb5ab1b875368ed2768193d59b5e.zip |
Add documentation for building test(s) on Unix
This also includes steps on how to build individual tests.
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/building/unix-test-instructions.md | 32 |
1 files changed, 30 insertions, 2 deletions
diff --git a/Documentation/building/unix-test-instructions.md b/Documentation/building/unix-test-instructions.md index 96546a0249..a6dd77afa7 100644 --- a/Documentation/building/unix-test-instructions.md +++ b/Documentation/building/unix-test-instructions.md @@ -6,12 +6,40 @@ CoreCLR tests **Building** -Build CoreCLR on [Windows](https://github.com/dotnet/coreclr/blob/master/Documentation/building/windows-instructions.md) & [Unix](https://github.com/dotnet/coreclr/blob/master/Documentation/building/linux-instructions.md), and CoreFX on [Unix](https://github.com/dotnet/corefx/blob/master/Documentation/building/unix-instructions.md). +Build CoreCLR on [Unix](https://github.com/dotnet/coreclr/blob/master/Documentation/building/linux-instructions.md), and CoreFX on [Unix](https://github.com/dotnet/corefx/blob/master/Documentation/building/unix-instructions.md). -To build only the tests, on the Windows machine: +**Building the Tests** + +To build the tests on Unix: + +> `./build-test.sh -rebuild` + +As of [#11860](https://github.com/dotnet/coreclr/pull/11860) building the tests on unix works; however, it will take significantly more time than building on Windows. + +To build on Windows: > `C:\coreclr>build-test.cmd -rebuild` +**Building Individual Tests** + +During development there are many instances where building an individual test is fast and necessary. All of the necessary tools to build are under coreclr/Tools. It is possible to use coreclr/Tools/MSBuild.dll as you would normally use MSBuild with a few caveats. + +Note that coreclr/Tools/msbuild.sh exists as well to make the call shorter. + +**!! Note !! -- Passing /p:__BuildOs=[OSX|Linux] is required.** + +>If you omit it you will get the following error: `error MSB4801: The task factory "CodeTaskFactory" could not be loaded because this version of MSBuild does not support it.` +--- + +**Building an Individual Test Example** + +>`coreclr/Tools/msbuild.sh /maxcpucount coreclr/tests/src/JIT/CodeGenBringUpTests/Array1.csproj /p:__BuildType=Release /p:__BuildOS=OSX` + +Or + +>`coreclr/Tools/dotnetcli/dotnet coreclr/Tools/MSBuild.dll /maxcpucount coreclr/tests/src/JIT/CodeGenBringUpTests/Array1.csproj /p:__BuildType=Release /p:__BuildOS=OSX` + + **Running tests** The following instructions assume that on the Unix machine: |