通过

Aspire Community Toolkit Node.js 托管扩展

包括：托管集成已包括仅限于—Client集成不包括Client集成不包括

注意

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

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

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

托管集成

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

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

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

示例用法

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

运行特定的包管理器

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

var builder = DistributedApplication.CreateBuilder(args);

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

运行 Vite 应用

此集成扩展增加了对运行 Vite 应用程序的开发服务器的支持。 默认情况下，它通过 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 包。

另请参阅