构建系统概览
ReScript 自带一个快速且精简的构建系统 rescript
,它被用作社区的权威构建系统。
每个 ReScript 项目都需要一个构建描述文件,即 bsconfig.json
。
构建选项
通过 rescript -help
查看构建选项:
❯ rescript -help Available flags -v, -version display version number -h, -help display help Subcommands: build clean format convert help Run rescript subcommand -h for more details, For example: rescript build -h rescript format -h The default `rescript` is equivalent to `rescript build` subcommand
构建项目
每次构建都会从你的项目的源文件中创建构建制品(artifacts)。
使用以下命令来构建一个项目(包括其依赖/固定依赖):
SHrescript
这是 rescript build
的一个别名。
使用以下命令以 watch 模式启动构建:
SHrescript build -w
这样任何的文件变化都会被捕捉到,并重新开始构建。
注意:第三方库(指在 node_modules
中的库或 pinned-dependencies
引入的库)不会被监听,因为这样做可能超过 node.js 的监听器数量限制。
注意2: 如果你想以 JS-monorepo-esque 的方式(npm
和 yarn
工作区)建立一个项目,你的子包的变化应该被构建工具注意到,你需要在主项目的 bsconfig.json
中定义固定依赖。更多细节参见这里。
清理项目
如果你因为边缘情况需要处理过时的构建,可以使用:
SHrescript clean
这将清空你的项目的构建制品。要清理依赖项的构建制品,可以使用:
SHrescript clean -with-deps