.NET .NET Aspire 範本

發行項
12/15/2024

有許多 .NET.NET Aspire 項目範本可供您使用。您可以使用這些範本來建立完整的 .NET Aspire 解決方案，或將個別專案新增至現有的 .NET Aspire 解決方案。

.NET .NET Aspire 範本可在 📦Aspire中取得，ProjectTemplates NuGet 套件。

安裝 .NET.NET Aspire 範本

若要在 Visual Studio中安裝 .NET Aspire 範本，除非您使用 Visual Studio 17.12 或更新版本，否則您必須手動安裝範本。針對 Visual Studio 17.9 到 17.11，請遵循下列步驟：

開啟 Visual Studio。
移至 [工具]>[NuGet 套件管理員]>[套件管理員主控台]。
執行下列命令以安裝樣本：

dotnet new install Aspire.ProjectTemplates

針對 Visual Studio 17.12 或更新版本，系統會自動安裝 .NET Aspire 範本。

若要安裝這些範本，請使用 dotnet new install 命令，傳入 Aspire.ProjectTemplates NuGet 識別符。

dotnet new install Aspire.ProjectTemplates

若要安裝特定版本，請將版本號碼附加至套件名稱：

dotnet new install Aspire.ProjectTemplates::9.0.0

提示

如果您已安裝 .NET.NET Aspire 工作負載，則必須傳遞 --force 旗標來覆寫現有的範本。您可以隨意卸載 .NET.NET Aspire 工作負載。

列出 .NET.NET Aspire 範本

當您安裝 Visual Studio 17.9 或更新版本時，會自動安裝 .NET Aspire 範本。若要查看可用的 .NET.NET Aspire 範本，請選取 [檔案]>[>專案]Visual Studio，然後在搜尋列中搜尋 “Aspire” （Alt+S]。您會看到可用 .NET.NET Aspire 項目樣本的清單：

若要在已安裝 C# DevKit 的 Visual Studio Code 中檢視可用的範本，請在 [Explorer 檢視中未開啟資料夾時，選取 [建立 .NET 專案] 按鈕：

然後，在搜尋列中搜尋「Aspire」，以查看可用的項目範本 .NET Aspire：

若要確認已安裝 .NET.NET 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
---------------------------------  ----------------------  --------  -------------------------------------------------------
.NET Aspire App Host               aspire-apphost          [C#]      Common/.NET Aspire/Cloud
.NET Aspire Empty App              aspire                  [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Service Defaults       aspire-servicedefaults  [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service
.NET Aspire Starter App            aspire-starter          [C#]      Common/.NET Aspire/Blazor/Web/Web API/API/Service/Cloud
.NET Aspire Test Project (MSTest)  aspire-mstest           [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (NUnit)   aspire-nunit            [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test
.NET Aspire Test Project (xUnit)   aspire-xunit            [C#]      Common/.NET Aspire/Cloud/Web/Web API/API/Service/Test

可用的範本

.NET Aspire 範本可讓您使用 .NET Aspire 解決方案結構和預設設定來建立預先設定的新應用程式。這些專案也會在應用程式的不同資源之間提供統一的偵錯體驗。

.NET .NET Aspire 範本有兩個類別：方案範本和項目範本。方案範本會建立具有多個專案的新 .NET Aspire 方案，而專案範本則會建立可新增至現有 .NET Aspire 解決方案的個別專案。

解決方案範本

下列 .NET.NET Aspire 解決方案範本可供使用，假設解決方案名為 AspireSample：

.NET .NET Aspire 空白應用程式：包含以下內容的基本 .NET.NET Aspire 專案：
- AspireSample.AppHost：協調器專案，其設計目的是連線及設定應用程式的不同項目和服務。
- AspireSample.ServiceDefaults：.NET.NET Aspire 共用專案，用於管理解決方案中重複使用的設定，這些設定與復原、服務探索，以及遙測相關。

.NET .NET Aspire 入門應用程式：除了 之外。AppHost 與 。ServiceDefaults 專案，.NET.NET Aspire 入門應用程式也包含下列專案：
- AspireSample.ApiService：ASP.NET Core 最小 API 專案可用來將數據提供給前端。此專案取決於共用 AspireSample.ServiceDefaults 專案。
- AspireSample.Web：具有預設 .NET.NET Aspire 服務組態的 ASP.NET CoreBlazor App 專案，此專案取決於 AspireSample.ServiceDefaults 專案。
- AspireSample.Test：MSTest、NUnit，或 xUnit 測試專案，以及 AspireSample.AppHost 項目參考，以及示範整合測試的範例 WebTests.cs 檔案。

項目範本

下列 .NET.NET Aspire 項目範本可供使用：

.NET .NET Aspire App Host：一個獨立的 AppHost 專案，可以用來協調與管理應用程式的不同專案和服務。

.NET .NET Aspire 測試專案：這些專案範本可用來為 .NET.NET Aspire 應用程式建立測試專案，而且其用途是代表功能和整合測試。測試專案包含下列範本：
- MSTest：一個包含 .NET.NET Aspire AppHost 專案的 MSTest 整合專案。
- NUnit：包含 .NET.NET Aspire AppHost 專案的 NUnit 整合的專案。
- 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.NET Aspire 範本。

若要使用 Visual Studio建立 .NET Aspire 專案，請在 Visual Studio 新專案視窗中搜尋 Aspire，然後選取所需的範本。

請依照提示從範本設定專案或方案，然後選取建立。

若要使用 Visual Studio Code建立 .NET Aspire 專案，請在 Visual Studio Code 新專案視窗中搜尋 Aspire，然後選取所需的範本。

選取所需的位置、輸入名稱，然後選取建立。

若要使用 .NET CLI 建立 .NET Aspire 方案或專案，請使用 dotnet new 命令，並指定您想要建立的範本。請考慮下列範例：

若要建立以最新 .NET 版本為目標的基本 .NET.NET Aspire 應用程式主機專案：

dotnet new aspire-apphost

若要建立 .NET.NET Aspire 入門應用程式，這是包含範例 UI 和支援 API 的完整解決方案：

dotnet new aspire-starter

提示

.NET Aspire 範本預設為使用最新的 .NET 版本，即使使用舊版的 .NET CLI 也一樣。若要手動指定 .NET 版本，請使用 --framework <tfm> 選項，例如建立以 .NET 8 為目標的基本 .NET.NET Aspire 應用程式主機專案：

dotnet new aspire-apphost --framework net8.0

共用方式為