Skip to content

Update and create documentation in build.cmd and build.sh for CoreCLR test builds #126951

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
davidwrighton merged 5 commits into from
May 8, 2026
Merged

Update and create documentation in build.cmd and build.sh for CoreCLR test builds #126951

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
d1f6aa1
Update documentation in build.cmd and build.sh for OS targeting and c…
Copilot Apr 15, 2026
e4e40f5
Merge branch 'main' into copilot/update-documentation-scripts
davidwrighton Apr 16, 2026
c25f0c1
Update src/tests/build.sh
davidwrighton Apr 16, 2026
90e3510
Update src/tests/build.sh
davidwrighton Apr 17, 2026
1a27e67
Update src/tests/build.cmd
davidwrighton May 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion src/tests/build.cmd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -355,9 +355,15 @@ echo All arguments are optional and case-insensitive, and the '-' prefix is opti
echo.
echo.-? -h --help: View this message.
echo.
echo Build architecture: one of "x64", "x86", "arm64" ^(default: x64^).
echo Build architecture: one of "x64", "x86", "arm64", "wasm" ^(default: x64^).
echo Build type: one of "Debug", "Checked", "Release" ^(default: Debug^).
echo.
echo Build target OS options:
echo os ^<value^>: Set the target OS. Common values: windows ^(default^), linux, osx, android,
echo ios, iossimulator, tvos, tvossimulator, maccatalyst, browser, wasi.
echo browser: Shorthand for "os browser" ^(typically combine with "wasm", for example "wasm browser"^).
echo wasi: Shorthand for "os wasi" ^(typically combine with "wasm", for example "wasm wasi"^).
echo.
echo -Rebuild: Clean up all test artifacts prior to building tests.
echo -SkipRestorePackages: Skip package restore.
echo -SkipManaged: Skip the managed tests build.
Expand All @@ -374,6 +380,7 @@ echo -NativeAOT: Builds the tests for Native AOT compilation.
echo -Perfmap: Emit perfmap symbol files when compiling the framework assemblies using Crossgen2.
echo -AllTargets: Build managed tests for all target platforms (including test projects in which CLRTestTargetUnsupported resolves to true).
echo -ExcludeMonoFailures, Mono: Build the tests for the Mono runtime honoring mono-specific issues.
echo -CoreCLR: Build tests targeting the CoreCLR runtime (default; opposite of -Mono/-ExcludeMonoFailures).
echo.
echo Set to "" to disable default exclusion file.
echo -Priority ^<N^> : specify a set of tests that will be built and run, with priority N.
Expand Down
13 changes: 10 additions & 3 deletions src/tests/build.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -136,6 +136,12 @@ build_Tests()
usage_list=()
usage_list+=("All arguments are optional and the '-' prefix is optional. The options are:")
usage_list+=("")
usage_list+=("Build target OS: Use '-os <value>' (handled by the common build framework) to specify the")
usage_list+=(" target OS. Common values: linux (default on Linux), osx (default on macOS), android,")
usage_list+=(" ios, iossimulator, tvos, tvossimulator, maccatalyst, browser, wasi.")
usage_list+=(" For mobile/device targets (android, ios, iossimulator, tvos, tvossimulator), this script")
usage_list+=(" automatically skips building native test components.")
usage_list+=("")
usage_list+=("-rebuild - Clean up all test artifacts prior to building tests.")
usage_list+=("-skiprestorepackages - Skip package restore.")
usage_list+=("-skipmanaged - Skip the managed tests build.")
Expand All @@ -154,12 +160,13 @@ usage_list+=("-allTargets - Build managed tests for all target platforms (includ
usage_list+=("")
usage_list+=("-runtests - Run tests after building them.")
usage_list+=("-mono, -excludemonofailures - Build the tests for the Mono runtime honoring mono-specific issues.")
usage_list+=("-coreclr - Build tests targeting the CoreCLR runtime (default; opposite of -mono/-excludemonofailures).")
usage_list+=("-mono_aot - Use Mono AOT mode.")
usage_list+=("-mono_fullaot - Use Mono Full AOT mode.")
usage_list+=("")
usage_list+=("-test:xxx - Only build the specified test project ^(relative or absolute project path under src\tests^).");
usage_list+=("-dir:xxx - Build all test projects in the given directory ^(relative or absolute directory under src\tests^).");
usage_list+=("-tree:xxx - Build all test projects in the given subtree ^(relative or absolute directory under src\tests^).");
usage_list+=("-test:xxx - Only build the specified test project (relative or absolute project path under src/tests).")
usage_list+=("-dir:xxx - Build all test projects in the given directory (relative or absolute directory under src/tests).")
usage_list+=("-tree:xxx - Build all test projects in the given subtree (relative or absolute directory under src/tests).")
usage_list+=("-log:xxx - Base file name to use for log files (used in lab pipelines that build tests in multiple steps to retain logs for each step).")
usage_list+=("")
usage_list+=("Any unrecognized arguments will be passed directly to MSBuild.")
Expand Down
Loading