JavaScript API

Rsbuild 提供了一整套 JavaScript API,以便于开发者基于 Rsbuild 开发上层的解决方案。

接入示例

下面是接入 Rsbuild JavaScript API 的基本示例。

1. 安装 Rsbuild

你需要安装 @rsbuild/core 包:

npm
yarn
pnpm
bun
npm add @rsbuild/core -D

2. 创建 Rsbuild 实例

你可以调用 createRsbuild 方法来创建一个 Rsbuild 实例对象:

import { createRsbuild } from '@rsbuild/core';

const rsbuild = await createRsbuild();

createRsbuild 方法提供了一些选项,你可以在 API - createRsbuild 中进一步了解。

3. 调用 Rsbuild 实例方法

Rsbuild 实例提供了与构建相关的各个方法,你可以根据实际场景来进行使用。

在本地开发场景,建议使用 rsbuild.startDevServer 方法,调用后会启动本地 Dev Server。

await rsbuild.startDevServer();

成功启动 Dev Server 后,可以看到以下日志信息:

> Local:    http://localhost:8081
  > Network:  http://192.168.0.1:8081

在生产环境部署场景,建议使用 rsbuild.build 方法,调用后会构建出生产环境产物。

await rsbuild.build();

关于 Rsbuild 实例方法的更多介绍,请阅读 Rsbuild Instance 章节。

通过以上三个步骤,你已经了解了 Rsbuild 基本的使用方法。接下来你可以通过 Rsbuild 插件和 Rsbuild 配置来对构建流程进行定制。