Skip to content

Clarify global.json version support #49941

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

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Clarify global.json version support #49941

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
c929716
Clarify global.json version support and update SDK availability notes
meaghanlewis Nov 17, 2025
d0741c6
update wording
meaghanlewis Nov 17, 2025
ddb088b
Update docs/core/tools/global-json.md
meaghanlewis Nov 18, 2025
dae8769
Clarify global.json version support
meaghanlewis Nov 18, 2025
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
19 changes: 16 additions & 3 deletions docs/core/tools/global-json.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,9 @@ The version of the .NET SDK to use.

This field:

- Doesn't have wildcard support; that is, you must specify the full version number.
- Requires the full version number, such as 9.0.100.
- Doesn't support version numbers like 9, 9.0, or 9.0.x.
- Doesn't have wildcard support.
- Doesn't support version ranges.

#### `allowPrerelease`
Expand Down Expand Up @@ -90,7 +92,7 @@ The following table shows the possible values for the `rollForward` key:
#### `paths`

- Type: Array of `string`
- Available since: .NET 10 Preview 3 SDK.
- Available since: .NET 10 SDK.

Specifies the locations that should be considered when searching for a compatible .NET SDK. Paths can be absolute or relative to the location of the *global.json* file. The special value `$host$` represents the location corresponding to the running `dotnet` executable.

Expand All @@ -103,7 +105,7 @@ This feature enables using local SDK installations (such as SDKs relative to a r
#### `errorMessage`

- Type: `string`
- Available since: .NET 10 Preview 3 SDK.
- Available since: .NET 10 SDK.

Specifies a custom error message displayed when the SDK resolver can't find a compatible .NET SDK.

Expand Down Expand Up @@ -209,6 +211,17 @@ The following example shows how to specify additional SDK search paths and a cus
}
```

The following example shows an invalid version specified. The output of the command `dotnet --info` shows the error message: "Version '10.0' is not valid for the 'sdk/version' value."

```json
{
"sdk": {
"version": "10.0",
"rollForward": "latestFeature"
}
}
```

The following example shows how to specify `Microsoft.Testing.Platform` as the test runner:

```json
Expand Down