CLI 使用教程#

我们提供了 @rsdoctor/cli 让你可以在本地通过 CLI 程序来使用 Rsdoctor 提供的功能

安装 @rsdoctor/cli#

npm add @rsdoctor/cli -D

命令使用#

rsdoctor <command> [options]

@rsdoctor/cli 目前提供了以下几个命令对应不同的功能：

analyze 命令#

analyze 命令主要是用于在本地加载 manifest.json 并且无需再次构建直接启动 Rsdoctor 的分析报告页面。

rsdoctor analyze --profile <manifestFile>

参数定义

• manifestFile 即为 manifest.json 的路径（支持本地路径）

使用示例

rsdoctor analyze --profile "./dist/.rsdoctor/manifest.json"

bundle-diff 命令#

bundle-diff 命令是用于在本地加载两份 manifest.json 并且打开 Rsdoctor 的 Bundle Diff 页面进行构建产物的对比和分析。

rsdoctor bundle-diff --baseline <baselineManifestJsonPath> --current <currentManifestJsonPath>

参数定义

• baselineManifestJsonPath 当作 基准 的 manifest.json 的路径（支持本地路径以及在线 url）
• currentManifestJsonPath 当作 当前 的 manifest.json 的路径（支持本地路径以及在线 url），用于和 基准 进行对比

使用示例

rsdoctor bundle-diff --baseline="baseline/.rsdoctor/manifest.json" --current="current/.rsdoctor/manifest.json"

Node API#

我们在 @rsdoctor/cli 中提供了 Node.js API，可以让你在 Node.js 运行时进行调用。

引入模块

const { execute } = require('@rsdoctor/cli');

execute()

execute 异步函数是 Rsdoctor CLI 的执行函数，通过调用 execute 函数就会自动解析 process.argv，然后调用不同的命令。

execute('analyze', {...})

如果你需要通过 Node.js API 直接执行 analyze 命令，则可以通过如下方式调用：

execute('analyze', {
  profile: 'input the manifest.json path or url',
}).then((sdk) => {
  console.log('execute "analyze" command success');
  // you can stop the Rsdoctor's dev-server by calling the sdk'api below:
  // sdk.dispose();
});