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/extensibility/snippets/MailDevResourceAndComponent/MailDevResource.AppHost/MailDevResource.AppHost.csproj
Copy file name to clipboardexpand all lines: docs/extensibility/snippets/MailDevResourceWithCredentials/MailDevResource.AppHost/MailDevResource.AppHost.csproj
Copy file name to clipboardexpand all lines: docs/fundamentals/app-host-overview.md
+2-3
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: .NET Aspire orchestration overview
3
3
description: Learn the fundamental concepts of .NET Aspire orchestration and explore the various APIs for adding resources and expressing dependencies.
4
-
ms.date: 03/14/2025
4
+
ms.date: 03/19/2025
5
5
ms.topic: overview
6
6
uid: dotnet/aspire/app-host
7
7
---
@@ -40,7 +40,7 @@ builder.Build().Run();
40
40
41
41
## App host project
42
42
43
-
The app host project handles running all of the projects that are part of the .NET Aspire project. In other words, it's responsible for orchestrating all apps within the app model. The project itself is a .NET executable project that references the [📦 Aspire.Hosting.AppHost](https://www.nuget.org/packages/Aspire.Hosting.AppHost) NuGet package, sets the `IsAspireHost` property to `true`, and references the [.NET Aspire SDK](dotnet-aspire-sdk.md):
43
+
The app host project handles running all of the projects that are part of the .NET Aspire project. In other words, it's responsible for orchestrating all apps within the app model. The project itself is a .NET executable project that references the [📦 Aspire.Hosting.AppHost](https://www.nuget.org/packages/Aspire.Hosting.AppHost) NuGet package, and uses the [.NET Aspire SDK](dotnet-aspire-sdk.md):
44
44
45
45
```xml
46
46
<ProjectSdk="Microsoft.NET.Sdk">
@@ -50,7 +50,6 @@ The app host project handles running all of the projects that are part of the .N
Copy file name to clipboardexpand all lines: docs/fundamentals/dashboard/snippets/BrowserTelemetry/BrowserTelemetry.AppHost/BrowserTelemetry.AppHost.csproj
Copy file name to clipboardexpand all lines: docs/fundamentals/dotnet-aspire-sdk.md
+6-5
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,13 @@
1
1
---
2
2
title: .NET Aspire SDK
3
3
description: Learn
4
-
ms.date: 02/25/2025
4
+
ms.date: 03/19/2025
5
5
uid: dotnet/aspire/sdk
6
6
---
7
7
8
8
# .NET Aspire SDK
9
9
10
-
The .NET Aspire SDK is intended for [_*.AppHost_ projects](app-host-overview.md#app-host-project), which serve as the .NET Aspire orchestrator. These projects are designated using the `<IsAspireHost>true</IsAspireHost>` property, as well as specifying the `Aspire.AppHost.Sdk` in the project file. The SDK provides a set of features that simplify the development of .NET Aspire apps.
10
+
The .NET Aspire SDK is intended for [_*.AppHost_ projects](app-host-overview.md#app-host-project), which serve as the .NET Aspire orchestrator. These projects are designated by their usage of the `Aspire.AppHost.Sdk` in the project file. The SDK provides a set of features that simplify the development of .NET Aspire apps.
11
11
12
12
## Overview
13
13
@@ -21,7 +21,6 @@ The [📦 Aspire.AppHost.Sdk](https://www.nuget.org/packages/Aspire.AppHost.Sdk)
21
21
<PropertyGroup>
22
22
<OutputType>Exe</OutputType>
23
23
<TargetFramework>net9.0</TargetFramework>
24
-
<IsAspireHost>true</IsAspireHost>
25
24
<!-- Omitted for brevity -->
26
25
</PropertyGroup>
27
26
@@ -33,7 +32,7 @@ The [📦 Aspire.AppHost.Sdk](https://www.nuget.org/packages/Aspire.AppHost.Sdk)
33
32
</Project>
34
33
```
35
34
36
-
The preceding example project defines the top-level SDK as `Microsoft.NET.Sdk` and the `Aspire.AppHost.Sdk` as an additive SDK. The `IsAspireHost` property is set to `true` to indicate that this project is an .NET Aspire app host. The project also references the `Aspire.Hosting.AppHost` package which brings in a number of Aspire-related dependencies.
35
+
The preceding example project defines the top-level SDK as `Microsoft.NET.Sdk` and the `Aspire.AppHost.Sdk` as an additive SDK. The project also references the `Aspire.Hosting.AppHost` package which brings in a number of Aspire-related dependencies.
37
36
38
37
## SDK Features
39
38
@@ -44,11 +43,13 @@ The .NET Aspire SDK provides several key features.
44
43
Each `ProjectReference` in the [.NET Aspire app host][app-host] project isn't treated as standard project references. Instead, they enable the _app host_ to execute these projects as part of its orchestration. Each project reference triggers a generator to create a `class` that represents the project as an <xref:Aspire.Hosting.IProjectMetadata>. This metadata is used to populate the named projects in the generated `Projects` namespace. When you call the <xref:Aspire.Hosting.ProjectResourceBuilderExtensions.AddProject*?displayProperty=fullName> API, the `Projects` namespace is used to reference the project—passing the generated class as a generic-type parameter.
45
44
46
45
> [!TIP]
47
-
> If you need to reference a project in the tranditional way within the app host, set the `IsAspireProjectResource` attribute on the `ProjectReference` element to `false`, as shown in the following example:
46
+
> If you need to reference a project in the traditional way within the app host, set the `IsAspireProjectResource` attribute on the `ProjectReference` element to `false`, as shown in the following example:
0 commit comments