通过

.NET .NET Aspire 模板

  • 项目

有许多 .NET.NET Aspire 项目模板可供你使用。 可以使用这些模板创建完整的 .NET Aspire 解决方案，或将单个项目添加到现有 .NET Aspire 解决方案。

.NET .NET Aspire 模板在 📦Aspire.ProjectTemplates NuGet 包中提供。

可用模板

使用 .NET Aspire 模板，可以使用 .NET Aspire 解决方案结构和默认设置来预配置新应用。 这些项目还提供跨应用的不同资源的统一调试体验。

.NET .NET Aspire 模板分为两类：解决方案模板和项目模板。 解决方案模板使用多个项目创建新的 .NET Aspire 解决方案，而项目模板创建可添加到现有 .NET Aspire 解决方案的各个项目。

解决方案模板

以下 解决方案模板可用，假设解决方案名为 aspireSample：

项目模板

以下 .NET.NET Aspire 项目模板可用：

  • .NET .NET Aspire 应用主机：独立 AppHost 项目，可用于统筹和管理您应用程序的不同项目和服务。

  • .NET .NET Aspire 测试项目：这些项目模板用于为 .NET.NET Aspire 应用创建测试项目，它们旨在表示功能和集成测试。 测试项目包括以下模板：

    • MSTest：包含 .NET.NET Aspire AppHost 项目的 MSTest 集成的项目。
    • NUnit：包含 NUnit 集成的 .NET.NET Aspire AppHost 项目的项目。
    • xUnit：一个包含 xUnit.net 集成的 .NET.NET Aspire AppHost 项目。

    有关测试模板的详细信息，请参阅 中的 测试。

  • .NET .NET Aspire 服务默认值：一个独立的 ServiceDefaults 项目，可用于管理解决方案中与 复原能力、服务发现以及 遥测相关，且在跨项目中重复使用的配置。

    重要

    服务默认项目模板对 FrameworkReference 具备 Microsoft.AspNetCore.App的依赖关系。 这可能不适合某些项目类型。 有关详细信息，请参阅 .NET.NET Aspire 服务默认值。

使用模板创建解决方案和项目

若要创建 .NET Aspire 解决方案或项目，请使用 Visual Studio、Visual Studio Code或 .NET CLI，并将其基于可用的模板。 浏览 .NET 存储库中的其他 .NET Aspire 模板。

若要使用 .NET Aspire创建 Visual Studio 项目，请在 Aspire 新项目窗口中搜索 Visual Studio 并选择所需的模板。

Visual Studio：.NET Aspire 模板。

按照提示配置项目或解决方案的模板，然后选择创建。

若要使用 .NET Aspire创建 Visual Studio Code 项目，请在 Aspire 新项目窗口中搜索 Visual Studio Code 并选择所需的模板。

Visual Studio Code：.NET Aspire 模板。

选择所需位置，输入名称，然后选择 创建。

若要使用 .NET Aspire CLI 创建 .NET 解决方案或项目，请使用 dotnet new 命令并指定要创建的模板。 请考虑以下示例：

若要创建面向最新 版本的基本 应用主机 项目：

dotnet new aspire-apphost

若要创建一个 .NET.NET Aspire 初学者应用，这是一个包含示例 UI 和支持 API 的完整解决方案：

dotnet new aspire-starter

提示

.NET Aspire 模板默认使用最新的 .NET 版本，即使使用早期版本的 .NET CLI 也是如此。 若要手动指定 .NET 版本，请使用 --framework <tfm> 选项，例如创建面向 .NET 8 的基本 .NET 项目：

dotnet new aspire-apphost --framework net8.0

另请参阅