Lerna

@lerna/run

在包含该脚本中的每个包中运行 npm 脚本

安装 lerna 以访问lerna CLI。

使用

lerna run <script> -- [..args] # 在所有包含 my-script 的包中运行 npm run
lerna run test
lerna run build

# 观察所有包和 transpile 的变化，使用流前缀输出
lerna run --parallel watch
1
2
3
4
5
6

在包含该脚本中的每个包中运行npm 脚本，必须使用双横线--来将虚线参数传递给给执行的脚本。

配置项

lerna exec接受所有的过滤器参数

lerna run --scope my-component test
1

--npm-client <client>

必须是一个知道如何运行 npm 生命周期脚本的可执行文件。默认的--npm-client是npm。

lerna run build --npm-client=yarn
1

也可以在lerna.json中配置：

{
  "command": {
    "run": {
      "npmClient": "yarn"
    }
  }
}
1
2
3
4
5
6
7

--stream

立即从子进程输出流，它的前缀为原始的包名。这让不同的包交叉输出成为可能。

lerna run watch --stream
1

--parallel

和--stream相类似，但完全忽略并发性和拓扑顺序。它会立即在带有前缀的流输出的所有匹配包中运行给定的命令或脚本。这是在许多包上运行的长时间运行的进程(如npm run watch)的首选参数。

lerna run watch --parallel
1

注意

在使用--parallel时建议限制该命令的作用域，因为生成几十个子进程可能会损害 shell 的稳定性(例如，最大文件描述符限制)。这个因人而异。

--no-bail

# 在所有包含它的包中运行 npm 脚本，忽略非零(错误)退出代码
lerna run --no-bail test
1
2

默认情况下，如果任何执行过程返回一个非零的退出代码，lerna run将退出并报错。——no-bail可以禁用此行为，让其所有包中执行，而无视退出代码。

--no-prefix

当输出为流(--stream或--parallel)时禁用包名前缀。该配置项应用在将结果传输到其他进程时很有用，比如编辑器插件。

--profile

对命令执行进行分析，并生成性能分析文件，可以在基于 chrome 的浏览器中使用 DevTools 进行分析(URL为：devtools://devtools/bundled/devtools_app.html)。该分析文件显示了命令执行的时间线，其中每次执行都会分配给一个打开的槽。槽的数量由--concurrency决定，开放槽的数量由--concurrency减去正在进行的操作的数量决定。最终结果是对并行执行命令的可视化展示。

性能分析文件输出的默认位置是项目的根目录。

lerna run build --profile
1

注意

Lerna 只会在启用拓扑排序(即不使用--parallel和--no-sort)时分析性能。

--profile-location <location>

您可以提供一个自定义位置用于性能分析文件的输出。提供的路径是相对于当前工作目录进行解析的。

lerna run build --profile --profile-location=logs/profile/
1

← lerna/init →