Partager via

sdk .NET.NET Aspire

  • Article

Le SDK .NET.NET Aspire est destiné à *.AppHost projets, qui servent d’orchestrateur .NET.NET Aspire. Ces projets sont désignés à l’aide de la propriété <IsAspireHost>true</IsAspireHost>, en spécifiant également la Aspire.AppHost.Sdk dans le fichier projet. Le Kit de développement logiciel (SDK) fournit un ensemble de fonctionnalités qui simplifient le développement d’applications .NET.NET Aspire.

Aperçu

Le 📦Aspire. AppHost.Sdk est un sdk de projet MSBuild additif pour la création d’applications .NET.NET Aspire. Le Aspire.AppHost.Sdk est défini avec un Project/Sdkde niveau supérieur :

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

L’exemple de projet précédent définit le Kit de développement logiciel (SDK) de niveau supérieur comme Microsoft.NET.Sdk et le Aspire.AppHost.Sdk comme kit SDK additif. La propriété IsAspireHost est définie sur true pour indiquer que ce projet est un hôte d’application .NET.NET Aspire. Le projet fait également référence au package Aspire.Hosting.AppHost qui apporte un certain nombre de dépendances liées à Aspire.

Fonctionnalités du Kit de développement logiciel (SDK

Le sdk .NET.NET Aspire fournit plusieurs fonctionnalités clés.

Références de projet

Chaque instance de ProjectReference dans le projet hôte d'application .NET.NET Aspire ne sont pas traitées comme des références de projet standard. Au lieu de cela, ils permettent à l’hôte d’application d’exécuter ces projets dans le cadre de son orchestration. Chaque référence de projet déclenche un générateur pour créer un class qui représente le projet en tant que IProjectMetadata. Ces métadonnées sont utilisées pour remplir les projets nommés dans l’espace de noms Projects généré. Lorsque vous appelez l’API Aspire.Hosting.ProjectResourceBuilderExtensions.AddProject, l’espace de noms Projects est utilisé pour référencer le projet, en passant la classe générée en tant que paramètre de type générique.

Pourboire

Si vous devez référencer un projet de la manière transditionnelle au sein de l’hôte de l’application, définissez l’attribut IsAspireProjectResource sur l’élément ProjectReference sur false, comme illustré dans l’exemple suivant :

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

Dépendances d’orchestrateur

Le SDK .NET.NET Aspire ajoute dynamiquement des références au tableau de bord .NET.NET Aspire et d’autres dépendances de l’hôte d’application, telles que les packages de plan de contrôle du développeur (DCP). Ces dépendances sont spécifiques à la plateforme sur laquelle l’hôte d’application est basé.

Lorsque le projet hôte d’application s’exécute, l’orchestrateur s’appuie sur ces dépendances pour fournir les fonctionnalités nécessaires à l’hôte de l’application. Pour plus d’informations, consultez .NET.NET Aspire vue d’ensemble de l’orchestration.