lerna-demo-fangcao

v1.0.0

Published

3 years ago

- `mkdir lerna-demo` 在d:/ 下创建一个空的文件夹，命名为lerna-demo - `cd lerna-demo && lerna init` 初始化通过cmd进入相关目录，进行初始化 - 生成目录如下：

Downloads

0High
0Medium
0Low

fangcao7618

lerna

mkdir lerna-demo 在d:/ 下创建一个空的文件夹，命名为lerna-demo
cd lerna-demo && lerna init 初始化通过cmd进入相关目录，进行初始化
生成目录如下：
- packages(目录)
- lerna.json(配置文件)
- package.json(工程描述文件)

添加一个测试package

默认情况下，package是放在packages目录下的。

// 进入packages目录
cd d:/lerna-demo/packages
// 创建一个packge目录
mkdir module-1
// 进入module-1 package目录
cd module-1
// 初始化一个package
npm init -y

cd lerna-demo && lerna bootstrap安装各packages依赖这一步操作，官网上是这样描述的。
- lerna bootstrap：安装依赖
- lerna publish：发布和更新package
发布在发布的时候，就需要git 工具的配合了。所以在发布之前，请确认此时该lerna工程是否已经连接到git的远程仓库。你可以执行下面的命令进行查看。
```
git remote -v
// print log
origin  [email protected]:xmkp-math-h5/lerna-demo.git (fetch)
origin  [email protected]:xmkp-math-h5/lerna-demo.git (push)
```

本篇文章的代码托管在Github上。因此会显示此远程链接信息。如果你还没有与远程仓库链接，请首先在github创建一个空的仓库，然后根据相关提示信息，进行链接。

# 在当前项目中发布包
lerna publish

# lerna publish 永远不会发布标记为 private 的包（package.json中的”private“: true）

增加模块包到 packages 中指定项目下面是将 ui-web 模块增加到 example-web 项目中 lerna add antd-mobile --scope=module-2
在最外层运行里面制定的项目 lerna exec --scope module-2 -- yarn test
如果命令中不增加 --scope example-web直接使用下面的命令，这会在 packages 下所有包执行命令rm -rf ./node_modules lerna exec -- rm -rf ./node_modules
lerna list 显示所有的安装的包
lerna list --json 可以通过json的方式查看 lerna 安装了哪些包,json 中还包括包的路径，有时候可以用于查找包是否生效。
lerna clean 从所有包中删除 node_modules 目录
注意下 lerna clean 不会删除项目最外层的根 node_modules
vv

lerna常用的命令用法

基于 lerna 的多包项目建设与npm & unpkg 的发布（一）
增加两个 packages
- lerna create @mo-demo/cli
- lerna create @mo-demo/cli-shared-utils
分别给相应的package增加依赖模块
- lerna add chalk // 为所有 package 增加 chalk 模块
- lerna add semver --scope @mo-demo/cli-shared-utils // 为 @mo-demo/cli-shared-utils 增加 semver 模块
- lerna add @mo-demo/cli-shared-utils --scope @mo-demo/cli // 增加内部模块之间的依赖
发布
- lerna publish
lerna bootstrap --hoist
为某个 package 安装的包被放到了这个 package 目录下的 node_modules 目录下。这样对于多个 package 都依赖的包，会被多个 package 安装多次，并且每个 package 下都维护 node_modules ，也不清爽。于是我们使用 --hoist 来把每个 package 下的依赖包都提升到工程根目录，来降低安装以及管理的成本
为了省去每次都输入 --hoist 参数的麻烦，可以在 lerna.json 配置：
```
{
  "packages": [
    "packages/*"
  ],
  "command": {
    "bootstrap": {
      "hoist": true
    }
  },
  "version": "0.0.1-alpha.0"
}
```

lerna clean

lerna clean                           
info cli using local version of lerna
lerna notice cli v4.0.0
lerna info Removing the following directories:
lerna info clean packages/cli-shared-utils/node_modules
lerna info clean packages/cli/node_modules
lerna info clean packages/hello-world/node_modules
lerna info clean packages/module-1/node_modules
lerna info clean packages/module-2/node_modules
? Proceed? (ynH)

