利用jenkins+gradle完成Android项目打包

vlambda
2021-05-07

利用jenkins+gradle完成Android项目打包

问题和思路

目前存在的问题：

打包操作由开发人员完成，这样开发进度容易被打断。

解决问题的思路：

将打包操作交测试/产品/开发人员来完成，主要是测试/开发。

按照以上的思路，那么jenkins+gradle的解决方案是比较经济的，实现起来难度不大，下面我们详细介绍一下搭建过程。

搭建过程

1.服务器的准备

普通配置PC一台
安装ubuntu20.04(或者vmware虚拟ubuntu也可以)
可配置上网、关闭防火墙、开启ssh服务

2.docker安装jenkins

在ubuntu下安装dokcer。使用下面的命令拉取jenkins的docker镜像，这里我用的是lts的长期支持版本，你可以到jenkins官网自由选择其他版本。

sudo docker pull jenkins/jenkins:lts

（左右滑动查看完整代码）

配置宿主机映射到容器的目录，之后jenkins的一些配置文件都将会存储到该目录下，这个目录可以自己定，但是我建议遵守我这样的规范，便于日后查找和管理。

sudo mkdir /home/jenkins_home # 创建jenkins_home目录sudo chown zhq:zhq /home/jenkins_home #设置该目录的所有者和所属的组(zhq是常用登录到机器的账号)

（左右滑动查看完整代码）

ps：zhq是常用登录到机器的账号，这样为了避免一些有关操作权限的问题。

启动jenkins的docker镜像，并设置相关参数，参数解释：

-d 表示以后台模式运行
--name 为容器定义一个名字（后面可以代替容器id使用）
-p 表示映射容器的端口到宿主机的端口
-v 表示映射宿主机的目录到容器的目录
-u zhq 使用zhq用户运行，与登录到ubuntu的账号一致，避免后面出现的一些执行权限问题
-v /home/jenkins_home:/var/jenkins_home 映射jenkins_home，将数据存储到宿主机，这样配置就不会随容器丢失
-v /var/run/docker.sock:/var/run/docker.sock 与 -v /usr/bin/docker:/usr/bin/docker 把宿主机docker 映射到容器内，可以直接在容器内使用宿主机docker
-v /usr/lib/x86_64-linux-gnu/libltdl.so.7:/usr/lib/x86_64-linux-gnu/libltdl.so.7 \ 容器内docker运行需要的库文件
-v /opt:/opt \ 自主安装的一些运行时软件（如java/maven/git...）
-v /etc/timezone:/etc/timezone映射时区文件，保证容器的时区和宿主机相同（官网的jenkins容器时区不是中国的时区）

最后的jenkins/jenkins:lts是要启动的镜像。

sudo docker run -d --name jenkins -p 8080:8080 -p 50000:50000 -u $(id -u) \ -v /home/jenkins_home:/var/jenkins_home \ -v /var/run/docker.sock:/var/run/docker.sock -v /usr/bin/docker:/usr/bin/docker \ -v /usr/lib/x86_64-linux-gnu/libltdl.so.7:/usr/lib/x86_64-linux-gnu/libltdl.so.7 \ -v /opt:/opt \ -v /etc/timezone:/etc/timezone jenkins/jenkins:lts

（左右滑动查看完整代码）

ps：可使用以下命令查看container是否运行成功：

$ sudo docker psCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES3c20dfcbb16e jenkins/jenkins:lts "/sbin/tini -- /usr/…" 2 minutes ago Up 2 minutes 0.0.0.0:8080->8080/tcp, 0.0.0.0:50000->50000/tcp jenkins

（左右滑动查看完整代码）

容器启动后，就可以访问ip:8080看到jenkins首次运行的首页了，然后通过下面命令查看初始密码，填入之后跳转到安装插件的页面，选择第一个就好，会默认安装一些插件。

sudo cat /home/jenkins_home/secrets/initialAdminPassword

（左右滑动查看完整代码）

插件安装很慢，所以我们要设置的插件的国内镜像url进行提速，具体自行寻找参考文章。

替换完成后，需要执行以下命令，重启容器：

sudo docker ps # 获取container 的idsudo docker container restart 获取的container_id

