搭建机器:一台Mac Book Pro
开发工具:Android Developer Tools Build: v22.6.2-1085508(mac版本)
开发环境:OS X EI Capitan 版本 10.11.5
jenkins版:V1.647

(特别注意:我用的是V1.647,如果使用其他版本可能导致一些未知的BUG)

比如我之前用了最新的2.10版本,就导致了一个很奇葩的问题,找了很多资料都没有解决

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图1

所以还是用老版本吧,比较稳定点。

二.环境搭建

1.Android adb 命令配置

关于Android整个开发环境的搭建,什么SDK的下载安装,这里我就不详细叙述了,作为一个Android开发人员这个是基本技能了。
我主要说下adb命令配置
第一步:打开终端iTerm

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图2

(广告插入,想要这个工具,可以看我之前的一篇文章:iOS程序猿这些工具你值得拥有http://www.jianshu.com/p/4b7e65f2677c)
第二步:输入touch .bash_profile(创建文件)
第三步:open -e .bash_profile(打开文件)
在弹出的文件中,输入Android SDK platform-tools的路径
格式为:export PATH=${PATH}:路径地址
jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图3
第四步:输入source .bash_profile
第五步:输入adb(校验是否配置成功)

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图4
还需要进行下面的配置,android命令才能使用

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图5

2:配置ant命令

下载安装包,官网下载地址:
http://ant.apache.org/bindownload.cgi
jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图6
将下载到文件解压到部署目录,比如

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图7

类似与adb命令的配置,把PATH添加到.bash_profile文件

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图8

通过ant -version测试是否配置OK

3:安装jenkins

通过brew install jenkins进行安装
jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图9

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图10

通过浏览器访问(终于看到小老头了,哈哈)

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图11

注意:
不要通过pkg安装,可能导致比较奇葩的问题
不要通过pkg安装,可能导致比较奇葩的问题
不要通过pkg安装,可能导致比较奇葩的问题

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图12
至于为什么,我也不知道,文末我会详细叙述下那个奇葩的BUG,还请大神指导

4:jenkins环境配置

a.安装相应的插件

Git Plugin
Ant Plugin
Android Lint Plugin

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图13

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图14

b.环境变量配置

配置Android SDK路径

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图15

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图16

c.配置Ant

在系统设置界面里
jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图17

5:新建一个github的android项目

https://github.com/andli0626/AntAPK.git

6: 初始化项目

通过ADT新建的项目是缺失Ant编译所需要的文件,所以需要通过Ant命令对项目进行初始化操作,自动生成必要的文件
命令格式:android update project —name <项目名称> —target —path <项目路径> —subprojects
主要是这个target,其实就是指定Android项目编译的Android SDK版本,可以通过android list targets 查看本机所支持的Android SDK版本ID

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图18
我选择的是1,那么就是Android 4.0.3编译
在终端输入命令,例如:

  1. android update project name AntAPK target 1 path /Users/XXX/WK/ADT2015/AntAPK subprojects

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图19

执行ant debug,编译后生成未签名的APK

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图20

怎么生成带签名的呢?需要配置local.properties,配置完成后执行ant release,生成带签名的APK

  1. key.store=签名文件所在路径
  2. key.store.password=签名密码
  3. key.alias=签名文件别名
  4. key.alias.password=签名密码

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图21
如果能够成功编译,那么下面通过jenkins去自动编译基本也是OK的。
至此,前期准备都准备完毕了

三.项目实战

1.新建一个自由风格的软件项目

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图22

2.配置git地址

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图23
我们先立即构建下,提示构建成功

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图24
那么构建后的项目在哪里呢?
通过系统管理->系统设置->主目录 点击高级,可以查看到

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图25

3:编译配置(很关键)

上面虽然编译成功了,但是你发现根本没有看到APK文件,所以还需要进行下面的配置:增加构建步骤

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图26

配置完成,点击立即构建,查看APK所在的路径
(注意:这个APK的生成路径是默认的不需要在jenkins中配置)

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图27

OK,一个简单的打包就完成了。

4.发布到蒲公英

a.帐号申请

首先得注册一个蒲公英的帐号
官方地址:
http://www.pgyer.com/apps

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图28
上传一个APP,得到API Key,UserKey

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图29
注意:同一个用户的API Key,UserKey是固定的(后面会用到这2个参数,请记住)

b.jenkins配置

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图30

jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图31

  1. curl -F "file=@apk所在路径" -F "uKey=用户User Key" -F "_api_key=用户API Key" http://www.pgyer.com/apiv1/app/upload

参考资料

Ant命令配置 for mac
http://my.oschina.net/u/1244156/blog/355031
使用Ant编译APK
http://blog.csdn.net/houyu_1983/article/details/9129031
使用jenkins上传到蒲公英(Android)-蒲公英官方文档
http://www.pgyer.com/doc/view/jenkins
jenkins+eclipse+ant+蒲公英-实现Android自动打包全攻略(MAC版) - 图32