Allow .NET 10 prerelease versions for single-file apphost scenarios by Copilot · Pull Request #11599 · dotnet/aspire

Copilot · 2025-09-23T07:46:05Z

Problem

When using the Aspire CLI with single-file apphosts (*.cs files), the SDK requirement is elevated from 9.0.302 to 10.0.100. However, since .NET 10.0.100 RTM has not been released yet, developers must manually configure overrideMinimumSdkVersion to use available .NET 10 prerelease versions, creating unnecessary friction.

Solution

This change modifies the SDK version checking logic to accept any .NET 10.x version (including prereleases) when the single-file apphost feature is enabled, while maintaining strict version checking for all other scenarios.

Technical Changes

Modified DotNetSdkInstaller.CheckAsync() to use a new MeetsMinimumRequirement() helper method
Added special handling for .NET 10 requirements that accepts any version with Major >= 10
Preserved existing behavior for all other version requirements using strict SemVersion.ComparePrecedence

Examples

Before this change:

SDK 10.0.100-rc.1.25420.111 detected
Requirement: 10.0.100
Result: ❌ FAIL (prerelease < RTM)

After this change:

SDK 10.0.100-rc.1.25420.111 detected  
Requirement: 10.0.100
Result: ✅ PASS (10.x prerelease accepted)

Testing

Added comprehensive unit tests verifying:

.NET 10 prereleases are accepted for single-file apphost requirements
.NET 9 versions are still rejected for single-file apphost requirements
Other version requirements continue using strict comparison
Multiple .NET 10 prerelease formats work correctly

Impact

This eliminates the need for developers to manually configure overrideMinimumSdkVersion when using .NET 10 prereleases with single-file apphosts, reducing friction while maintaining version safety for all other use cases.

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: mitchdenny <513398+mitchdenny@users.noreply.github.com>

github-actions · 2025-09-23T09:25:28Z

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/dotnet/aspire/main/eng/scripts/get-aspire-cli-pr.sh | bash -s -- 11599

Or

Run remotely in PowerShell:

iex "& { $(irm https://raw.githubusercontent.com/dotnet/aspire/main/eng/scripts/get-aspire-cli-pr.ps1) } 11599"

Copilot

Pull Request Overview

This PR modifies the .NET SDK version checking logic in the Aspire CLI to accept .NET 10 prerelease versions when using single-file apphost scenarios, eliminating the need for developers to manually configure overrideMinimumSdkVersion while maintaining strict version checking for other use cases.

Modified SDK version checking to use a new MeetsMinimumRequirement() helper method
Added special handling for .NET 10 requirements to accept any version with Major >= 10
Preserved existing strict version comparison behavior for all other scenarios

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
`src/Aspire.Cli/DotNet/DotNetSdkInstaller.cs`	Added new `MeetsMinimumRequirement()` method with special .NET 10 handling and updated existing logic to use it
`tests/Aspire.Cli.Tests/DotNetSdkInstallerTests.cs`	Added comprehensive unit tests to verify .NET 10 prerelease acceptance and preservation of strict comparison for other versions

Copilot · 2025-09-23T22:47:44Z

tests/Aspire.Cli.Tests/DotNetSdkInstallerTests.cs

+        var method = typeof(DotNetSdkInstaller).GetMethod("MeetsMinimumRequirement", 
+            System.Reflection.BindingFlags.NonPublic | System.Reflection.BindingFlags.Static);
+        var result = (bool)method!.Invoke(null, new object[] { installedVersion, requiredVersion, requiredVersionString })!;


The reflection code for accessing the private method is duplicated across multiple test methods. Consider extracting this into a private helper method to reduce duplication and improve maintainability.

Copilot · 2025-09-23T22:47:45Z

src/Aspire.Cli/DotNet/DotNetSdkInstaller.cs

