上篇文章跟大家分享了在Windows上安装Jenkins的方法,这篇文章来跟大家分享一下利用Jenkins自动化构建Android项目:
一、所需准备:
- Android项目上传至版本管理平台,这里我准备了Github上的Android项目https://github.com/onestravel/WebView404Example.git
-
配置Android SDK环境变量
参考上篇文章,我们进入 系统管理 -> 系统设置 ,选择环境变量,进行增加
输入 键:ANDROID_HOME
输入 值:D:\android\sdk
SDK环境变量配置完成,点击保存。
二、自动化构建配置
1.我们再Jenkins网站,新建一个任务
2.我们在新建任务界面,输入任务名称,选择任务类型,我们来选择构建一个自由风格的软件项目
3.点击确定,进入任务配置界面,进行自动化构建的一些配置,包括任务设置,源码管理,构建触发器,构建环境,构建和构建后操作。
-
(1)、配置自定义工作空间
Jenkins构建默认使用的是Jenkins安装目录下的workspace,我们也可以更改为自定义的workspace,如下,在 General 板块右下方,点击高级 ,勾选使用自定义的工作空间,设置工作空间目录和显示名称。
(2)、配置源码管理,这里我们选择Git,在Repository URL 输入框中输入Android项目存放的Git路径,Credentials,需要配置Git仓库访问的用户名和密码或者SSH验证,点击Add进行添加用户验证口令
添加完用户验证口令后,我们在Credentials中选择这个验证口令,在Branches to build中更改需要自动打包的分支,这里采用默认分支master
- (3)、构建触发器,这里我们一般选择 Poll SCM 可以自定义构建触发,如:每日定时触发构建,提
交时触发构建,这里采用每两分钟检查构建
构建时间 | 命令 |
---|---|
每 15分钟构建一次 | H/15 * * * * 或*/5 * * * * |
每天8点构建一次 | 0 8 * * * |
每天8点~17点,两小时构建一次 | 0 8-17/2 * * * |
周一到周五,8点~17点,两小时构建一次 | 0 8-17/2 * * 1-5 |
每月1号、15号各构建一次,除12月 | H H 1,15 1-11 * |
(4)、构建环境我们这里不用设置
-
(5)、构建设置,点击增加构建步骤,选择Invoke Gradle Script,我们采用Gradle进行编译,选择完成之后,在增加的内容中,点击高级,展开构建配置界面
在Invoke Gradle 的Gradle Version中选择我们上篇文章配置好的本地Gradle环境,采用本地环境进行编译
在Task中,我们输入编译的命令,多命令用空格隔开,如果有配置渠道,我们可以设置打对应的渠道包,如:clean assembleDebug,或者 clean build
Root build script 中输入我们的工作空间路径
Build File 写项目的build.gradle文件名
至此,我们自动化构建配置完成,点击保存按钮,保存配置。
我们来点击立即构建,即可查看项目正在构建,点击Build History 中本次构建的时间上的小箭头(鼠标移上就会出现),点击控制台输出,即可实时查看编译日志
三、项目构建中遇到的一些问题
- Error: Some file crunching failed, see logs for details
:app:mergeCeshiDebugResources** FAILED
* What went wrong:
Execution failed for task ':app:mergeCeshiDebugResources'.
> Error: Some file crunching failed, see logs for details
* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output.
出现该问题主要是gradle 编译时的 build-cache 目录路径太长,导致 jenkins 无法识别该路径,才会出现此错误。
如图所示,现在build-cache 目录是在 C:\Windows\System32\config\systemprofile.android\build-cache 下,目录太长(深),导致运行时找不到文件
C:\Windows\System32\config\systemprofile\.android\build-cache\63e2e64e89749266e10d6160c2536dd981719789\output\res\drawable-xhdpi-v4\abc_ab_share_pack_mtrl_alpha.9.png
解决此错误的方法,是在项目的gradle.properties 文件中增加 build-cache 目录,设置一个较短的目录
android.buildCacheDir=D:/android-studio/build-cache
- 如果我们的项目中有使用 google 服务,如:下图一
这时候使用jenkins 自动化构建时,有可能会编译出错,找不到google()的服务,这是因为我们的gradle版本太低的缘故,在本文中,我们的gradle 版本使用的是3.3 的,页使用的google的服务,在编译时,出现了错误,错误信息如下:
我们在Jenkins 中的 系统管理 -> 全局系统设置中,重新添加高版本的Gradle 这里使用的是4.1 版本(本地);
配置完成之后,我们再本次构建任务中选用Gradle4.1进行编译该项目,则会编译通过。