本文为原创,码字不易,转载请注明,谢谢!
目的:
1、用jenkins拉取git的代码,实现安卓的自动打包
2、将生成的apk上传到蒲公英平台
3、将蒲公英返回的二维码地址在jenkins上展示
效果如下:
环境:Linux
步骤:
1、搭建jenkins环境(这个有现成的,包括JDK和Git的配置,略过)
2、android 开发环境(因为对于安卓开发环境不是很熟悉,整个过程中,这个耗时最多)
1)下载安卓SDK,并解压:
# cd /XXX
# wget http://dl.google.com/android/android-sdk_r24.4.1-linux.tgz
# tar zxvf android-sdk_r24.4.1-linux.tgz
解压后,android sdk所在目录为 /XXX/android-sdk-linux
2)配置android sdk 环境 变量
# vim /etc/profile
在文件末尾添加:
export ANDROID_HOME=/XXX/android-sdk-linux'
export PATH=$ANDROID_HOME/tools:$PATH
保存
# source /etc/profile
3)接下来需要下载相关的包,一开始我是不知道的,在jenkins构建的时候会报相应的错误,在一次次的试错之后,终于齐全了(在此非常感谢开发帅哥)
错误信息大概如下:
*What went wrong:
A problem occurred configuring project ':XXX'.
>You have not accepted the license agreements of the following SDK compoents:
[Android SDK Platform XX......]
解决办法参照:http://www.jianshu.com/p/4d980fc806dd
获取可安装的组件列表
# android list sdk
缺什么安装什么
# android update sdk --no-ui --filter[list中的id]
(也可全部安装,但我嫌太多了,有些没用到的就没必要下载了)
在这个过程中还遇到一个问题,开发的打包配置文件中build-tools是25.0.1的版本,以上list显示的是最新的27.0.1的版本,需要手动下载25.0.1的版本,通过度娘找到了一个神奇的地址,果断mark:http://mirrors.neusoft.edu.cn/android/repository/
3、安装Gradle
1)下载Gradle并解压
# wget https://services.gradle.org/distributions/gradle-4.3-bin.zip
# unzip gradle-4.3-bin.zip
在此又mark一个地址:http://services.gradle.org/distributions/
2)配置Gradle环境变量
# vim /etc/profile
添加:
export GRADLE_HOME=/XXX/gradle-4.3
export PATH=$PATH:$GRADLE_HOME/bin
# source /etc/profile
4、jenkins安装相关插件(网上的资料显示要下载很多,由于没有添加很多的参数,此处根据实际需要只安装了部分):
Git plugin ------用于从git获取代码
Gradle Plugin ------用于app打包
description setter plugin ------用于展示二维码
5、jenkins全局工具配置
进入 【Jenkins-全局工具配置】页面,配置好Git、Gradle的参数,如下图:
6、新建一个自由风格的job
1)参数化构建
因为是比较简单的配置,只有一个打包类型的参数
2)配置git源码管理
3)默认的构建名称是显构建编号,有时候为了方便查看,希望显示自定义的名称
在构建环境中勾选Set Build Name,并设置
4)增加构建步骤Invoke Gradle script—选择配置好的Gradle Version—在Tasks中输入Gradle命令—把下面的Pass jod parameters as Gradle properties勾上—Root Build script 根据实际配置工程的路径
至此,保存 job 的配置,通过参数构建,能打包成功(如果没有成功,就需要检查哪里出问题了)
7、上传到蒲公英
在上传到蒲公英平台前,需要在蒲公英上注册一个账号并通过实名认证,拿到API信息,并参考官方文档:https://www.pgyer.com/doc/view/jenkins
Jenkins上添加构建步骤 Execute shell ,上传的命令是:
curl -F "file=@app-${BUILD_TYPE}.apk" -F "uKey=XXX" -F "_api_key=XXX" https://www.pgyer.com/apiv1/app/upload
注:file 后面为apk的名称(根据实际指定路径),“@”不可少;uKey为蒲公英上显示的User Key;_api_key为蒲公英上显示的API Key
重新构建了一次,成功了,从控制台输出中能看到蒲公英返回的二维码地址(是长地址哦~~~)
注:网上的参考资料显示,蒲公英返回的信息中只有二维码的短地址,没有二维码的长地址,与实际有出入
8、展示蒲公英返回的二维码图片
在前面的步骤中,已经能拿到二维码下载的长地址了,通过正则把地址取出来就行了,这个就需要仰仗Set build description这个插件了。
在配置之前,需要修改下Jenkins的安全配置:系统管理->Configure Global Security,将 Markup Formatter 更改为“Safe HTML”。
增加构建后的步骤,选择Set build description,Regular expression 中输入正则表达式,Description中采用HTML的 img 和 a 标签插入图片和链接文字。
在这里遇到了一个小插曲,二维码地址中有“\”,直接复制地址到浏览器中访问是没有问题的,我以为直接copy到HTML里面也是可能的,然后正则写的是匹配“appQRCodeURL”后面的字符串,构建后发现显示的地址是这样:
想到只要在正则里面过滤掉“\”就可以了,然而现实是我不会过滤~~
不会!!
笨人有笨办法,观察了url,发现变的只是qrcodeHistory后面那一串,把那一串取出来,手动拼上前面的不就可以了?迫不及待试了下,成功了(内心无限喜悦)
注:在Description中通过 “\1”这种形式来引用正则匹配的结果
9、自动构建
本来是想实现开发提交代码到指定的分支就自动构建,但代码在coding上,jenkins是内网环境,外网访问不到,也就放弃了,改用定时构建