Qt项目持续集成系列之一 -- github自动化编译

持续集成的概念和好处，涛哥就不再赘述了。
本文的目标是，领各位读者入门，学会如何在GitHub上搭建Qt项目的自动化编译环境。
后续的文章还会有Qt项目的自动化测试、及多平台自动发行。

创建一个Qt工程

这里使用默认的HelloWorld模板。
文件结构如下：

为代码创建git仓库

使用命令行操作
git init
git add .
git commit –a –m “init version”

或者使用小乌龟(tortoiseGit)

在github上创建仓库

上传代码到github

使用命令行
git push https://github.com/yourpath/xxxxxxxxxxx master
或者小乌龟

使用Travis

travis是一个第三方的CI网站，提供linux和osx的docker环境，可以与github集成。
使用这个网站的docker，只需要在代码git仓库中放一个叫”.travis.yml”的配置文件即可，文件具体内容在下文中。

网址： https://travis-ci.org/
如果想知道更多关于travis的内容，访问帮助文档网址：https://docs.travis-ci.com/

需要先注册/登陆。默认用github账号就好了。

第一次使用会提示github账号认证之类的，通过就行了。

登陆成功后，进入仓库管理界面，点击那个加号

进入添加仓库界面，找到要添加的仓库HelloCI，打开开关。如果列表中没有仓库，可以点击左上角的Sync account进行同步，之后再去找仓库。

使用appveyor

appveyor是一个第三方的CI网站，提供windows的docker环境，可以与github集成。
使用这个网站的docker，只需要提供一个叫” appveyor.yml”的配置文件即可，文件具体内容在下文中。

网址：https://www.appveyor.com/
帮助文档网址：https://www.appveyor.com/docs/

登陆界面。这个网站用Github账号不一定能正常登陆，请自行尝试。
本人使用的是微软的Visual Studio Team 账号

登陆成功后，进入项目列表。点击上面的New Project进入添加项目页面。

选github标签，然后找到HelloCI，点击ADD按钮

添加成功了

添加CI配置文件

.travis.yml （后文有链接，可下载到）

travis默认系统为ubuntu，并提供一些基础的命令。但是没有安装Qt，这里通过ubuntu源进行安装，选择的版本为5.9.6。
关于ubuntu源 在这个网站上查看细节 https://launchpad.net/~beineri/+archive/ubuntu/

在搜索框输入想要的qt版本，查看是否有对应的源、如何使用

appveyor.yml

Appveyor比较方便一些，已经装好了各种版本的vs 和Qt，这里使用vs 14.0和qt 5.9.5 msvc2015_64
其它版本详情看这里https://www.appveyor.com/docs/windows-images-software/

后续的自动化测试、覆盖率统计、自动部署也是在这两个配置文件里实现，这次先不说了。

配置文件添加到仓库

通常为了方便查看CI状态，我们会写一个README.md的文件，里面链接上CI仓库和仓库对应的状态图标（专业名字叫badge）

上图四个红框依次编号1-4，那么

1是travis的小图标链接，在travis网站上，对应仓库里

点击那个小图标，在弹出的页面中，选择代码分支为master，格式为MardDown

（也可以仿照我提供的格式来写，我的那个是个表格的方式，看着更好一些）

2是travis仓库对应的链接

3是appveyor的状态图标，在appveyor的对应仓库中找到：

4是appveyor的对应仓库链接

添加好之后的文件结构

提交修改到github，触发CI

用命令行
git add .
git commit –a –m “add CI and README”
git push xxx master
或者小乌龟

提交好了，到github上看一看吧

这次提交已经触发了CI。
上图这四个按钮分别 对应前面的四个链接，可以点开查看状态。

状态图标里面显示的状态是默认的，等一段时间后(CI运行完成)，刷新即可看到最新的状态。

也可以在github 仓库的commit栏，点击CI状态按钮，来查看CI信息。

如果某一次提交不想触发CI，可以在commit信息中加上[SKIP CI]，例如
命令行： git commit -a -x “xxx [SKIP CI]”

小乌龟：

更多玩法，请参考CI网站，或等我后续的文章。

配置文件和示例仓库链接

https://github.com/wentaojia2014/HelloCI

关于我

---

作者	涛哥
开发理念	弘扬鲁班文化，传承工匠精神
QQ、TIM	759378563
微信	xsd2410421
邮箱	jared2020@163.com
blog	https://wentaojia2014.github.io/

---

QQ(TIM)、微信二维码

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

---