简介
在前端开发过程中,我们经常会需要自动化打包和构建项目。而在这个过程中,版本号的管理也是非常重要的一环。npm 包 @janslow/ci-build-version 就是为了解决这个问题而存在的。@janslow/ci-build-version 可以帮助我们自动生成版本号,并且支持多种 CI 工具。
安装
首先需要在项目目录下安装 @janslow/ci-build-version:
npm install @janslow/ci-build-version --save-dev
CI 工具
@janslow/ci-build-version 支持以下 CI 工具:
- Travis CI
- CircleCI
- Jenkins
- GitLab CI
不同的 CI 工具需要不同的配置,下面我们分别说明。
Travis CI 配置
对于 Travis CI,我们需要在 .travis.yml 文件中增加以下内容:
before_install: - npm install -g @janslow/ci-build-version script: - var version=$(ci_build_version --travis) - echo $version
其中 --travis
参数告诉 @janslow/ci-build-version,项目是在 Travis CI 上运行的。
CircleCI 配置
对于 CircleCI,我们需要在 config.yml 文件中增加以下内容:
-- -------------------- ---- ------- - ---- ----- ------- ---------------- -------- ---- -------- -------- --------------------------- - ------------------- - ---- ----- ------- ---------------- -------- ------ --- -- ----------------- -- ------------ -- ------- -- ------------------------------------ -- ------------------------------------ -- -------------------- --------------------- ----------------- -- -- ---- - -- ------------------------- -- ----- ---------------------------- -- ---- ---------------------------- ------- ------- - ---- ----- --- ------- -------- -------------------------- ----------- - ---- ----- ---- ------- -------- ---- -------- - ---- ----- --- ------- -------- ---- -------------------------- - -----------------
CircleCI 配置较为复杂,涉及到使用 Docker 容器,不做过多解释。
Jenkins 配置
对于 Jenkins,我们需要在 Jenkinsfile 文件中增加以下内容:
def version = sh(script: 'ci_build_version --jenkins', returnStdout: true).trim() echo "version: $version"
GitLab CI 配置
对于 GitLab CI,我们需要在 .gitlab-ci.yml 文件中增加以下内容:
-- -------------------- ---- ------- ------- - ----- ------ ------ --------------- -------------- - --- ------- -- ------------------------- ------- - -------------------------- ----------- - ---- --------
使用
@janslow/ci-build-version 支持多种参数,这里只介绍一些常用的参数。更多参数请查看 npm 官方文档。以下是常用的几个参数:
--major
表示生成 major 版本:
ci_build_version --major --travis
--minor
表示生成 minor 版本:
ci_build_version --minor --travis
--patch
表示生成 patch 版本:
ci_build_version --patch --travis
示例代码
# .travis.yml before_install: - npm install -g @janslow/ci-build-version script: - var version=$(ci_build_version --travis) - echo $version
总结
@janslow/ci-build-version 是一个非常好用的 npm 包,可以帮助我们自动生成版本号,并且支持多种 CI 工具。在项目中使用 @janslow/ci-build-version,可以让我们更加专注于代码的开发,而不用再担心版本号的麻烦。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60066bc4967216659e244350