+    private static bool MeetsMinimumRequirement(SemVersion installedVersion, SemVersion requiredVersion, string requiredVersionString)
+    {
+        // Special handling for .NET 10.0.100 requirement - allow any .NET 10.x version
+        if (requiredVersionString == MinimumSdkVersionSingleFileAppHost)
+        {
+            // If we require 10.0.100, accept any version that is >= 10.0.0


The method depends on a magic string comparison with MinimumSdkVersionSingleFileAppHost. Consider adding a parameter or using a more explicit approach to indicate when single-file apphost logic should be applied, making the intent clearer and reducing coupling to specific version strings.

Suggested change

private static bool MeetsMinimumRequirement(SemVersion installedVersion, SemVersion requiredVersion, string requiredVersionString)

{

// Special handling for .NET 10.0.100 requirement - allow any .NET 10.x version

if (requiredVersionString == MinimumSdkVersionSingleFileAppHost)

{

// If we require 10.0.100, accept any version that is >= 10.0.0

private static bool MeetsMinimumRequirement(SemVersion installedVersion, SemVersion requiredVersion, bool isSingleFileAppHostRequired)

{

// Special handling for .NET 10.x requirement - allow any .NET 10.x version

if (isSingleFileAppHostRequired)

{

// If single-file apphost is required, accept any version that is >= 10.0.0

mitchdenny · 2025-09-24T00:18:32Z

/backport to release/9.5

github-actions · 2025-09-24T00:18:40Z

Started backporting to release/9.5: https://github.com/dotnet/aspire/actions/runs/17962447808

Initial plan

4935a75

Copilot AI assigned Copilot and mitchdenny Sep 23, 2025

Copilot started work on behalf of mitchdenny September 23, 2025 07:46 View session

Implement .NET 10 prerelease support for single-file apphost

20da16f

Co-authored-by: mitchdenny <513398+mitchdenny@users.noreply.github.com>

Copilot AI requested a review from mitchdenny September 23, 2025 08:02

Copilot finished work on behalf of mitchdenny September 23, 2025 08:02

mitchdenny approved these changes Sep 23, 2025

View reviewed changes

mitchdenny marked this pull request as ready for review September 23, 2025 22:46

Copilot AI review requested due to automatic review settings September 23, 2025 22:46

Copilot AI reviewed Sep 23, 2025

View reviewed changes

mitchdenny requested review from davidfowl and maddymontaquila September 23, 2025 22:56

mitchdenny added the area-cli label Sep 23, 2025

mitchdenny added this to the 9.5 milestone Sep 23, 2025

maddymontaquila approved these changes Sep 23, 2025

View reviewed changes

mitchdenny merged commit a77692e into main Sep 24, 2025
311 checks passed

mitchdenny deleted the copilot/fix-f3dc53f3-cd48-4592-a593-135a8e66c4fa branch September 24, 2025 00:17

dotnet-policy-service bot modified the milestones: 9.5, 9.6 Sep 24, 2025

github-actions bot mentioned this pull request Sep 24, 2025

[release/9.5] Allow .NET 10 prerelease versions for single-file apphost scenarios #11616

Merged

github-actions bot locked and limited conversation to collaborators Oct 24, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Allow .NET 10 prerelease versions for single-file apphost scenarios#11599

Allow .NET 10 prerelease versions for single-file apphost scenarios#11599
mitchdenny merged 2 commits intomainfrom
copilot/fix-f3dc53f3-cd48-4592-a593-135a8e66c4fa

Copilot AI commented Sep 23, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Sep 23, 2025

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Sep 23, 2025

Uh oh!

Copilot AI Sep 23, 2025

Uh oh!

Uh oh!

mitchdenny commented Sep 24, 2025

Uh oh!

github-actions bot commented Sep 24, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

Copilot AI commented Sep 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Problem

Solution

Technical Changes

Examples

Testing

Impact

Uh oh!

github-actions bot commented Sep 23, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Copilot AI Sep 23, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Sep 23, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

mitchdenny commented Sep 24, 2025

Uh oh!

github-actions bot commented Sep 24, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Copilot AI commented Sep 23, 2025 •

edited

Loading