.NET .NET Aspire SDK

.NET .NET Aspire SDK 適用於 *AppHost 專案，作為 .NET.NET Aspire 協調器。 這些專案是由其在項目檔中的 用法 Aspire.AppHost.Sdk 所指定。 SDK 提供一組功能，可簡化 .NET.NET Aspire 應用程式的開發。

概述

AppHost.Sdk 是 MSBuild 專案 SDK 的一種擴充 ，用於建置 應用程式。 Aspire.AppHost.Sdk 是由高層級 Project/Sdk定義的：

<Project Sdk="Microsoft.NET.Sdk">

    <Sdk Name="Aspire.AppHost.Sdk" Version="9.1.0" />
    
    <PropertyGroup>
        <OutputType>Exe</OutputType>
        <TargetFramework>net9.0</TargetFramework>
        <!-- Omitted for brevity -->
    </PropertyGroup>
    
    <ItemGroup>
        <PackageReference Include="Aspire.Hosting.AppHost" Version="9.1.0" />
    </ItemGroup>

    <!-- Omitted for brevity -->
</Project>

上述範例專案會將最上層 SDK 定義為 Microsoft.NET.Sdk，並將 Aspire.AppHost.Sdk 定義為加法 SDK。 專案同樣參考 Aspire.Hosting.AppHost 套件，而此套件帶來了多個與 Aspire相關的依賴性。

SDK 功能

.NET .NET Aspire SDK 提供數個主要功能。

項目參考

ProjectReference 專案中的每個 .NET 不會被視為標準項目參考。 相反地，它們可讓 應用程式主機 在其協調流程中執行這些專案。 每個專案參考都會觸發產生器來建立 class，將專案表示為 IProjectMetadata。 此元數據可用來填入產生的 Projects 命名空間中的具名專案。 當您呼叫 Aspire.Hosting.ProjectResourceBuilderExtensions.AddProject API 時，會使用 Projects 命名空間來參考專案，將產生的類別傳遞為泛型型別參數。

提示

如果您需要以傳統方式在應用程式主機上參考專案，請將 元素上的 ProjectReference 屬性設定IsAspireProjectResource為 false，如下列範例所示：

<ProjectReference Include="..\MyProject\MyProject.csproj" IsAspireProjectResource="false" />

否則，根據預設，會將 ProjectReference 視為 .NET.NET Aspire 項目資源。

Orchestrator 協調器相依性

.NET .NET Aspire SDK 會動態新增對 .NET.NET Aspire 儀錶板 以及其他應用程式主機相依性的參照，例如開發者控制層（DCP）套件。 這些相依性專屬於應用程式主機所建置的平臺。

當應用程式主機專案執行時，協調器會依賴這些相依性，為應用程式主機提供必要的功能。 如需詳細資訊，請參閱 .NET.NET Aspire 協作概觀。