Jenkins+tomcat持续集成安卓apk实践

注：本教程是在Mac下执行的！
一、工具准备
1、代码管理（Git、Github）
（1）自行下载安装Git
（2）注册Github账号，把源码放到github上
例如：https://github.com/robberphenix/MiniBrowser2.git 这个是我网上找的关于一个微浏览器apk的源码，大家可以把它提交到自己的github仓库。

2、集成工具（Jenkins）
这里我们使用servlet容器来部署Jenkins，使用的是tomcat.
(1)下载tomcat
终端执行：
brew info tomcat

(2)官方Jenkins下载war包，然后把jenkins.war包放入该路径下
/usr/local/Cellar/tomcat/8.5.23/libexec/webapps

(3)启动Jenkins时，执行命令:
catalina run

(4)浏览器输入：http://127.0.0.1:8080/jenkins/
打开页面为下图这样，说明jenkins启动成功

image.png (5)刚打开的页面需要填入Administrator password，该Administrator password可以在终端的log中获得，复制粘贴到jenkins的输入框点击continue即可。如下图 image.png

(6)点击安装建议的插件，等待安装成功。

(7)设置Admin User,可以点击设置默认的Admin User,

(8)默认的Admin用户的密码非常长，所以去修改用户密码
点击右上角的Admin--设置--下拉找到底部密码输入框，修改成自己便于记忆的密码。点击Apply，再点击保存，修改密码成功。

二、工具系统配置
1、管理插件
点击系统管理--点击管理插件，点击已安装，确认Git Plugin、Github Plugin、Gradle Plugin、Android Emulator Plugin的插件已经安装，若未安装，在可选插件列表里把这四个插件安装。

2、全局工具配置--配置Gradle插件

点击系统管理--点击全局工具配置--找到Gradle--点击Gradle安装，配置如下，点击Apply--点击Save image.png

3、系统设置--设置GitHub、Android

（1）找到GitHub，点击如下图圈出的personal access token，用打开新页面方式打开。 image.png 打开的新页面若未登录，请登录github，若登录了则打开的是如下页面,在输入框随便输入，然后选中repo,再把页面拉到底部，点击Generate token, image.png 页面会生成一串token值，复制这串token值后，回到jenkins页面，点击Credentials旁边的Add按钮，选择Jenkins，弹出如下图的弹层，Kind选择Secret text,再把刚复制的token值粘贴到Secret输入框，点击Add。 image.png

在Credentials旁的下拉框选择刚刚创建的Secret text，点击Test connection检查是否创建成功

（2）找到Android
在Android SDK root的输入框里输入android-sdk的路径
/usr/local/share/android-sdk

三、Job配置--用Jenkins对源码竟然编译打包到安卓手机上并且跑Monkey测试
（1）点击新建Item，选择构建一个自由风格的软件项目，创建一个项目名称例如wutest,点击确定。

（2）复制你的GitHub上关于微浏览器源码的地址，例如我的源码地址：https://github.com/robberphenix/MiniBrowser2.git

（3）回到Jenkins，点击之前创建的wutest项目，点击配置，找到‘源码管理’，选择Git，在Repository URL输入框内黏贴之前复制的源码地址，在Credentials旁点击Add--Jenkins,弹出弹层，把你的GitHub账号密码分别填入弹层上的Username,Password。点击保存，然后在Credentials的下拉框选中刚刚配置的用户名密码。

（4）找到‘构建’，点击‘增加构建步骤’，选中Use Gradle Wrapper，勾选Make gradlew executable，在Task输入框填入build。点击应用--保存。

（5）Jenkins安装apk需要在‘构建’里配置APK file地址，因为第一次构建，不清楚APK存在本地哪个目录下，所以可以先构建一次，找到构建好的apk存在哪个目录下，再把目录地址拷贝的APK file里。

（6）点击‘立即构建’，在Build History列表里找到正在构建的记录，点击进入，再点击Console Output，找到控制台输出的第二行/Users/wuyanjiao/.jenkins/workspace/wutest，去终端一步一步找到路径，最终路径是：/Users/wuyanjiao/.jenkins/workspace/wutest/app/build/outputs/apk/app-debug.apk

(7)返回wutest项目，点击构建--点击增加构建步骤--点击Install Android Package，在APK file中输入/Users/wuyanjiao/.jenkins/workspace/wutest/app/build/outputs/apk/app-debug.apk
Uninstall existing APK first和Fail the build if installation fails都需要选中。

(8)选择‘增加构建步骤’--选择‘Run Android monkey tester’。Package IDs填写APK的包名。配置如下图，配置完成后，点击应用--点击保存 image.png

获取包名步骤如下：①手机连接上电脑 ②在终端输入命令adb logcat | grep START ③点击手机上的APP,终端日志会打印出包名com.example.zhangjian.minibrowser2。

（9）返回wutest项目，点击立即构建，观察手机终端是否安装app成功并且执行完monkey测试。

四、Jenkins工具自动化持续集成
选择项目里的配置--构建触发器--Build periodically，设置定时持续集成，图中设置了每15分钟集成打包一次

image.png