lerna实践

what's the lerna ?

A tool for managing JavaScript projects with multiple packages.
管理多模块JS项目的工具

What can Lerna do?

The two primary commands in Lerna are lerna bootstrap and lerna publish.
bootstrap will link dependencies in the repo together. publish will help publish any updated packages. 最初的两个命令是lerna bootstrap和lerna publish
bootstrap会关联仓库内的依赖。publish会发布全部更新的包

practice

1.安装并初始化目录

// 全局安装
npm i lerna -g

// 建立实践目录
mkdir lerna-demo
cd lerna-demo
lerna init
复制代码

初始化以后，会自动挂钩git，虽然尚未仓库

安装完毕以后，目录以下：

- packages(目录)
 - lerna.json(配置文件)
 - package.json(工程描述文件)
复制代码

2.建立一个包

mkdir module-1
cd module-1
npm init -y
复制代码

npm init -y 命令能够跳过输入面板直接生成默认的package.json，平常项目中不要这样用。

这是如今的文件目录

➜  lerna-demo git:(master) ✗ tree
.
├── lerna.json
├── package.json
└── packages
    └── module-1
        └── package.json

2 directories, 3 files
复制代码

3.给项目添加依赖

{
  "name": "module-1",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  // 这是添加的依赖
  "dependencies": {
    "lodash": "^4.17.4"
  }
}
复制代码

安装依赖

lerna bootstrap
复制代码

从输出信息能够看到，关联了一个依赖包

4.上传项目

你要如今git上新建一个仓库，而后按照指令连接便可

echo "# lerna-demo" >> README.md
git init
git add README.md
git commit -m "first commit"
git remote add origin https://github.com/daly-young/lerna-demo.git
git push -u origin master
复制代码

仓库链接上了，咱们开始发布吧

lerna publish
复制代码

选择版本号

我选了major，而后朝下走

啊哦~报错了~
报错缘由是根目录的package.json没有设置证书~因此我再从新设置下证书,每次加一个新包都会报这个问题，仍是按照提示新增一个LICENSE.md文件便可。

npm set init-license  ISC
复制代码

而后再从新发布一次

没问题，发布成功

publish的大体过程是：

1.本地打个tag（例如git tag v1.0.0）

2.自动更新依赖项版本号 示例

3.而后把各个package发布到npm

4.最后把tag和相应的commit给push上去

以上是lerna的常规建立发布流程，默认模式是Fixed/Locked mode (固定模式)。

lerna mode

lerna提供Fixed/Locked mode(固定模式)和Independent mode（独立模式） 这两种模式的区别在哪呢？

Fixed/Locked mode

Fixed mode Lerna projects operate on a single version line. The version is kept in the lerna.json file at the root of your project under the version key. When you run lerna publish, if a module has been updated since the last time a release was made, it will be updated to the new version you're releasing. This means that you only publish a new version of a package when you need to.
This is the mode that Babel is currently using. Use this if you want to automatically tie all package versions together. One issue with this approach is that a major change in any package will result in all packages having a new major version.
固定模式的Lerna项目在单一版本线上运行。 该版本在根目录的lerna.json文件中进行版本管理。 当执行lerna publish时，若是自上次发布版本以来有模块更新，则它将更新为您要发布的新版本。 这意味着你只需在须要时发布新版本的软件包。
这是Babel目前使用的模式。 若是要自动将全部包版本绑定在一块儿，请使用此选项。 这种方法的一个问题是，任何包中的重大更改都将致使全部包都将升级新版本。

直接上代码运行试试吧~~

mkdir module-2
cd module-2
npm init
lerna bootstrap
复制代码

虽然我只加了一个包，可是显示是关联了两个，这说明包括module-1的依赖包都从新关联了一次

而后我把这个包也发布上去了
接着，我修改了module-2

touch index.js
vim index.js
复制代码

index.js

exports.demo = (param) => {
    console.log('hello ' + param)
}
复制代码

我还在依赖文件里新增了

"vuex": "^2.5.0"
复制代码

这样的话，我算是有个重大修改，那么这个版本号是我手动修改的呢？仍是默认修改的呢？ 还让我手动修改就有点傻了~~因此我直接推送上去，而后lerna publish 果真，会让我再次选择版本号

选择以后，咱们会发现

无辜的module-1也更新了，lerna.json也更新了了版本号
这就是固定模式，咱们了解了，一个更新，全体更新，这样也不用担忧包之间相互依赖，版本不协调问题。 可是，若是存在不少package，一次改动就要叠加下版本号，总感受这操做有点凶残，因此咱们看看第二种模式是否是有新的思路

Independent mode

这个模式初始化须要指定

lerna init --independent
复制代码

Independent mode Lerna projects allows maintainers to increment package versions independently of each other. Each time you publish, you will get a prompt for each package that has changed to specify if it's a patch, minor, major or custom change.
Independent mode allows you to more specifically update versions for each package and makes sense for a group of components. Combining this mode with something like semantic-release would make it less painful. (There is work on this already at atlassian/lerna-semantic-release). 独立模式的Lerna项目容许维护人员相对独立地增长包版本。 每次发布时，你都会看到每一个已更改的包的提示，以指定它是补丁，次要，主要仍是自定义更改。
独立模式容许您更具体地更新每一个包的版本，而且只对一组组件有意义。 将这种模式与语义释放(???)之类的相结合能够减小痛苦。 （在atlassian / lerna-semantic-release上已有相关工做）。

// 将lerna.json中的版本密钥设置为独立以在独立模式下运行。
Set the version key in lerna.json to independent to run in independent mode.
复制代码

看起来这个是独立的，互不影响，咱们先来试验一波~

重启一个lerna项目，这里不重复了，别忘了指定模式。 咱们新建了module-1和module-2的包，而且已经发布成功了，OK,接下来咱们修改module-2,依然是新增index.js，而后提发布

我改的是module-2，可是询问我module-1的修改？

而后询问module-2？是否是我操做有误？

不是，立马再去查文档，发现是本身理解有误，这个相对独立并非说我改了一个包就只发这个一个包，而是我改了一个包，能够具体制定其余包的版本，而不是像固定模式同样，一个包升级大版本，全部包都升级大版本，这里能够对每一个包独立定制版本。。原来是这个意思~~

那么到这，两种模式都实验完毕~这只是简单的操做，其余API（官方）你们能够再试试~~没事记得给人家官方star一下~

参考文章：

lerna管理前端packages的最佳实践
官方github