优雅的提交
- commitizen && cz-lerna-changelog
commitizen 是用来格式化 git commit message 的工具，它提供了一种问询式的方式去获取所需的提交信息. cz-lerna-changelog 是专门为 Lerna 项目量身定制的提交规范，在问询的过程，会有类似影响哪些 package 的选择。如下：

vim .git/COMMIT_EDITMSG 可以查看到 commitizen && cz-lerna-changelog 指定的项目

上面我们使用了 commitizen 来规范提交，但这个要靠开发自觉使用 npm run c 。万一忘记了，或者直接使用 git commit 提交怎么办？答案就是在提交时对提交信息进行校验，如果不符合要求就不让提交，并提示。校验的工作由 commitlint 来完成，校验的时机则由 husky 来指定。husky 继承了 Git 下所有的钩子，在触发钩子的时候，husky 可以阻止不合法的 commit,push 等等。

commitlint && husky

// 安装 commitlint 以及要遵守的规范
npm i -D @commitlint/cli @commitlint/config-conventional

// 安装 husky
npm i -D husky

// 在工程根目录为 commitlint 增加配置文件 commitlint.config.js 为commitlint 指定相应的规范
module.exports = { extends: ['@commitlint/config-conventional'] }

// 在 package.json 中增加如下配置
"husky": {
  "hooks": {
    "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
  }
}

"commit-msg"是git提交时校验提交信息的钩子，当触发时便会使用 commitlit 来校验。安装配置完成后，想通过 git commit 或者其它第三方工具提交时，只要提交信息不符合规范就无法提交。从而约束开发者使用 npm run c 来提交;

standardjs && lint-staged
除了规范提交信息，代码本身肯定也少了靠规范来统一风格
- standardjs就是完整的一套 JavaScript 代码规范，自带 linter & 代码自动修正。它无需配置，自动格式化代码并修正，提前发现风格以及程序问题。
- lint-staged staged 是 Git 里的概念，表示暂存区，lint-staged 表示只检查并矫正暂存区中的文件。一来提高校验效率，二来可以为老的项目带去巨大的方便。
```
// 安装
npm i -D standard lint-staged
```
```
// package.json
{
  "name": "root",
  "private": true,
  "scripts": {
    "c": "git-cz"
  },
  "config": {
    "commitizen": {
      "path": "./node_modules/cz-lerna-changelog"
    }
  },
  "husky": {
    "hooks": {
      "pre-commit": "lint-staged",
      "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
    }
  },
  "lint-staged": {
    "*.js": [
      "standard --fix",
      "git add"
    ]
  },
  "devDependencies": {
    "@commitlint/cli": "^8.1.0",
    "@commitlint/config-conventional": "^8.1.0",
    "commitizen": "^3.1.1",
    "cz-lerna-changelog": "^2.0.2",
    "husky": "^3.0.0",
    "lerna": "^3.15.0",
    "lint-staged": "^9.2.0",
    "standard": "^13.0.2"
  }
}
```
安装完成后，在 package.json 增加 lint-staged 配置，如上所示表示对暂存区中的 js 文件执行 standard --fix 校验并自动修复。那什么时候去校验呢，就又用到了上面安装的 husky ，husky的配置中增加pre-commit的钩子用来执行 lint-staged 的校验操作，如上所示。
此时提交 js 文件时，便会自动修正并校验错误。即保证了代码风格统一，又能提高代码质量。
自动生成日志
有了之前的规范提交，自动生成日志便水到渠成了。再详细看下 lerna publish 时做了哪些事情：
- lerna version
  - 找出从上一个版本发布以来有过变更的 package
  - 提示开发者确定要发布的版本号
  - 将所有更新过的的 package 中的package.json的version字段更新
  - 将依赖更新过的 package 的包中的依赖版本号更新
  - 更新 lerna.json 中的 version 字段
  - 提交上述修改，并打一个 tag
  - 推送到 git 仓库

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

lerna

lerna常用的命令用法

优雅的提交

自动生成日志