Skip to content

Update default dotnet version to be 10.0 #6282

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
MuyuanMS merged 2 commits into from
Mar 12, 2026
Merged

Update default dotnet version to be 10.0 #6282

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
909b789
Update default dotnet version to be 10.0
MuyuanMS Mar 10, 2026
8e9d1b0
Update vstemplate to be dotnet 10 as well
MuyuanMS Mar 12, 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
6 changes: 3 additions & 3 deletions dev/VSIX/DotnetNewTemplates/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -60,11 +60,11 @@ dotnet new winui-window -n SecondaryWindow --project .\MyApp.csproj

### Choosing a Target Framework

All templates default to `net8.0-windows10.0.19041.0`. To target a different
All templates default to `net10.0-windows10.0.19041.0`. To target a different
.NET version, pass `--dotnet-version` when creating the project:

```shell
dotnet new winui --dotnet-version net10.0 -n MyApp
dotnet new winui --dotnet-version net8.0 -n MyApp
```

You can also edit the generated `.csproj` afterward and change
Expand All @@ -73,7 +73,7 @@ preferred TFM.

## Prerequisites

- [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0) or later
- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) or later
- Windows 10 version 1809 (build 17763) or later
- [Windows App SDK](https://learn.microsoft.com/windows/apps/windows-app-sdk/)
workload
Expand Down
4 changes: 2 additions & 2 deletions dev/VSIX/DotnetNewTemplates/templates/class-library/.template.config/template.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,10 @@
"type": "parameter",
"datatype": "choice",
"replaces": "$DotNetVersion$",
"defaultValue": "net8.0",
"defaultValue": "net10.0",
"description": "Base target framework moniker (TFM) for the WinUI project.",
"choices": [
{ "choice": "net8.0", "description": "Target .NET 8 (LTS)" },
{ "choice": "net8.0", "description": "Target .NET 8" },
{ "choice": "net9.0", "description": "Target .NET 9" },
{ "choice": "net10.0", "description": "Target .NET 10" }
]
Expand Down
2 changes: 1 addition & 1 deletion dev/VSIX/DotnetNewTemplates/templates/navigation-app/.template.config/template.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@
"type": "parameter",
"datatype": "text",
"replaces": "$DotNetVersion$",
"defaultValue": "net8.0"
"defaultValue": "net10.0"
},
"targetPlatformMinVersion": {
"type": "parameter",
Expand Down
4 changes: 2 additions & 2 deletions dev/VSIX/DotnetNewTemplates/templates/single-project/.template.config/template.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,10 @@
"type": "parameter",
"datatype": "choice",
"replaces": "$DotNetVersion$",
"defaultValue": "net8.0",
"defaultValue": "net10.0",
"description": "Base target framework moniker (TFM) for the WinUI project.",
"choices": [
{ "choice": "net8.0", "description": "Target .NET 8 (LTS)" },
{ "choice": "net8.0", "description": "Target .NET 8" },
{ "choice": "net9.0", "description": "Target .NET 9" },
{ "choice": "net10.0", "description": "Target .NET 10" }
]
Expand Down
6 changes: 3 additions & 3 deletions dev/VSIX/DotnetNewTemplates/templates/single-project/Agents.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,14 +12,14 @@ This is a **WinUI 3** desktop application built on the **Windows App SDK**. It u
|---|---|
| UI Framework | WinUI 3 (`Microsoft.UI.Xaml`) -- always used |
| App SDK | Read `Microsoft.WindowsAppSDK` version from `.csproj` `<PackageReference>` |
| Runtime / TFM | Read `<TargetFramework>` from `.csproj` (e.g., `net8.0-windows10.0.19041.0`) |
| Runtime / TFM | Read `<TargetFramework>` from `.csproj` (e.g., `net10.0-windows10.0.19041.0`) |
| Target OS | Derived from `<TargetFramework>` and `<TargetPlatformMinVersion>` in `.csproj` |
| Platforms | Read `<Platforms>` from `.csproj` (e.g., `x86;x64;ARM64`) |
| Packaging | MSIX (`<EnableMsixTooling>true</EnableMsixTooling>`) |
| Namespace | Read `<RootNamespace>` from `.csproj` |
| Nullable | Read `<Nullable>` from `.csproj` |

> **Default TFM:** Templates ship with `net8.0` by default. Pass
> **Default TFM:** Templates ship with `net10.0` by default. Pass
> `--dotnet-version <tfm>` (for example `net10.0`) when running `dotnet new ...`
> or edit `<TargetFramework>` inside the generated `.csproj` before the first
> build if you need a newer framework. Keep `<RuntimeIdentifiers>` synchronized
Expand Down Expand Up @@ -154,7 +154,7 @@ $Rid = $Platform.ToLower() # e.g. arm64, x64, x86
Add-AppxPackage -Register ".\<ProjectName>\bin\$Platform\Debug\<TargetFramework>\win-$Rid\AppxManifest.xml"
```

> **Note:** Replace `<TargetFramework>` with the actual value from `.csproj` (e.g., `net8.0-windows10.0.19041.0`).
> **Note:** Replace `<TargetFramework>` with the actual value from `.csproj` (e.g., `net10.0-windows10.0.19041.0`).

### Run from the CLI

Expand Down
2 changes: 1 addition & 1 deletion dev/VSIX/DotnetNewTemplates/templates/unit-test/.template.config/template.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@
"type": "parameter",
"datatype": "choice",
"replaces": "$DotNetVersion$",
"defaultValue": "net8.0",
"defaultValue": "net10.0",
"description": "Base target framework moniker (TFM) for the WinUI project.",
"choices": [
{ "choice": "net8.0", "description": "Target .NET 8 (LTS)" },
Expand Down
4 changes: 2 additions & 2 deletions dev/VSIX/Extension/Cs/Dev17/WindowsAppSDK.Cs.Extension.Dev17.csproj
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,8 +27,8 @@
<IsProductComponent Condition="'$(Deployment)' == 'Component'">true</IsProductComponent>
<!-- This MUST match VSPackage.PackageGuidString -->
<PackageGuidString>{B0F1BA01-DE66-4EF9-9C8B-DBB99FB4DA4B}</PackageGuidString>
<!-- Dev17 templates should target .NET 8 -->
<DotNetVersion>net8.0</DotNetVersion>
<!-- Dev17 templates should target .NET 10 -->
<DotNetVersion>net10.0</DotNetVersion>
</PropertyGroup>
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' " />
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' " />
Expand Down