You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/get-started/upgrade-to-aspire-9.md
+28-28Lines changed: 28 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,23 +1,23 @@
1
1
---
2
-
title: Upgrade to Aspire 9.5.0
3
-
description: Learn how to upgrade all your Aspire projects to Aspire 9.5.0.
2
+
title: Upgrade to Aspire 9.5.1
3
+
description: Learn how to upgrade all your Aspire projects to Aspire 9.5.1.
4
4
ms.date: 10/01/2025
5
5
zone_pivot_groups: dev-environment
6
6
---
7
7
8
-
# Upgrade to Aspire 9.5.0
8
+
# Upgrade to Aspire 9.5.1
9
9
10
-
In this article, you learn the steps involved in updating your existing Aspire projects to the latest version: Aspire 9.5.0. There are a few ways in which you can update your projects to Aspire 9.5.0:
10
+
In this article, you learn the steps involved in updating your existing Aspire projects to the latest version: Aspire 9.5.1. There are a few ways in which you can update your projects to Aspire 9.5.1:
11
11
12
-
- Manually upgrade your projects to Aspire 9.5.0.
13
-
- Use the **Upgrade Assistant** to upgrade your projects to Aspire 9.5.0.
12
+
- Manually upgrade your projects to Aspire 9.5.1.
13
+
- Use the **Upgrade Assistant** to upgrade your projects to Aspire 9.5.1.
14
14
15
15
> [!TIP]
16
16
> If you're new to Aspire, there's no reason to upgrade anything. For more information, see [Aspire setup and tooling](../fundamentals/setup-tooling.md).
17
17
18
18
## Prerequisites
19
19
20
-
Before you upgrade your projects to Aspire 9.5.0, ensure that you have the following prerequisites:
20
+
Before you upgrade your projects to Aspire 9.5.1, ensure that you have the following prerequisites:
21
21
22
22
-[Install the latest tooling](../fundamentals/setup-tooling.md).
23
23
-[Use the Aspire SDK](../fundamentals/dotnet-aspire-sdk.md).
@@ -34,22 +34,22 @@ dotnet new install Aspire.ProjectTemplates
34
34
> [!TIP]
35
35
> If you have the legacy Aspire workload installed, you need to pass the `--force` flag to overwrite the existing templates. For instructions on uninstalling the legacy workload, see [Remove the Aspire workload (first-time upgrades from version 8 only)](#remove-the-aspire-workload-first-time-upgrades-from-version-8-only).
36
36
37
-
## Manually upgrade a solution to Aspire 9.5.0
37
+
## Manually upgrade a solution to Aspire 9.5.1
38
38
39
-
To upgrade your projects to Aspire 9.5.0, you need to update your project files. The following steps guide you through the process:
39
+
To upgrade your projects to Aspire 9.5.1, you need to update your project files. The following steps guide you through the process:
40
40
41
-
- Edit your [AppHost](xref:dotnet/aspire/app-host) project file to use the new Aspire 9.5.0 SDK (`Aspire.AppHost.Sdk`).
41
+
- Edit your [AppHost](xref:dotnet/aspire/app-host) project file to use the new Aspire 9.5.1 SDK (`Aspire.AppHost.Sdk`).
42
42
- Update the NuGet packages in your project files to the latest versions.
43
43
- Adjust your _Program.cs_ file to use the new APIs and remove any obsolete APIs.
44
44
45
45
### Edit your AppHost project file
46
46
47
-
To upgrade your AppHost project to Aspire 9.5.0, you need to update your project file to use the new [📦 Aspire.AppHost.Sdk](https://www.nuget.org/packages/Aspire.AppHost.Sdk):
47
+
To upgrade your AppHost project to Aspire 9.5.1, you need to update your project file to use the new [📦 Aspire.AppHost.Sdk](https://www.nuget.org/packages/Aspire.AppHost.Sdk):
### Optionally upgrade the target framework moniker (TFM)
71
71
72
-
Aspire 9.5.0 runs on .NET 9.0, but you can also run it on .NET 8.0. In other words, just because you're using the Aspire SDK, and pointing to version 9.5.0 packages, you can still target .NET 8.0. If you want to run your Aspire 9.5.0 project on .NET 9.0, you need to update the `TargetFramework` property in your project file:
72
+
Aspire 9.5.1 runs on .NET 9.0, but you can also run it on .NET 8.0. In other words, just because you're using the Aspire SDK, and pointing to version 9.5.1 packages, you can still target .NET 8.0. If you want to run your Aspire 9.5.1 project on .NET 9.0, you need to update the `TargetFramework` property in your project file:
73
73
74
74
```diff
75
75
<Project Sdk="Microsoft.NET.Sdk">
76
76
77
-
<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.0" />
77
+
<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.1" />
78
78
79
79
<PropertyGroup>
80
80
<OutputType>Exe</OutputType>
@@ -87,7 +87,7 @@ Aspire 9.5.0 runs on .NET 9.0, but you can also run it on .NET 8.0. In other wor
The changes include the addition of the `Aspire.AppHost.Sdk`, the update of the `TargetFramework` property to `net9.0`, and the update of the `Aspire.Hosting.AppHost` package to version `9.5.0`.
125
+
The changes include the addition of the `Aspire.AppHost.Sdk`, the update of the `TargetFramework` property to `net9.0`, and the update of the `Aspire.Hosting.AppHost` package to version `9.5.1`.
126
126
127
127
### Adjust your _Program.cs_ file
128
128
@@ -131,7 +131,7 @@ The changes include the addition of the `Aspire.AppHost.Sdk`, the update of the
131
131
132
132
With the introduction of Aspire 9.5, there are some _breaking changes_. Some APIs were originally marked as experimental (with the <xref:System.Diagnostics.CodeAnalysis.ExperimentalAttribute>) and are now removed, while other APIs are now attributed as <xref:System.ObsoleteAttribute> with details on new replacement APIs. You need to adjust your _Program.cs_ file (and potentially other affected APIs) to use the new APIs. If you're using the Upgrade Assistant to upgrade your projects, it automatically adjusts your _Program.cs_ file in most cases.
133
133
134
-
For the complete list of breaking changes in Aspire 9.5.0, see [Breaking changes in Aspire 9.5](../compatibility/9.5/index.md).
134
+
For the complete list of breaking changes in Aspire 9.5.1, see [Breaking changes in Aspire 9.5](../compatibility/9.5/index.md).
135
135
136
136
> [!IMPORTANT]
137
137
> Be sure to review breaking changes for all versions of Aspire after the one you're upgrading from. For example, if you're upgrading from Aspire 9.0, you must address breaking changes for versions [9.1](../compatibility/9.1/index.md), [9.2](../compatibility/9.2/index.md), [9.3](../compatibility/9.3/index.md), [9.4](../compatibility/9.4/index.md), and [9.5](../compatibility/9.5/index.md).
@@ -143,11 +143,11 @@ The [Upgrade Assistant](/dotnet/core/porting/upgrade-assistant-overview) is a to
143
143
-[The Visual Studio extension version](/dotnet/core/porting/upgrade-assistant-install#visual-studio-extension).
144
144
-[The .NET CLI global tool version](/dotnet/core/porting/upgrade-assistant-install#net-global-tool).
145
145
146
-
Regardless of how you install the Upgrade Assistant, you can use it to upgrade your Aspire projects to Aspire 9.5.0.
146
+
Regardless of how you install the Upgrade Assistant, you can use it to upgrade your Aspire projects to Aspire 9.5.1.
147
147
148
148
:::zone pivot="visual-studio"
149
149
150
-
To upgrade the Aspire AppHost project to Aspire 9.5.0 with Visual Studio, right-click the project in **Solution Explorer** and select **Upgrade**.
150
+
To upgrade the Aspire AppHost project to Aspire 9.5.1 with Visual Studio, right-click the project in **Solution Explorer** and select **Upgrade**.
151
151
152
152
> [!IMPORTANT]
153
153
> If the **Upgrade Assistant** isn't already installed, you'll be prompted to install it.
When a package reference already exists, the `dotnet add package` command updates the reference to the specified version. For more information, see [dotnet add package](/dotnet/core/tools/dotnet-add-package).
@@ -252,7 +252,7 @@ With the AppHost project updated, your project file should look like this:
252
252
```diff
253
253
<Project Sdk="Microsoft.NET.Sdk">
254
254
255
-
<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.0" />
255
+
<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.1" />
256
256
257
257
<PropertyGroup>
258
258
<OutputType>Exe</OutputType>
@@ -265,7 +265,7 @@ With the AppHost project updated, your project file should look like this:
@@ -276,7 +276,7 @@ With the AppHost project updated, your project file should look like this:
276
276
277
277
## Remove the Aspire workload (first-time upgrades from version 8 only)
278
278
279
-
If you're upgrading from Aspire 8 to Aspire 9 for the first time, you need to remove the legacy workload. This step is not needed for upgrades between Aspire 9 versions (such as from 9.4.0 to 9.5.0).
279
+
If you're upgrading from Aspire 8 to Aspire 9 for the first time, you need to remove the legacy workload. This step is not needed for upgrades between Aspire 9 versions (such as from 9.4.0 to 9.5.1).
280
280
281
281
Previously the **aspire workload** was required to create and run Aspire projects. But, with Aspire 9 the workload is no longer required and should be removed from your .NET environment.
Copy file name to clipboardExpand all lines: docs/whats-new/dotnet-aspire-9.5.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,10 +37,10 @@ Moving between minor releases of Aspire is simple:
37
37
iex "& { $(irm https://aspire.dev/install.ps1) }"
38
38
```
39
39
40
-
1. In your AppHost project file (that is, _MyApp.AppHost.csproj_), update the [📦 Aspire.AppHost.Sdk](https://www.nuget.org/packages/Aspire.AppHost.Sdk) package to version `9.5.0`:
40
+
1. In your AppHost project file (that is, _MyApp.AppHost.csproj_), update the [📦 Aspire.AppHost.Sdk](https://www.nuget.org/packages/Aspire.AppHost.Sdk) package to version `9.5.1`:
41
41
42
42
```xml
43
-
<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.0" />
43
+
<Sdk Name="Aspire.AppHost.Sdk" Version="9.5.1" />
44
44
```
45
45
46
46
For more information, see [Aspire SDK](xref:dotnet/aspire/sdk).
@@ -114,7 +114,7 @@ For more information, see [aspire config set command](../cli-reference/aspire-co
114
114
You can use `aspire new` to create a new, blank file-based AppHost. Select the _Single-file AppHost (experimental)_ option from the project template list:
0 commit comments