次の方法で共有

Aspire テンプレート

使用可能な Aspire プロジェクト テンプレートは多数あります。 これらのテンプレートを使用して、完全な Aspire ソリューションを作成したり、既存の Aspire ソリューションに個々のプロジェクトを追加したりできます。

Aspire テンプレートは 📦Aspire.ProjectTemplates NuGet パッケージで利用可能です。

使用可能なテンプレート

Aspire テンプレートを使用すると、Aspire ソリューションの構造と既定の設定で事前構成された新しいアプリを作成できます。 これらのプロジェクトでは、アプリのさまざまなリソース間で統合されたデバッグ エクスペリエンスも提供されます。

Aspire テンプレートは、ソリューション テンプレートとプロジェクト テンプレートの 2 つのカテゴリで使用できます。 ソリューション テンプレートは複数のプロジェクトを含む新しい Aspire ソリューションを作成し、プロジェクト テンプレートは既存の Aspire ソリューションに追加できる個々のプロジェクトを作成します。

ソリューション テンプレート

次の Aspire ソリューション テンプレートを使用できます。ソリューションの名前が 「AspireSample」であると仮定します。

  • Aspire 空のアプリ: 以下を含む最小限の Aspire プロジェクト。

  • Aspire スターターアプリ:に加えて .AppHost および .ServiceDefaults プロジェクトでは、 Aspire スターター アプリにも次のものが含まれます。

    • AspireSample.ApiService: ASP.NET Core 最小限の API プロジェクトを使用して、フロントエンドにデータを提供します。 このプロジェクトは、共有された AspireSample.ServiceDefaults プロジェクトに依存します。
    • AspireSample.Web: 既定ASP.NET Core サービス構成を持つBlazorアプリ プロジェクト。このプロジェクトは、Aspire プロジェクトに依存します。
    • AspireSample.Test: MSTest、 NUnit、または xUnit のいずれかのテスト プロジェクトで、 プロジェクトが AspireSample.AppHost に参照され、統合テスト を示すサンプル WebTests.cs ファイルが含まれています。

プロジェクト テンプレート

次の Aspire プロジェクト テンプレートを使用できます。

  • Aspire AppHost: スタンドアロン です。アプリ のさまざまなプロジェクトとサービスを調整および管理するために使用できる AppHost プロジェクト。

  • Aspire テスト プロジェクト: これらのプロジェクト テンプレートは、 Aspire アプリのテスト プロジェクトを作成するために使用され、機能テストと統合テストを表すことを目的としています。 テスト プロジェクトには、次のテンプレートが含まれています。

    • MSTest: Aspire AppHost プロジェクトの MSTest 統合を含むプロジェクト。
    • NUnit: Aspire AppHost プロジェクトの NUnit 統合を含むプロジェクト。
    • xUnit: Aspire AppHost プロジェクトの xUnit.net 統合を含むプロジェクト。

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

  • Aspire サービスの既定値：単独で使用可能な .ServiceDefaults プロジェクトは、回復性、サービス ディスカバリ、テレメトリに関連するソリューション内のプロジェクト全体で再利用される構成を管理するために使用できます。

    大事な

    サービスの既定のプロジェクト テンプレートは、FrameworkReferenceに Microsoft.AspNetCore.App の依存関係を受け取ります。 これは、一部のプロジェクトの種類には適していない場合があります。 詳細については、サービスの既定値Aspire参照してください。

Aspire テンプレートをインストールする

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 以降では、Aspire テンプレートが自動的にインストールされます。

これらのテンプレートをインストールするには、dotnet new install コマンドを使用して、Aspire.ProjectTemplates NuGet 識別子を渡します。

dotnet new install Aspire.ProjectTemplates

特定のバージョンをインストールするには、パッケージ名にバージョン番号を追加します。

dotnet new install Aspire.ProjectTemplates::9.4.0

テンプレートを使用してソリューションとプロジェクトを作成する

Aspire ソリューションまたはプロジェクトを作成するには、Visual Studio、Visual Studio Code、または .NET CLI を使用し、使用可能なテンプレートに基づいて作成します。 Aspire リポジトリのその他のAspire テンプレートについて説明します。

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

Visual Studio: Aspire テンプレート。

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

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

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

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

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

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

dotnet new aspire-apphost

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

dotnet new aspire-starter

ヒント

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

dotnet new aspire-apphost --framework net8.0

アプリを実行する前に、ASP.NET Corelocalhost 証明書を信頼する必要があります。 次のコマンドを実行します。

dotnet dev-certs https --trust

詳細については、localhostの信頼されていないAspire証明書のトラブルシューティングを参照してください。 localhostでの証明書Linuxのトラブルシューティングの詳細については、「ASP.NET Core: GitHub リポジトリの問題 #32842」を参照してください。

関連項目