build
Usage: modern build [options]
构建模块命令
Options:
-w, --watch 使用 Watch 模式构建模块
--tsconfig [tsconfig] 指定 tsconfig.json 文件的路径 (default:
"./tsconfig.json")
--style-only 只构建样式文件
--platform [platform] 构建其他平台产物
--no-tsc 关闭 tsc 编译
--no-clear 不清理产物目录
-h, --help display help for command
提示
Yarn 和 pnpm 调用命令时接收参数的方式不同,例如,在如下 package.json
配置中:
{
"scripts": {
"command": "modern command"
}
}
当需要执行 modern command --option
:
使用 Yarn 时,需要执行 yarn command --option
。
使用 pnpm 时,需要执行 pnpm run command -- --option
。
这是因为 pnpm 对于命令参数的处理与 Yarn 并不相同,但是与 npm 类似:在不加 --
字符串的时候,传递的是 pnpm 的参数;在使用 --
字符串的时候,传递的是执行脚本的参数。
在上述例子里参数 --option
传递给了 modern command
。如果执行 pnpm run command --option
,则参数 --option
将传递给 pnpm。
总结来说:
在使用 pnpm 时,如果传递的参数给 pnpm,不需要加 --
;如果传递的参数是给脚本使用,需要增加 --
字符串。
modern build
命令默认在 dist
目录输出模块构建产物。 产物目录结构如下:
其中:
types
目录包含所有生成的d.ts
文件。modern
、node
、treeshaking
目录分别对应不同语法和模块化规范的构建产物。修改 Modern.js 配置文件的output.packageMode
或者output.packageFields
配置项会改变构建产物的语法和模块规范。dist/js/styles
目录包含所有src
目录中非(js|ts)x
的原文件。dist/styles
目录包含所有 styles 目录中编译后的文件。
一些重要的命令参数如下:
--watch
监听模块源文件变化自动重新编译输出产物,在开发调试模块阶段非常有帮助。--no-tsc
关闭类型检查以及.d.ts
类型文件的生成,对应构建的速度的也会有提升。