Aspire 设置和工具

Visual Studio 安装 Web 和云工作负载时，2022 17.9 或更高版本默认包含最新的 Aspire SDK 。

若要在 Aspire中安装 Visual Studio 模板，需要手动安装模板，除非使用的是 Visual Studio 17.12 或更高版本。 对于 Visual Studio 17.9 到 17.11，请执行以下步骤：

1. 打开 Visual Studio。
2. 转到 工具>NuGet 包管理器>包管理器控制台。
3. 运行以下命令以安装模板：

dotnet new install Aspire.ProjectTemplates

对于 Visual Studio 17.12 或更高版本，会自动安装 Aspire 模板。

若要安装这些模板，请使用 dotnet new install 命令，传入 Aspire.ProjectTemplates NuGet 标识符。

dotnet new install Aspire.ProjectTemplates

若要安装特定版本，请将版本号追加到包名称：

dotnet new install Aspire.ProjectTemplates::9.4.0

安装 Aspire 17.9 或更高版本时，会自动安装 Visual Studio 模板。 若要查看可用的Aspire模板，请选择“>>Visual Studio”，然后在搜索栏中搜索“”Aspire（Alt+S）。 可以看到可用 Aspire 项目模板的列表：

若要查看已安装 C# DevKit 的 Visual Studio Code 中的可用模板，请在 .NET 视图中未打开文件夹时，选择“创建 项目”按钮。

然后，在搜索栏中搜索“Aspire”以查看可用的 Aspire 项目模板：

若要验证 Aspire 是否已安装模板，请使用 dotnet new list 命令，传入 aspire 模板名称：

dotnet new list aspire

控制台输出应如下所示：

dotnet new list aspire
These templates matched your input: 'aspire'

Template Name                      Short Name              Language  Tags
---------------------------------  ----------------------  --------  -------------------------------------------------------
Aspire AppHost               aspire-apphost          [C#]      Common/Aspire/Cloud
Aspire Empty App              aspire                  [C#]      Common/Aspire/Cloud/Web/Web API/API/Service
Aspire Service Defaults       aspire-servicedefaults  [C#]      Common/Aspire/Cloud/Web/Web API/API/Service
Aspire Starter App            aspire-starter          [C#]      Common/Aspire/Blazor/Web/Web API/API/Service/Cloud
Aspire Test Project (MSTest)  aspire-mstest           [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test
Aspire Test Project (NUnit)   aspire-nunit            [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test
Aspire Test Project (xUnit)   aspire-xunit            [C#]      Common/Aspire/Cloud/Web/Web API/API/Service/Test

Visual Studio 模具

Visual Studio 提供额外功能，用于处理 Aspire 集成和 AppHost Orchestrator 项目。 并非所有这些功能目前在 Visual Studio Code 或通过 CLI 提供。

添加集成包

你可以使用 Aspire将 Visual Studio 集成添加到你的应用程序中，就像添加其他 NuGet 包一样。 但是，Visual Studio 还提供用于直接添加 Aspire 集成的 UI 选项。

1. 在 Visual Studio中，右键单击要向其添加 Aspire 集成的项目，然后选择 “添加>Aspire 包...”。

   

2. 包管理器随即打开，其中包含预配置（填充筛选器条件）的 Aspire 集成搜索结果，使你能够轻松浏览并选择所需的集成。

   

有关集成的详细信息 Aspire ，请参阅 Aspire 集成概述。

添加托管包

Aspire 托管包用于配置应用可能依赖或使用的各种资源和依赖项。 托管包不同于其他集成包，因为它们已添加到 *.AppHost 项目中。 若要将托管包添加到应用，请执行以下步骤：

1. 在 中，右键点击 *.AppHost 项目并选择 添加 包...。

   

2. 包管理器随即打开，其中预配置了 Aspire 托管包的搜索结果（填充筛选器条件），使你能够轻松浏览并选择所需的包。

   

添加编排项目

可以使用以下步骤将 Aspire 编排项目添加到现有应用：

1. 在 Visual Studio中，右键单击现有项目，然后选择 “添加”>Aspire编排器支持”。。

   

2. 此时会打开一个对话框窗口，其中包含添加到您解决方案中的 *.AppHost 和 *.ServiceDefaults 项目的摘要。

   

3. 选择 确定 并应用以下更改：

   • *.AppHost 和 *.ServiceDefaults 业务流程项目已添加到解决方案中。
   • 对 builder.AddServiceDefaults 的调用将添加到原始项目的 Program.cs 文件中。
   • 对原始项目的引用将被添加到 AppHost.cs 文件的 *.AppHost 项目中。

有关编排的详细信息，请参阅 Aspire。

加入编排

Visual Studio 提供了在新项目工作流期间 加入 Aspire 管理编排 的选项。 选择此选项可以 Visual Studio 创建 *.AppHost 和 *.ServiceDefaults 项目，与所选项目模板一起。

创建测试项目

使用Visual Studio时，选择“Aspire启动应用程序”模板时，可以选择包含测试项目。 此测试项目是一个 xUnit 项目，其中包含一个示例测试，可用于测试的起点。

有关详细信息，请参阅 编写第一个 Aspire 测试。

Visual Studio Code 模具

可以使用Visual Studio Code和C# Dev Kit扩展来创建和开发Aspire项目。 若要在其中Aspire创建新Visual Studio Code项目，请在.NET视图中选择“创建项目”按钮，然后选择其中一个Aspire模板：

创建新的 Aspire 项目后，您可以运行并调试应用程序，逐步执行断点，并使用 Visual Studio Code 调试器检查变量。