构建及运行

在继续下一步之前，请确保已完成 设置流程。

什么是 just？

just 是 rolldown 存储库的命令运行程序。它可以用一个命令构建、测试和检查项目。

用法

你可以通过仅运行命令 just 来获取可用命令列表。

重要命令

• just roll - 从头构建 rolldown 并运行所有测试和检查。
• just test - 运行所有测试。
• just lint - 检查代码库。
• just fmt - 解决格式问题。
• just fix - 解决格式和检查问题。

大多数命令都将同时运行 Rust 和 Node.js 脚本。为了只定位一个，请在 just 命令后面附加 -rust 或 -node。例如，just lint-rust 或 just check-node。

提示

just roll 将成为你开发工作流中最常用的命令。它将在没有任何思考的情况下帮助你检查所有更改是否正常工作。

它将帮助你在本地发现错误，而不是将你的更改推送到 GitHub，然后等待 CI。

• just roll-rust - 仅运行 Rust 检查。
• just roll-node - 仅运行 Node.js 检查。
• just roll-repo - 检查与代码无关的问题，如文件名。

构建

Rolldown 是基于 Rust 和 Node.js 构建的，因此构建过程包括构建 Rust 箱体、Node.js 包以及将它们绑在一起的胶合部分。胶合部分也是一个 Node.js 包，但构建它也会触发构建 Rust 箱体。

幸运的是，NAPI-RS 已经封装了构建胶合部分的过程，我们无需担心细节。

rolldown

要构建 rolldown 包，有两个命令

• just build/just build native
• just build native release（如果您运行基准测试，这很重要）

它们将自动构建 Rust 箱体和 Node.js 包。因此，无论您进行了哪些更改，您总是可以运行这些命令来构建最新的 rolldown 包。

WASI

Rolldown 考虑将 WASI 作为一个特殊平台来进行支持。所以我们仍然使用 rolldown 包来分发 WASI 版本的 Rolldown。

要构建 WASI 版本，您可以运行以下命令

• just build wasi
• just build wasi release（如果您运行基准测试，这很重要）

构建 WASI 版本将删除 Rolldown 的原生版本。我们有目的性地设计了本地构建流程，即您可以构建原生版本或 WASI 版本。尽管 NAPI-RS 支持，但您不能将它们混合在一起。

运行

rolldown 包通过 pnpm 工作空间自动链接到 node_modules。

构建好 rolldown 包后，您可以使用以下命令运行它

pnpm rolldown