次の方法で共有

.NET .NET Aspire テンプレート

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

.NET .NET Aspire テンプレートは、📦Aspireで使用できます。ProjectTemplates NuGet パッケージ。

使用可能なテンプレート

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

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

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

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

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

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

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

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

  • .NET .NET Aspire アプリ ホスト: スタンドアロン 。アプリ のさまざまなプロジェクトとサービスを調整および管理するために使用できる 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 プロジェクトは、回復性、サービス検出、およびテレメトリに関連するソリューション内の各プロジェクトで再利用される構成を管理するために使用できます。

    大事な

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

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

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

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

最新の .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 Aspire プロジェクトを作成します。

dotnet new aspire-apphost --framework net8.0

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

dotnet dev-certs https --trust

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

関連項目