lerna 介绍
lerna 处理机构
固定模式(fixed)
所有包是统一的版本号,每次升级,所有包版本统一更新,不管这个包内容改变与否
具体体现在,lerna
的配置文件 lerna.json
中永远会存在一个确定版本号:
{
"version": "0.0.1"
}
典型例子: babel
、vue
独立模式(independent)
每个包是单独的版本号,每次lerna 触发发布命令,每个包的版本都会单独变化
具体体现在,lerna
的配置文件 lerna.json
中没有一个确定版本号,而是:
{
"version": "independent"
}
lerna 安装
代码语言:javascript复制npm install lerna -g
lerna -v
lerna 初始化
代码规范采用lerna
提供的规范结构的话:
# 默认固定模式
lerna init
# 要采用独立模式的话
lerna init -i
# lerna init --independent
生成的代码结构
代码语言:javascript复制└── lerna/
├── packages/
├── lerna.json
└── package.json
如果代码已经存在,则只需要在项目下创建lerna.json
并补充相关字段
{
"useWorkspaces": true, // 使用 workspaces 配置。此项为 true 的话,将使用 package.json 的 "workspaces",下面的 "packages" 字段将不生效
"version": "0.1.0", // 所有包版本号,独立模式-"independent"
"npmClient": "cnpm", // npm client,可设置为 cnpm、yarn 等
"packages": [ // 包所在目录,可指定多个
"packages/*"
],
"command": { // lerna 命令相关配置
"publish": { // 发布相关
"ignoreChanges": [ // 指定文件或目录的变更,不触发 publish
".gitignore",
"*.log",
"*.md"
]
},
"bootstrap": { // bootstrap 相关
"ignore": "npm-*", // 不受 bootstrap 影响的包
"npmClientArgs": [ // bootstr 执行参数
"--no-package-lock"
]
}
}
}
lerna 相关命令
lerna官方文档https://lerna.js.org/
初始化
代码语言:javascript复制创建一个新的
lerna
仓库或者将现有的仓库使用lerna
管理
lerna init # -i/--independent
Publish
代码语言:javascript复制发布包
lerna publish
Bootstrap
代码语言:javascript复制把所有包安装到根
node_modules
lerna bootstrap
Run
代码语言:javascript复制运行每个包中的
script
命令
lerna run <script> --[...args]
Exe
代码语言:javascript复制单独运行某个包下的
script
命令
lerna exec -- <command> [...args]
# example
$ lerna exec -- rm -rf ./node_modules
$ lerna exec -- protractor conf.js
Add
代码语言:javascript复制安装本地或者远程的包
lerna add <package>[@version] [--dev] [--exact] [--peer]
#--dev 将新包添加到devDependencies而不是dependencies.
#--exact 添加具有确切版本(例如1.0.1)而不是默认^semver 范围(例如^1.0.1)的新包。
#--peer 将新包添加到peerDependencies而不是dependencies.
#将 module-1 包添加到 'prefix-' 前缀文件夹中的包中
lerna add module-1 packages/prefix-*
#将模块 1 安装到模块 2
lerna add module-1 --scope=module-2
#在 devDependencies 中将 module-1 安装到 module-2
lerna add module-1 --scope=module-2 --dev
#在 peerDependencies 中安装 module-1 到 module-2
lerna add module-1 --scope=module-2 --peer
#在除module-1之外的所有模块中安装module-1
lerna add module-1
#在所有模块中安装 babel-core
lerna add babel-core