使用jenkins自动化构建android和ios应用

zhwz

背景
　　随着业务需求的演进，工程的复杂度会逐渐增加，自动化的践行日益强烈。事实上，工程的自动化一直是我们努力的目标，能有效提高我们的生产效率，最大化减少人为出错的概率，实现一些复杂的业务需求应变。
　　场景如下，公司现在的测试人员每次需要测试新版本，都需要开发人员打包，放到ftp，测试人员然后从ftp上拷贝到本地（或者用手机的ES文件管理器），再安装。尤其临近发版的一周，几乎每天都要新版本。这样的话，有两方面的影响：第一，打断了开发人员的开发进度；第二，开发人员打包效率低下，尤其是ios，不顺的话，总是打的不对（可能是证书的问题）。
　　要解决这个问题，必须实现移动端应用的自动化构建。具体说来就是，使用持续集成（CI）系统jenkins，自动检测并拉取最新代码，自动打包android的apk和ios的ipa，自动上传到内测分发平台蒲公英上。（接下来，测试人员只要打开一个（或多个）固定的网址，扫描一下二维码，就能下载最新的版本了…）

环境
　　因为要编译ios，所以选择Mac OSX 10.11.1。
　　无论是哪个操作系统，jenkins的配置是一样的。

安装Jenkins
　　官网地址：http://jenkins-ci.org/

// 使用brew安装
brew install jenkins
// 启动，直接运行jenkins即可启动服务
jenkins　　默认访问http://localhost:8080/, 可进入jenkins配置页面。

安装Jenkins相关插件
　　点击系统管理>管理插件>可选插件，可搜索以下插件安装

　　git插件(GIT plugin)
　　ssh插件(SSH Credentials Plugin)
　　Gradle插件(Gradle plugin) - android专用
　　Xcode插件(Xcode integration) - ios专用

新建Job
　　主页面，新建 -> 构建一个自由风格的软件项目即可。
　　对于类似的项目，可以选择 -> 复制已有的Item，要复制的任务名称里输入其他job的首字符会有智能提示。

配置git仓库
　　如果安装了git插件，在源码管理会出现Git，选中之后：
　　Repositories -> https://github.com/openproject/ganchai, 如果是ssh还要配置Credentials。
　　Branch -> */master，选定一个要编译的分支代码。
　　如下：

　　如果是私有的仓库（比如git://xxxxx.git）,点击Credentials - Add，弹出对话框，配置sshkey最简单了：

配置自动拉取最新代码
　　在构建触发器中，有两种自动拉取代码并编译的策略:

• 设置Poll SCM，设置定时器，定时检查代码更新，有更新则编译，否则不编译（我暂时用的是这个）。
  
  
  
  
• 也可以设置Build periodically，周期性的执行编译任务。
  
  
  

　　关于定时器的格式，我只能从网上摘抄一段稍微靠谱一点的说明：
　　

This field follows the syntax of cron (with minor differences). Specifically, each line consists of 5 fields separated by TAB or whitespace:　　

　　
MINUTE HOUR DOM MONTH DOW
　　

　　
MINUTE Minutes within the hour (0-59)
　　
HOUR The hour of the day (0-23)
　　
DOM The day of the month (1-31)
　　
MONTH The month (1-12)
　　
DOW The day of the week (0-7) where 0 and 7 are Sunday.
　　

　　
To specify multiple values for one field, the following operators are available. In the order of precedence,
　　

　　* '*' can be used to specify all valid values.
　　* 'M-N' can be used to specify a range, such as "1-5"
　　* 'M-N/X' or '*/X' can be used to specify skips of X''s value through the range, such as "*/15" in the MINUTE field for "0,15,30,45" and "1-6/2" for "1,3,5"
　　* 'A,B,...,Z' can be used to specify multiple values, such as "0,30" or "1,3,5"
　　

　　
Empty lines and lines that start with '#' will be ignored as comments.
　　
In addition, @yearly, @annually, @monthly, @weekly, @daily, @midnight, @hourly are supported.
　　

　　

　　举两个例子：

// every minute
* * * * *
// every 5 mins past the hour
5 * * * *
配置gradle - android专用
　　请ios的朋友们请飘过.
　　如果安装gradle插件成功的话，应该会出现下图的Invoke Gradle script，配置一下:

　　${WORKSPACE}表示当前job下的workspace目录，主要是存放代码。更多的环境变量请参考文末附录。
　　这样，就能自动在project下的app的build/outputs/apk下生成相应的apk.
　　编译失败？可能要解决以下2个问题：

