Jenkins配置android自动化打包(Windows环境下)

一、安装jenkins

官方下载地址:https://jenkins.io/zh/download/

1、下载jenkins安装包
Jenkins官网

2、安装默认推荐的插件
下载好的Jenkins文件

3、解压出下载好的jenkins文件,双击“jenkins.msi”安装文件

jenkins安装完毕之后,浏览器打开:http://localhost:8080/
登录账号:admin
登录密码:默认密码位于jenkins安装目录里面
\Jenkins\secrets\initialAdminPassword

安装默认的插件

安装默认的插件

二、全局性配置(Global Tool Configuration)

1、JDK配置
JAVA_HOME配置

2、版本管理工具配置(Git)
Git配置

3、Gradle配置
Gradle配置

三、系统配置(Configure Syetem)

android sdk配置

android sdk配置可以有两种方式,第一种让Jenkins自动去下载;第二种手动下载到本地;
具体使用哪种方式?建议是:如果jenkins环境部署在远程服务器时,使用jenkins自动下载方式(只需要上传sdk下载协议即可,免去上传几个G的SDK文件至服务器);如果直接开发电脑本地搭建jenkins环境,使用本地已有的sdk即可;

1、jenkins自动下载android sdk

让jenkins自动去下载sdk,需要存在sdk目录里面,提前放置好sdk下载许可协议,否则jenkins无法完成自动下载
安装Android Emulator Plugin插件
Manage Jenkins——>Manage Plugins——>Avilable
搜索框输入“Android Emulator Plugin”,安装该插件(如果该插件已经安装,此处会不显示,在Installed处能够看到Android Emulator Plugin)

安装插件方式

1-1、Android SDK root路径配置

Manage Jenkins——>Configure System——> Global properties——>Android(最底部)
tools/android-sdk路径需要提前在Jenkins安装目录下创建好

image.png

1-2、ANDROID_HOME配置

Manage Jenkins——>Configure System——> Global properties
tools/android-sdk路径需要提前在Jenkins安装目录下创建好

ANDROID_HOME配置

1-3、Jenkins安装目录下,创建SDK保存文件目录,很重要

经过反复验证,发现jenkins并不会自动创建上面配置好的路径目录,如果不进行创建,后续编译会报错,找不到对应文件夹,所以我们需要预先到jenkins安装目录下面先创建出android-sdk目录,tools目录默认是没有的,需要自己创建


image.png

1-4、配置SDK下载许可协议,非常重要

这一步也是非常的重要,否则jenkins无法自动下载SDK,如果忘了配置下载许可协议,后续会遇到如下报错;
android-sdk-licennse文件可从我们已有的sdk文件中复制:
1、在安装了 Android Studio 的计算机上,依次点击 Tools > Android > SDK Manager。在窗口顶部,记下 Android SDK Location。
2、转到该目录,并在此目录下找到 licenses/ 目录(如果您没有看到 licenses/ 目录,请返回到 Android Studio 并更新 SDK 工具,确保接受许可协议。返回到 Android SDK 主目录后,您现在应该会看到该目录)。
3、复制整个 licenses/ 目录,并将其粘贴到jenkins安装目录下,tools\android-sdk\里面;
下图是已经复制完成

配置sdk下载协议

2、使用本地已经下载好的sdk,直接配置 ANDROID_HOME

Manage Jenkins——>Configure System——> Global properties——>Environment variables
D:\Android\SDK是我本地电脑sdk路径;使用本地sdk方式,无需安装Android Emulator Plugin插件,也无需配置Android SDK root

配置本地已有的sdk
本地sdk所在路径

GRADLE_USER_HOME 配置

Manage Jenkins——>Manage Plugins——>Global properties——>Environment variables


GRADLE_USER_HOME配置

四、创建android构建任务

1、第一步,创建任务

创建android构建任务

2、第二步,创建任务

image.png

3、第三步,配置android构建任务,Git配置

Git仓库配置

4、第四步,配置android构建任务,Build配置

Build配置

gradle命令配置

${WORKSPACE} clean assembleRelease

5、第五步,配置apk输出

1

2

**/*.apk,**/mapping.txt,点击save保存
输出apk和mapping文件

五、执行构建任务

1、执行构建任务

执行构建任务

2、构建失败,查看错误日志

如果构建失败,可查看构建日志,根据错误提示进行排查问题


进入查看日志

构建失败,查看日志

3、构建成功,输出apk包和mapping文件

构建成功