Qt项目持续集成系列之二 -- github自动化发行

上一篇文章在这

https://www.jianshu.com/p/2975b82f5360

本文的目标是，在github上实现Qt工程的自动化发行。

看个预览图先:

上图所示github的Release中，包含了两个macos平台的dmg包、5个windows平台的zip包以及一个ubuntu平台的包，都是自动化发行的结果。

后续会加入Android和ios包。

1、Appveyor的配置

前一篇文章中已经介绍过，Appveyor网站提供了windows的Docker镜像，包含各种版本的visual studio和Qt，这里通过yml配置文件，来使用这些镜像。

先是通过一个矩阵来配置不同的镜像

matrix之下，每一个‘-’号开头的一段描述，都代表一个镜像的配置。

其中APPVEYOR_BUILD_WORKER_IMAGE是网站提供的环境变量，用来指定Docker镜像。

platform、 qt以及releaseName是我自定义的变量，用来在后文中执行脚本时做区分

before_build脚本，就是编译之前要执行的脚本，默认使用windows的cmd语法，当然也可以使用Powershell等。

我这段脚本目的是，在编译之前，先确认要使用的vs编译器和Qt所在路径。

vs一般通过调用vcvarsall.bat脚本，并传入x86或x64等参数，来确定相应的编译器和链接器，如cl.exe、nmake.exe等。

Qt的使用，是将QTDIR\bin设置到环境变量PATH中，以便可以找到qmake.exe。

有了正确的环境设置，接下来就是编译了，很简单的qmake make

编译通过后，有一个after_build的脚本执行时机，此时的环境变量和前面一样。

我这段脚本目的是，在代码被打上tag的情况下，执行windeployqt命令，将依赖的Qt库都打包到一起。

APPVEYOR_REPO_TAG是Docker提供的环境变量，有tag的时候这个变量的值为true。

artifacts用来描述可以发行的代码包，这里指定了bin路径，则Docker会自动将bin路径打包为zip，zip的名字是指定的name。

deploy用来描述要发行的目标网站。

这里的provider指定为github，就可以使用github的Release功能了。当然还有很多其它的网站也可用来发行。

auth_token是从github上生成的验证用的token，后面再说如何生成。为了不让别人看到具体token，这里引用了自定义的环境变量GITHUB_OAUTH_TOKEN

on：

APPVEYOR_REPO_TAG: true

表示只有在代码被打上tag的时候，才执行deploy。

这里的deploy没有指定artifacts，默认会把定义的artifacts都发行出去，这就够了。

最终的yml配置文件

appveyor.yml

version: '{build}'branches: except: - project/travisenvironment: matrix: - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015

    platform: x86

    qt: 5.9    releaseName: HelloCI_qt59_vs2015_x86

  - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015

    platform: x64

    qt: 5.9    releaseName: HelloCI_qt59_vs2015_x64

  - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017

    platform: x64

    qt: 5.9    releaseName: HelloCI_qt59_vs2017_x64

  - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015

    platform: x64

    qt: 5.12    releaseName: HelloCI_qt512_vs2015_x64

  - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017

    platform: x64

    qt: 5.12    releaseName: HelloCI_qt512_vs2017_x64before_build:  - if "%APPVEYOR_BUILD_WORKER_IMAGE%"=="Visual Studio 2015" set msvc=msvc2015

  - if "%APPVEYOR_BUILD_WORKER_IMAGE%"=="Visual Studio 2015" set vs=C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC

  - if "%APPVEYOR_BUILD_WORKER_IMAGE%"=="Visual Studio 2017" set msvc=msvc2017

  - if "%APPVEYOR_BUILD_WORKER_IMAGE%"=="Visual Studio 2017" set vs=C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build

  - if "%platform%"=="x86" set QTDIR=C:\Qt\%qt%\%msvc%

  - if "%platform%"=="x64" set QTDIR=C:\Qt\%qt%\%msvc%_64

  - set PATH=%PATH%;%QTDIR%\bin;

  - if "%platform%"=="x86" set vcvarsall=%vs%\vcvarsall.bat

  - if "%platform%"=="x64" set vcvarsall=%vs%\vcvarsall.bat

  - if "%platform%"=="x86" call "%vcvarsall%" x86

  - if "%platform%"=="x64" call "%vcvarsall%" x64build_script:  - qmake

  - nmakeafter_build:  - if "%APPVEYOR_REPO_TAG%"=="true" windeployqt bin\HelloCI.exe --qmldir %QTDIR%\qmlartifacts:  - path: bin

    name: $(releaseName)deploy:  provider: GitHub

  auth_token: $(GITHUB_OAUTH_TOKEN)

  description: 'HelloCI Release'  draft: false  prerelease: false  on:      APPVEYOR_REPO_TAG: true

