react-components-docs/bee-tools集成changelog使用方式.md

3.4 KiB
Raw Blame History

bee-tools集成changelog使用方式

1、安装Commitizen

Commitizen是一个格式化commit message的工具。 bee-tools 请更新到最新版本。【0.4.2】

npm install -g commitizen

npm install bee-tools/npm update bee-tools

2、初始化配置

如果你项目中已经安装了changelog忽略此步骤

在项目中执行  

bee-tools run changelogInit

3、带log的提交

完成上面2步骤后如果想生成带log的提交执行

git cz
....(参考git cz命令截图)。

4、发布上线

执行 bee-tools run pub
  1. 如果修改一次性把bug修复完毕且提交不用执行第3步骤,在执行pub是可以设置log。

  2. 如果分批提交且修改同一个bug生成多条log记录。需要在每次提交时执行git cz最后一次次可以直接执行。

     执行 bee-tools run pub
    
     1. please enter the package version to publish (should be xx.xx.xx) (1.0.2) //输入即将要发布的版本号
    
     2. do you wang run changelog ?(y/n) (y) // y或直接回车
    
     3. Select the type of change that you're committing: (Use arrow keys) // 选择本次修改的类型。
      feat:     A new feature
       fix:      A bug fix
       docs:     Documentation only changes
       style:    Changes that do not affect the meaning of the code (white-space, formatting, missing semi
     -colons, etc)
       refactor: A code change that neither fixes a bug nor adds a feature
       perf:     A code change that improves performance
       test:     Adding missing tests or correcting existing tests
    
    
    
     4. What is the scope of this change (e.g. component or file name)? (press enter to skip) //输入描述(50字以内)
    
     eg: > 本次修复了弹出框的问题。
    
     5. Write a short, imperative tense description of the change: //
    
     eg: > 请参考issues中回复。
    
     6. Provide a longer description of the change: (press enter to skip)
    
     eg: > 回车
    
     7. Are there any breaking changes?
    
     eg: > y
    
     8. Describe the breaking changes
     eg: > 1. 修改了弹出框的问题。
           2. 修复了xx问题。
    
     9. Does this change affect any open issues? (y/N)
    
     eg: > y
    
     10. Add issue references (e.g. "fix #123", "re #123".):
    
     Closes #x //issues 的编号
    

如果确定修改完毕执行发布命令在发布命令中会让你输入是否是否再次生成log 的提交。(可选)

5、关闭issues

  Closes issues编号
  egCloses #8

6、git cz 命令截图

7、效果截图

注解

用来标识 commit 的类型,总共有以下 11 个标识:

feat: 添加了一个新功能
fix: 修复了一个 bug
docs: 文档发生修改
style: 不影响代码运行的更改(空格,格式,缺少分号等)
refactor: 重构代码且不引进新的功能或修复 bug
perf: 代码优化
test: 添加或修改测试用例
build: 构建工具或外部依赖的更改npmwebpackgulp等
ci: 更改项目级的配置文件或脚本
chore: 除上述之外的修改
revert: 撤销改动先前的提交