.NET Aspire Community Toolkit Node.js 托管扩展

项目
12/12/2024

注意

此集成是 .NET.NET Aspire 社区工具包的一部分，不受 .NET.NET Aspire 团队正式支持。

在本文中，你将了解 .NET Aspire Community Toolkit Node.js 托管扩展包，该包为 .NET AspireNodeJS 托管包提供额外的功能。扩展包具有以下功能：

运行 Vite 应用程序
使用 Yarn 和 pnpm 运行 Node.js 应用程序
确保在运行应用程序之前安装包（使用指定的包管理器）

托管集成

若要开始使用 .NET Aspire Community Toolkit Node.js 托管扩展，请在 AppHost 项目中安装 📦 CommunityToolkit.Aspire.Hosting.NodeJS.Extensions NuGet 包。

.NET 命令行界面 (CLI)
PackageReference

dotnet add package CommunityToolkit.Aspire.Hosting.NodeJS.Extensions

<PackageReference Include="CommunityToolkit.Aspire.Hosting.NodeJS.Extensions"
                  Version="*" />

有关详细信息，请参阅 dotnet add package 或在 .NET 应用程序中管理包依赖项。

示例用法

以下部分详细介绍了从运行 Vite 应用程序到使用特定包管理器的各种用法。

运行特定的包管理器

此集成扩展添加了对使用 Yarn 或 pnpm 作为包管理器运行 Node.js 应用程序的支持。

纱线
pnpm

var builder = DistributedApplication.CreateBuilder(args);

builder.AddYarnApp("yarn-demo")
       .WithExternalHttpEndpoints();

var builder = DistributedApplication.CreateBuilder(args);

builder.AddPnpmApp("pnpm-demo")
       .WithExternalHttpEndpoints();

运行 Vite 应用

此集成扩展添加了对运行 Vite 应用程序的开发 server 的支持。默认情况下，它通过 npm 包管理器进行启动，但可以通过 packageManager 参数进行覆盖。

var builder = DistributedApplication.CreateBuilder(args);

builder.AddViteApp("vite-demo")
       .WithExternalHttpEndpoints();

builder.AddViteApp("yarn-demo", packageManager: "yarn")
       .WithExternalHttpEndpoints();

builder.AddViteApp("pnpm-demo", packageManager: "pnpm")
       .WithExternalHttpEndpoints();

builder.Build().Run();

安装软件包

使用 WithNpmPackageInstallation、WithYarnPackageInstallation 或 WithPnpmPackageInstallation 方法时，包管理器用于在启动应用程序之前安装包。这些方法有助于确保在应用程序启动之前安装包，这类似于 .NET 应用程序在运行之前如何还原 NuGet 包。

通过