次の方法で共有

.NET .NET Aspire テンプレート

  • [アーティクル]

使用可能な .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 の場合は、次の手順に従います。

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

ヒント

.NET .NET Aspire ワークロードが既にインストールされている場合は、--force フラグを渡して既存のテンプレートを上書きする必要があります。 .NET .NET Aspire ワークロードをアンインストールしてください。

.NET .NET Aspire テンプレートを一覧表示する

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

Visual Studio: 新しいプロジェクトを作成し、'Aspire' を検索します。

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

Visual Studio Code: [プロジェクト .NET 作成] ボタン。

次に、検索バーで "Aspire" を検索して、使用可能な .NET Aspire プロジェクト テンプレートを確認します。

Visual Studio Code: 新しいプロジェクトを作成し、'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 テンプレートは、ソリューション テンプレートとプロジェクト テンプレートの 2 つのカテゴリで使用できます。 ソリューション テンプレートは複数のプロジェクトを含む新しい .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 プロジェクトに依存します。
    • の: 既定の .NET.NET Aspire サービス構成を持つ ASP.NET CoreBlazor アプリ プロジェクトは、の プロジェクトに依存しています。
    • 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: .NET.NET Aspire AppHost プロジェクトの xUnit.net 統合を含むプロジェクト。

    テスト テンプレートの詳細については、「でのテスト 」を参照してください。

  • .NET .NET Aspire サービスの既定値: スタンドアロンの ServiceDefaults プロジェクトは、ソリューション内のプロジェクト全体で再利用される構成を管理するために使用できます。このプロジェクトは、回復力、サービス検出、および テレメトリに関連しています。

    大事な

    サービスの既定のプロジェクト テンプレートは、Microsoft.AspNetCore.Appに FrameworkReference の依存関係を受け取ります。 これは、一部のプロジェクトの種類には適していない場合があります。 詳細については、「.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: テンプレートを .NET Aspire します。

プロンプトに従ってテンプレートからプロジェクトまたはソリューションを設定し、を選択してを作成します。

Visual Studio Codeを使用して .NET Aspire プロジェクトを作成するには、Visual Studio Code 新しいプロジェクト ウィンドウで Aspire を検索し、目的のテンプレートを選択します。

Visual Studio Code: .NET Aspire テンプレート。

目的の場所を選択し、名前を入力して、[の作成] 選択します。

.NET CLI を使用して .NET Aspire ソリューションまたはプロジェクトを作成するには、dotnet new コマンドを使用し、作成するテンプレートを指定します。 次の例を考えてみましょう。

最新の .NET バージョンを対象とする基本的な .NET.NET Aspire アプリ ホスト プロジェクトを作成するには:

dotnet new aspire-apphost

サンプル UI とバッキング API を含む完全なソリューションである .NET.NET Aspire スターター アプリを作成するには:

dotnet new aspire-starter

先端

.NET Aspire テンプレートは、.NET CLI の以前のバージョンを使用している場合でも、既定で最新の .NET バージョンを使用します。 .NET バージョンを手動で指定するには、--framework <tfm> オプションを使用します。たとえば、.NET 8 をターゲットとする基本的な .NET.NET Aspire アプリ ホスト プロジェクトを作成します。

dotnet new aspire-apphost --framework net8.0

関連項目