（左右滑动查看完整代码）

再次访问jenkins页面可以发现插件安装飞快。

创建一个自由风格的项目：

保存退出，回到项目列表，点击右侧的构建按钮
校验代码是否拉取成功

cd /home/jenkins_home/workspacels -ldrwxr-xr-x 12 zhq zhq 18 4月 21 16:28 HelloWorld # 如果展示了项目名称，代表拉取代码成功

（左右滑动查看完整代码）

暂停当前操作，我们先在本地使用gradle打包，然后再和jenkins进行结合

3.gradle打本地包

下载解压java SDK、Android SDK和gradle。

~$ mkdir soft~$ cd soft~$ wget ftp://biguser:[email protected]:8021/201704/tools/jdk-linux-x64.tar.gz~$ wget http://dl.google.com/android/android-sdk_r24.4.1-linux.tgz~$ wget https://services.gradle.org/distributions/gradle-5.4.1-all.zip~$ tar -zxvf jdk-linux-x64.tar.gz -C /opt/java/~$ tar -zxvf android-sdk_r24.4.1-linux.tgz~$ unzip gradle-5.4.1-all.zip

（左右滑动查看完整代码）

配置java,android环境变量。

~$ sudo vim /etc/profile

（左右滑动查看完整代码）

在文件底部添加以下内容：

export JAVA_HOME=/opt/java/jdk1.8.0_131export PATH=${JAVA_HOME}/bin:${PATH}export ANDROID_HOME=/home/zhq/soft/android-sdk-linux

（左右滑动查看完整代码）

保存退出后，导入新的配置：

~$ source /etc/profile

现在来验证一下。以我们当前项目做例子，可执行下面命令：

~$ ./soft/gradle-5.4.1/bin/gradle --parallel -b /home/jenkins_home/workspace/HelloWorld/build.gradle assemble_test

（左右滑动查看完整代码）

其中：

/home/jenkins_home/workspace/是文中jenkins用来存放项目代码的目录；
/HelloWorld/build.gradle我们项目build.gradle所在目录，如果打包其他项目应做响应替换；
assemble_test是项目的buildType，一般都会有assembleDebug和assembleRelease，项目不同可能会有其他类型，比如我们用到的assemble_test。

以上操作，有错误产生，和当前所使用的android SDK没有升级相关版本有关系,由于下载的Android SDK无法启动android SDK manger，所以我安装了android studio，在启动的时候提示指定SDK路径，启动已经下载了的项目，按照提示更新SDK即可。

android studio在ubuntu下安装比较容易，在此不做详细说明了。

4.把jenkins和gradle进行结合

把打包命令写成一个脚本test.sh。

#!/bin/bash +x. /etc/profile ~/soft/gradle-5.4.1/bin/gradle --parallel -b /home/jenkins_home/workspace/HelloWorld/build.gradle

（左右滑动查看完整代码）

保存退出后，增加执行权限：

chmod +x test.sh

在jenkins项目中添加构建shell。把刚才文件的绝对路径添加进去，下面我们就准确的掉坑里了，执行项目构建发现构建失败，提示test.sh没有找到,这是因为jenkins执行的时候，是在容器中进行的，我们刚才那个路径在容器中不存在，我们需要把宿主机当作一台远程机器ssh到机器上执行脚本：

给jenkins安装SSH插件
在系统管理-->系统配置中按照填写宿主机ip/端口/凭证（登录账号密码）如下图：

保存退出，重新构建

至此，这台机器已经可以成功打包了。

5.扫尾工作

安装存放到指定位置。对于上面提到的test.sh可以进行修改，把apk放到指定位置，代码修改如下：

#!/bin/sh +x. /etc/profile~/soft/gradle-5.4.1/bin/gradle --parallel -b /home/jenkins_home/workspace/Hellworld/build.gradle assemble_test


app_path='/home/jenkins_home/workspace/{项目apk存放的位置，根据项目不同进行修改替换}'target_path='/home/zhq/webroot/apks/' # 此处是自定义存放位置
if [ "`ls -A ${app_path}`" = "" ];then echo "${app_path} is empty"else mv $app_path/*.apk $target_path rm -rf $app_path/*fi