Qt项目持续集成系列之-github自动化编译 | 涛哥的博客jaredtao.github.io


当你还在折腾虚拟机、安装Qt环境的时候,涛哥已经写完了代码,并利用CI完成自动编译、自动发行Windows、MacOS、Ubuntu等多个平台的发布包。。。

持续集成的概念和好处,涛哥就不再赘述了。

本文的目标是,领各位读者入门,学会如何在GitHub上搭建Qt项目的自动化编译环境。

后续的文章还会有Qt项目的自动化测试、及多平台自动发行。


1、 创建一个Qt工程




github自动化打包ios github自动编译_github自动化打包ios


这里使用默认的HelloWorld模板。

文件结构如下:


github自动化打包ios github自动编译_github自动化打包ios_02


为代码创建git仓库

使用命令行操作

git init

git add .

git commit –a –m “init version”

或者使用小乌龟(tortoiseGit)


github自动化打包ios github自动编译_github_03


2 在github上创建仓库


github自动化打包ios github自动编译_qt creator 帮助文档_04


3 上传代码到github

使用命令行

git push https://github.com/yourpath/xxxxxxxxxxx master

或者小乌龟


github自动化打包ios github自动编译_github_05


github自动化打包ios github自动编译_github自动化打包ios_06


4 使用Travis

travis是一个第三方的CI网站,提供linux和osx的docker环境,可以与github集成。

使用这个网站的docker,只需要在代码git仓库中放一个叫”.travis.yml”的配置文件即可,文件具体内容在下文中。

网址: https://travis-ci.org/

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

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


github自动化打包ios github自动编译_github自动化打包ios_07


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

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


github自动化打包ios github自动编译_qt creator 帮助文档_08


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


github自动化打包ios github自动编译_qt creator 帮助文档_09


github自动化打包ios github自动编译_git_10


5 使用appveyor

appveyor是一个第三方的CI网站,提供windows的docker环境,可以与github集成。

使用这个网站的docker,只需要提供一个叫” appveyor.yml”的配置文件即可,文件具体内容在下文中。

网址:https://www.appveyor.com/

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


github自动化打包ios github自动编译_github_11


登陆界面。这个网站用Github账号不一定能正常登陆,请自行尝试。

本人使用的是微软的Visual Studio Team 账号


github自动化打包ios github自动编译_git_12


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


github自动化打包ios github自动编译_qt creator 帮助文档_13


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


github自动化打包ios github自动编译_github_14


添加成功了


github自动化打包ios github自动编译_qt sqlite mac 编译配置_15


6 添加CI配置文件

.travis.yml (后文有链接,可下载到)


github自动化打包ios github自动编译_git_16


travis默认系统为ubuntu,并提供一些基础的命令。但是没有安装Qt,这里通过ubuntu源进行安装,选择的版本为5.9.6。

关于ubuntu源 在这个网站上查看细节 https://launchpad.net/~beineri/+archive/ubuntu/


github自动化打包ios github自动编译_qt sqlite mac 编译配置_17


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


github自动化打包ios github自动编译_git_18


appveyor.yml


github自动化打包ios github自动编译_github_19


Appveyor比较方便一些,已经装好了各种版本的vs 和Qt,这里使用vs 14.0和qt 5.9.5 msvc2015_64

其它版本详情看这里https://www.appveyor.com/docs/windows-images-software/

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

配置文件添加到仓库


github自动化打包ios github自动编译_git_20


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


github自动化打包ios github自动编译_github自动化打包ios_21


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

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


github自动化打包ios github自动编译_qt sqlite mac 编译配置_22


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


github自动化打包ios github自动编译_github_23


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

2是travis仓库对应的链接

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


github自动化打包ios github自动编译_github自动化打包ios_24


4是appveyor的对应仓库链接

添加好之后的文件结构


github自动化打包ios github自动编译_github自动化打包ios_25


7 提交修改到github,触发CI

用命令行

git add .
git commit –a –m “add CI and README”
git push xxx master

或者小乌龟


github自动化打包ios github自动编译_qt creator 帮助文档_26


github自动化打包ios github自动编译_git_27


github自动化打包ios github自动编译_qt sqlite mac 编译配置_28


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


github自动化打包ios github自动编译_qt sqlite mac 编译配置_29


这次提交已经触发了CI。

上图这四个按钮分别 对应前面的四个链接,可以点开查看状态。

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

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


github自动化打包ios github自动编译_github自动化打包ios_30


如果某一次提交不想触发CI,可以在commit信息中加上[SKIP CI],例如

命令行: git commit -a -x “xxx [SKIP CI]”

小乌龟:


github自动化打包ios github自动编译_git_31


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

8 配置文件和示例仓库链接

https://github.com/jaredtao/HelloCI

9 关于我

作者涛哥

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

blog https://jaredtao.github.io