• 　　gradle没配置环境变量。
  　　比如我在/etc/profile中配置一下GRADLE_HOME:
  
  export GRADLE_HOME='/home/jay/.gradle/wrapper/dists/gradle-2.2.1-all/c64ydeuardnfqctvr1gm30w53/gradle-2.2.1'
  export PATH=$GRADLE_HOME/bin:$PATH
  
• 　　找不到local.properties中sdk定义。
  　　因为一般来说local.properties不会添加到版本库。
  　　所以需要手动copy到${WORKSPACE}下的Project目录下（可参考自己Android Studio工程结构）。
  　　关于local.properties的定义，这里记录一下，做个备份：
  
  sdk.dir=xx/xx/android-sdk
  

　　再编译一般就会编译成功，当然当那些第三方库需要重新下载的话，编译可能会很慢。

配置xcode - ios专用
　　请android的同学们飘过。
　　安装Xcode插件后，可看到如下图界面，并配置：

　　这里有两个地方需要注意。

• 签名
  
• 需要Shared Schema文件.
  

上传到蒲公英平台
　　在官网文档里有说明，通过linux平台上传app的关键代码

curl -F "file=@/tmp/example.ipa" -F "uKey=" -F "_api_key=" http://www.pgyer.com/apiv1/app/upload　　具体来说，

# 先把${version}看成v1.0吧
curl -F "file=@/home/xxx/release/ganchai-release-${version}-0101-dev.apk" -F "uKey=231xxxxe6" -F "_api_key=0xxxx499" -F "publishRange=2" http://www.pgyer.com/apiv1/app/upload　　这样就完成一个app上传到蒲公英了。
　　实际上，我们可能会面对更复杂的场景，比如上面的${version}, 而version定义于build.gradle如下：

ext {
    compileSdkVersion = 22
    buildToolsVersion = "23.0.1"
    minSdkVersion = 10
    targetSdkVersion = 22
    versionCode = 1111
    versionName = "v1.2.0.0"
}　　得想办法读到versionName, 然后拼出最终的文件名，这样下次版本升级了之后也能动态的上传app到蒲公英了。

# 使用sed命令读取，使用cut切割，最终动态读取到versionName
version=`sed -n '21,1p' ${WORKSPACE}/xxx/build.gradle | cut -c20-27`　　这是android的apk上传过程，相应的，ios是上传ipa，方法是一样的，不再赘述。

小结
　　把开发人员发布版本的工作自动化之后，如此一来，方便了测试人员随时拉取并构建最新版本，更解放了开发人员自己的发版本的工作，一个字，善！

附录
　　jenkins中定义的那些环境变量：
　　

The following variables are available to shell scripts　　

　　
BUILD_NUMBER
　　
The current build number, such as "153"
　　
BUILD_ID

　　
The current build>　　
BUILD_DISPLAY_NAME
　　
The display name of the current build, which is something like "#153" by default.
　　
JOB_NAME
　　
Name of the project of this build, such as "foo" or "foo/bar". (To strip off folder paths from a Bourne shell script, try: ${JOB_NAME##*/})
　　
BUILD_TAG

　　
String of "jenkins-${JOB_NAME}-${BUILD_NUMBER}". Convenient to put into a resource file, a jar file, etc for easier>　　
EXECUTOR_NUMBER

　　
The unique number that>　　
NODE_NAME
　　
Name of the slave if the build is on a slave, or "master" if run on master
　　
NODE_LABELS
　　
Whitespace-separated list of labels that the node is assigned.
　　
WORKSPACE
　　
The absolute path of the directory assigned to the build as a workspace.
　　
JENKINS_HOME
　　
The absolute path of the directory assigned on the master node for Jenkins to store data.
　　
JENKINS_URL
　　
Full URL of Jenkins, like http://server:port/jenkins/ (note: only available if Jenkins URL set in system configuration)
　　
BUILD_URL
　　
Full URL of this build, like http://server:port/jenkins/job/foo/15/ (Jenkins URL must be set)
　　
JOB_URL
　　
Full URL of this job, like http://server:port/jenkins/job/foo/ (Jenkins URL must be set)
　　
SVN_REVISION
　　
Subversion revision number that's currently checked out to the workspace, such as "12345"
　　
SVN_URL
　　
Subversion URL that's currently checked out to the workspace.