Android项目基于flow.ci+fir.im+github的持续化集成实例

本文链接：https://blog.csdn.net/ying_114/article/details/72638203

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.准备工作

2.操作步骤

(1)进入flow.ci首页：创建项目

(2)关联github账号（其他平台同理），选择项目，点击创建

关联账号，选择项目

正在构建
(3)选择语言

(4)设置工作流

1) 触发器：提供了根据事件触发打包的Hook，包括Push、Pull、Tag操作，也可以设置几个定时任务，比如每天下班后执行一次打包。
2) 初始化：提供了初始化时候显示的一些信息，同时为一些编译时候的变量进行赋值，下方提供了自定义输出的模板可供选择。
3) Git仓库克隆：即服务器 git clone 操作。
4) 缓存：即pod安装包依赖，可以选择启用缓存，那么flow.ci只会在第一次的时候添加依赖(pod install)之后编译就继续使用第一次打包的pod文件。
5) 编译：即编译时候的一些变量，大部分出错是在这里设置错了，在自动化打包的时候会有对应的提示信息。
6) 完成后：提供了Email和slack等提醒方式，你可以选择在成功或者是失败的情况下发送邮件到指定邮箱。

大多数情况下会添加以下两个插件：
infer代码质量检测工具：帮助我们检查代码中的错误，减少 codereview 花费的时间，增强代码的可维护性。（不是必须的）
添加代码质量检测插件

fir.im上传插件：

需要配置参数：
参数配置
fir.im账户中的API token位置

FLOW_FIR_API_TOKEN：即fir.im右上角账户中的API token
FLOW_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路径）

当然，其他插件可以按照需求添加

完成后：构建结果会发送到所填联系方式中
填入信息

(5) 成员

可以添加成员共同协作

(6)上传证书和授权

进入设置页面：
上传证书

1)项目配置flow.ci的环境变量
首先安卓项目中生成keystore

FLOW_ALIAS_NAME 对应项目 build.gradle 里的 keyAlias
FLOW_ALIAS_PASS 对应项目build.gradle里的 keyPassword
FLOW_KEYSTORE_PASS 对应项目build.gradle里的 storePassword
FLOW_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.properties
         Properties 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.jks
storePassword=fir.im
keyAlias=fir.im
keyPassword=fir.im

3)生成release签名apk

使用gradle的 assembleRelease 命令来打包生成release-sign.apk

(7)构建

回到构建列表进行构建，可以手动构建或者通过push、tag等方式出发构建

构建过程：

构建成功后回到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/51907728

2) Error:一直运行在assembleRelease处：

一直运行在assembleRelease处