2、 Travis

Travis网站有两个，https://travis-ci.org 和https://travis-ci.com， 区别是https://travis-ci.com可以操作github的私有仓库。

同样的，先看一下矩阵，这里配置了两个osx系统和一个ubuntu系统。

os:linux

dist: xenial

这是ubuntu16.04的配置（目前还不支持18.04 bionic）

env中自定义了一些环境变量，后面用到

cache是用来缓存的，这里指定了Qt的安装路径，那么在下一次同样的Docker镜像启动时，优先使用缓存，除非没有安装或者有新版本才会去更新这个路径。这样可以节省大量的Docker运行时间哦。

os: osx

  osx_image: xcode10.2

这是macos系统的设置，osx_image是travis提供的，可在其文档中找到其它可用版本

https://docs.travis-ci.com/user/reference/osx/

缓存也是要有的。

osx系统通过brew安装Qt，只需要一条命令即可 brew install qt，按照brew官网https://brew.sh/的描述，目前安装的版本为5.12.2

涛哥试过后，发现安装路径是/usr/local/Cellar/qt/5.12.2/

ubuntu系统安装Qt，上一篇文章也说过了，是通过launchpad源，目前已经有了最新的5.12.2和5.12.3了。

3、OAuth token

OAuth机制，是在不知道密码的情况下，只通过授权的token去访问特定的api。

使用token大致步骤：

接下来要去两个地方粘贴，最好先贴到记事本或着什么地方，备用。

先到Travis的项目配置页面

Name写前面的yml配置文件中引用的变量名GITHUB_OAUTH_TOKEN,value就是前面的token

接下来是Appveyor

一样的东西，填好后保存即可。

最后，给代码打上tag，提交吧。

涛哥在连续提交了50多次后。。。

最终拿到了这两个徽章

还有这正确的发布包。

（ubuntu那个，缺少linuxdeployqt打包步骤，后面再加）

当然，你们不用像我一样提交50多次，你们可以直接用我写好的配置文件。

最后附上GitHub链接

https://github.com/wentaojia2014/HelloCI

## 转载声明

[文章出自涛哥的博客 -- 点击这里查看涛哥的博客](https://wentaojia2014.github.io/)

本作品采用 [知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议](http://creativecommons.org/licenses/by-nc-sa/4.0/)进行许可, 转载请注明出处, 谢谢合作 © [涛哥](https://wentaojia2014.github.io/)

### 联系方式

***

| 作者 | 涛哥                          |

| ---- | -------------------------------- |

|开发理念 |  弘扬鲁班文化，传承工匠精神 |

| 博客 | https://wentaojia2014.github.io |

| 知乎 | https://www.zhihu.com/people/wentao-jia |

| 邮箱 | jared2020@163.com  |

| 微信 | xsd2410421                      |

| QQ  | 759378563                  |

***

请放心联系我，乐于提供咨询服务，也可洽谈有偿技术支持相关事宜。

#### **打赏**



***

觉得分享的内容还不错, 就请作者喝杯奶茶吧~~

***