共用方式為

.NET .NET Aspire SDK

  • 發行項

.NET .NET Aspire SDK 適用於 *。AppHost 專案，做為 .NET.NET Aspire 協調器。 這些專案是透過 <IsAspireHost>true</IsAspireHost> 屬性來設置，並在項目檔中指定 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.0.0" />
    
    <PropertyGroup>
        <OutputType>Exe</OutputType>
        <TargetFramework>net9.0</TargetFramework>
        <IsAspireHost>true</IsAspireHost>
        <!-- Omitted for brevity -->
    </PropertyGroup>
    
    <ItemGroup>
        <PackageReference Include="Aspire.Hosting.AppHost" Version="9.0.0" />
    </ItemGroup>

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

上述範例專案會將最上層 SDK 定義為 Microsoft.NET.Sdk，並將 Aspire.AppHost.Sdk 定義為加法 SDK。 IsAspireHost 屬性設定為 true，表示此專案是 .NET.NET Aspire 應用程式主機。 專案同樣參考 Aspire.Hosting.AppHost 套件，而此套件帶來了多個與 Aspire相關的依賴性。

SDK 功能

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

項目參考

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

提示

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

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

Orchestrator 協調器相依性

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

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