.NET .NET Aspire のセットアップとツール

Visual Studio 2022 17.9 以降には、Web & Cloud ワークロードをインストールするときに既定で最新の .NET.NET Aspire SDK が含まれています。 以前のバージョンの Visual Studio 2022 を使用している場合は、Visual Studio 2022 17.9 にアップグレードするか、次の手順を使用して .NET Aspire SDK をインストールできます。

.NET Aspire 2022 で Visual Studio ワークロードをインストールするには、Visual Studio インストーラーを使用します。

1. Visual Studio インストーラーを開きます。

2. 「 修正」を選択します Visual Studio 2022 の横にある。

3. ASP.NET と Web 開発 ワークロードを選択します。

4. インストールの詳細 パネルで、.NET.NET Aspire SDKを選択します。

5. .NET 統合をインストールするには、.NET Aspire の変更] を選択します。

   

.NET Aspireに Visual Studio テンプレートをインストールするには、Visual Studio 17.12 以降を使用していない限り、手動でインストールする必要があります。 Visual Studio 17.9 から 17.11 の場合は、次の手順に従います。

1. Visual Studioを開きます。
2. Tools>NuGet パッケージ マネージャー>パッケージ マネージャー コンソールに移動します。
3. 次のコマンドを実行してテンプレートをインストールします。

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.3.0

.NET Aspire テンプレートは、Visual Studio 17.9 以降をインストールすると自動的にインストールされます。 使用可能な .NET.NET Aspire テンプレートを確認するには、の >>Visual Studio を選択し、検索バーで "Aspire" を検索します (Alt+S)。 使用可能な .NET.NET Aspire プロジェクト テンプレートの一覧が表示されます。

C# DevKit がインストールされている Visual Studio Code で使用可能なテンプレートを表示するには、.NET ビューでフォルダーが開かなくなったときに Project の作成] ボタンを選択します。

次に、検索バーで "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

Visual Studio ツール類

Visual Studio には、 .NET Aspire 統合と App Host オーケストレーター プロジェクトを操作するための追加機能が用意されています。 現在、これらの機能の一部は、Visual Studio Code または CLI で使用できるわけではありません。

統合パッケージを追加する

.NET Aspireを使用して、他の NuGet パッケージと同様に、Visual Studio 統合をアプリに追加します。 ただし、Visual Studio には、.NET Aspire 統合を直接追加するための UI オプションも用意されています。

1. で、 統合を追加するプロジェクトを右選択し、[ パッケージの追加]選択します。..。

   

2. パッケージ マネージャーが開き、.NET.NET Aspire 統合用に事前に構成された検索結果 (フィルター条件の設定) が表示され、目的の統合を簡単に参照して選択できます。

   

統合の詳細については、統合の概要 参照してください。

ホスティング パッケージを追加する

.NET .NET Aspire ホスティング パッケージは、アプリが依存または使用する可能性があるさまざまなリソースと依存関係を構成するために使用されます。 ホスティング パッケージは、* に追加されるという点で、他の統合パッケージと区別されます。AppHost プロジェクト。 ホスティング パッケージをアプリに追加するには、次の手順に従います。

1. Visual Studioで、*.AppHost プロジェクトを右クリックして選択し、追加>.NET.NET Aspire パッケージ... を選択。

   

2. パッケージ マネージャーが開き、.NET.NET Aspire ホスティング パッケージの検索結果が事前に構成 (フィルター条件の設定) され、目的のパッケージを簡単に参照して選択できます。

   

オーケストレーション プロジェクトを追加する

次の手順 .NET.NET Aspire 使用して、オーケストレーション プロジェクトを既存のアプリに追加できます。

1. Visual Studioで既存のプロジェクトを右クリックし、[追加] で>.NET.NET Aspire Orchestrator サポートを選択します。

   

2. ダイアログウィンドウが開き、ソリューションに追加される*.AppHost および *.ServiceDefaults プロジェクトの概要が表示されます。

   

3. [OK] 選択すると、次の変更が適用されます。

   • *.AppHost と *.ServiceDefaults オーケストレーション プロジェクトがソリューションに追加されます。
   • builder.AddServiceDefaults の呼び出しが、元のプロジェクトの Program.cs ファイルに追加されます。
   • 元のプロジェクトへの参照が、* の Program.cs ファイルに追加されます。AppHost プロジェクト。

オーケストレーション の詳細については、オーケストレーションの概要 参照してください。

オーケストレーションに参加する

では、新しいプロジェクト ワークフロー中に のオーケストレーション に登録する オプションが提供されます。 このオプションを選択すると、選択されたプロジェクト テンプレートと共に、Visual Studio が の *.AppHost プロジェクトと の *.ServiceDefaults プロジェクトを作成します。

テスト プロジェクトを作成する

を使用していて、[アプリケーションの開始] テンプレート 選択すると、テスト プロジェクトを含めることができます。 このテスト プロジェクトは、テストの開始点として使用できるサンプル テストを含む xUnit プロジェクトです。

詳細については、「最初の .NET.NET Aspire テストを記述する」を参照してください。

Visual Studio Code ツール類

Visual Studio Code C# Dev Kit プロジェクトの作成と開発には、と共に .NETを使用できます。 .NET Aspireで新しい Visual Studio Code プロジェクトを作成するには、.NET ビューで Project ボタンを選択し、.NET.NET Aspire テンプレートのいずれかを選択します。

新しい .NET Aspire プロジェクトを作成したら、アプリを実行してデバッグし、ブレークポイントをステップ実行し、Visual Studio Code デバッガーを使用して変数を検査します。