Android项目基于flow.ci+fir.im+github的持续化集成实例
一.概念描述
什么是持续化集成?
持续集成:Continuous Integration,简称CI,意思是,在一个项目中,任何人对代码库的任何改动,都会触发CI服务器自动对项目进行构建,自动运行测试,甚至自动部署到测试环境。这样做的好处就是,随时发现问题,随时修复。因为修复问题的成本随着时间的推移而增长,越早发现,修复成本越低。
Flow.ci是什么?
flow.ci 不只是持续集成,持续部署的工具,也帮助我们用自动化的视角审视手头繁琐的工作,将更多的时间用在新鲜事物上。
CI(Continuous Integration)意为 “持续整合”,指代码的持续测试及与其他代码修改的整合与归并。
fir.im是什么?
「fir.im」是国内首家为移动开发者提供 App 免费托管分发服务的平台,为移动开发者提供极速测试发布、崩溃收集分析、用户反馈收集等一系列开发测试效率工具服务,能够让开发者更专注于产品开发与优化。
GitHub是什么?
GitHub 是一个面向开源及私有软件项目的托管平台
二.详细流程
1.准备工作
注册[flow.ci](https://flow.ci)账号注册[fir.im](https://fir.im)账号注册[github](https://github.com)账号,并上传安卓项目####2.操作步骤(1)进入flow.ci首页:创建项目![创建项目](http://img.blog.csdn.net/20170523095550608?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)(2)关联github账号(其他平台同理),选择项目,点击创建![关联账号,选择项目](http://img.blog.csdn.net/20170523100349972?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)![正在构建](http://img.blog.csdn.net/20170523100522910?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)(3)选择语言![选择语言](http://img.blog.csdn.net/20170523100859865?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)(4)设置工作流![工作流](http://img.blog.csdn.net/20170523101044772?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)----------1) 触发器:提供了根据事件触发打包的Hook,包括Push、Pull、Tag操作, 也可以设置几个定时任务,比如每天下班后执行一次打包。2) 初始化:提供了初始化时候显示的一些信息,同时为一些编译时候的变量进行赋值,下方提供了自定义输出的模板可供选择。3) Git仓库克隆:即服务器 git clone 操作。4) 缓存:即pod安装包依赖,可以选择启用缓存,那么flow.ci只会在第一次的时候添加依赖(pod install)之后编译就继续使用第一次打包的pod文件。5) 编译:即编译时候的一些变量,大部分出错是在这里设置错了,在自动化打包的时候会有对应的提示信息。6) 完成后:提供了Email和slack等提醒方式,你可以选择在成功或者是失败的情况下发送邮件到指定邮箱。----------大多数情况下会添加以下两个插件:infer代码质量检测工具:帮助我们检查代码中的错误,减少 codereview 花费的时间,增强代码的可维护性。(不是必须的)![添加代码质量检测插件](http://img.blog.csdn.net/20170523101517431?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)fir.im上传插件:![fir.im上传插件](http://img.blog.csdn.net/20170523101722213?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)需要配置参数:![参数配置](http://img.blog.csdn.net/20170523101911980?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)![fir.im账户中的API token位置](http://img.blog.csdn.net/20170523095420496?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)FLOW_FIR_API_TOKEN:即fir.im右上角账户中的API tokenFLOW_FIR_CHANGELOG:可填写显示在 fir.im 下载页面的更新日志FLOW_FIR_APP_PATH:是生成的apk相对于项目的相对路径;假如项目 A的lib文件夹下有 test.apk,那么 FLOW_FIR_APP_PATH就是 lib/test.apk,默认不用填写会去查找项目下的apk,优先 release 再者 debug. 此处一般写:app/build/outputs/apk/app-release.apk(gradle的 assembleRelease 命令生成的apk路径)----------当然,其他插件可以按照需求添加----------完成后:构建结果会发送到所填联系方式中![填入信息](http://img.blog.csdn.net/20170523102444912?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)(5) 成员可以添加成员共同协作![添加成员](http://img.blog.csdn.net/20170523102939298?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)(6)上传证书和授权进入设置页面:![上传证书](http://img.blog.csdn.net/20170523103233893?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)1)项目配置flow.ci的环境变量首先安卓项目中生成keystoreFLOW_ALIAS_NAME 对应项目 build.gradle 里的 keyAliasFLOW_ALIAS_PASS 对应项目build.gradle里的 keyPasswordFLOW_KEYSTORE_PASS 对应项目build.gradle里的 storePasswordFLOW_CERTIFICATE_FILE 对应项目build.gradle里的 storeFile保存后点击下方授权按钮2)项目 build.gradle设置build.gradle配置是非常灵活的,大家可以自己写适合自己的脚本,来实现不同的证书使用的方法,这里只是给出一个思路。>这里我们利用 property,将本地的密码和签名文件路径信息保存在项目根目录的 local.properties 文件里,因为这个文件一般都在 .gitignore 里自动配置了,所以不会上传到代码仓库,这样当本地打包apk时自动查找 local.properties 里的证书配置,在 flow.ci 在构建时是因为不存在 local.property ,所以会通过 System.getenv() 方法来获取 flow.ci 生成的环境变量的方式加载证书的信息,从而实现了 本地 以及 flow.ci 的不同编译环境里的证书配置。>----------在项目的 build.gradle 配置(仅供参考)```android {...defaultConfig {...}signingConfigs {release {// default keystore file, PLZ config file path in local.propertiesProperties properties = new Properties()//加载本地local.properties文件if(rootProject.file("local.properties").exists()) {properties.load(rootProject.file("local.properties").newDataInputStream())}storeFile file(properties.get("storeFile") ?: System.getenv("FLOW_CERTIFICATE_FILE"))storePassword properties.get("storePassword") ?: System.getenv("FLOW_KEYSTORE_PASS")keyAlias properties.get("keyAlias") ?: System.getenv("FLOW_ALIAS_NAME")keyPassword properties.get("keyPassword") ?: System.getenv("FLOW_ALIAS_PASS")}}buildTypes {release {...signingConfig signingConfigs.release}}...}```根目录里的local.properties文件中配置以下内容(没有就创建一个新的):```...storeFile=/Users/cape/FlowTest/app/FIR.im.jksstorePassword=fir.imkeyAlias=fir.imkeyPassword=fir.im```3)生成release签名apk使用gradle的 assembleRelease 命令来打包生成release-sign.apk(7)构建回到构建列表进行构建,可以手动构建或者通过push、tag等方式出发构建![构建](http://img.blog.csdn.net/20170523103809537?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)构建过程:![构建过程](http://img.blog.csdn.net/20170523103838292?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)构建成功后回到fir.im主页。我的应用中即可看到生成的apk信息。点击预览即可看到生成的二维码。即可实现每次代码提交,便自动构建生成apk。(8)可能遇到的问题1) Error:This version of android studio is incompatible with the gradle version used.解决办法:http://blog.csdn.net/sinat_15417921/article/details/519077282) Error:一直运行在assembleRelease处:![一直运行在assembleRelease处](http://img.blog.csdn.net/20170523104314430?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)解决办法:自定义脚本代替原有的编译:![自定义脚本](http://img.blog.csdn.net/20170523104640787?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)3) Error:构建时出现Lint(Android代码扫描工具)错误:![Lint(Android代码扫描工具)错误](http://img.blog.csdn.net/20170523105018309?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)解决办法:![Lint(Android代码扫描工具)错误解决办法](http://img.blog.csdn.net/20170523105135825?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)4) Error:![fir.im未授权](http://img.blog.csdn.net/20170523105337625?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)解决办法:此错误是因为fir.im未授权。在fir.im插件中FLOW_FIR_API_TOKEN:填入fir.im右上角账户中的API token即可![这里写图片描述](http://img.blog.csdn.net/20170523105553612?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQveWluZ18xMTQ=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)##三.其他####1.关于fir.im与flow.ci:暂时每日下载量和构建量有限制;暂时不收费####2.其他方法举例:基于Travis CI搭建Android持续集成以及自动打包发布流程//www.greatytc.com/p/6dba7d6f79ffJenkins+GitHub+Xcode+fir搭了一个持续集成环境http://xuanyiliu.com/2016/09/22/Jenkins+GitHub+Xcode+fir/jenkins+github+gradle 实现android自动化打包全攻略(MAC版)http://blog.csdn.net/u011904605/article/details/54604851Android 自动化打包实践 gradle打包并推送到git远程库//www.greatytc.com/p/9eaefefddde8####3.关于持续化集成只是初次接触,以后需要更深的了解。