Skip to content

Update Native AOT documentation#126483

Open
eduardo-vp wants to merge 2 commits intodotnet:mainfrom
eduardo-vp:naot-update-docs
Open

Update Native AOT documentation#126483
eduardo-vp wants to merge 2 commits intodotnet:mainfrom
eduardo-vp:naot-update-docs

Conversation

@eduardo-vp
Copy link
Copy Markdown
Member

Just adding that it's possible to filter the tests run by the script.

@dotnet-policy-service
Copy link
Copy Markdown
Contributor

Tagging subscribers to this area: @agocke, @dotnet/ilc-contrib
See info in area-owners.md if you want to be subscribed.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the CoreCLR NativeAOT workflow documentation to clarify how to run individual built tests and note that the per-test runner scripts support filtering which tests execute.

Changes:

  • Fixes the documented artifacts path for running an individual built test.
  • Adds documentation noting that some test projects bundle many tests into one executable and can be filtered via script arguments.


`$repo_root` is the root of your clone of the repo.

Some test projects (e.g., `Interop.csproj`) compile many test files into a single native executable. To run only specific tests (filter by namespace, class, method, etc.), pass a filter string to the `[.cmd|.sh]` script, e.g. `$TestName[.cmd|.sh] LayoutClass`.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this duplicated with coreclr/testing.md? Unless there's an extra native AOT step needed, I'd defer to testing.md. We already link to it below ("For more advanced scenarios"). We could reword that to "For more advanced scenarios involving building and running the tests".

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm kind of wondering if we should actually just fold the native AOT testing instructions in testing.md and just call out the extra argument whenever we need it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants