# Android打包jenkins教程
### 主要内容
* 基于SVN或Git [测试项目连接](http://10.96.163.81/Wenzhi/fiberhomecolor.git)
* Android项目参数化自动构建
* 自动将APK上传至蒲公英 https://www.pgyer.com
* 自动发Email到指定邮箱提示构建结果
上图
![cdaf6daac0713208041d277c6bc4807a.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p139)
### 安卓必备插件下载
安装插件:
| 插件名 | 作用 |
| --- | --- |
| build-name-setter | 修改构建名称 |
| description setter plugin | 修改构建目录的描述|
| Email Extension Template Plugin | Email模板编辑 |
| Locale plugin | 修改Jenkins默认语言 |
| Timestamper | 动态获取时间 |
| Upload to pgyer | 将APK上传到蒲公英 |
* 安装插件
* * *
![0b0a4a99ef0dbc1b3226ba5edd83b081.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p99)
选择
![c02ceed72d07c21ba264afea0feb1599.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p102)
#### 两种方法安装
1.选择可选插件安装
![8571b0966fcbb5543239bd528e1b5a2f.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p103)
搜索之后直接点击直接安装就行
![226673d620d627c2e5f014b9c62cbc96.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p104)
* * *
2.如果出现代理错误,或者安装失败可以通过jenkins镜像网站下载
jenkins镜像网站[连接地址](http://mirror.xmission.com/jenkins/plugins/)
下载完成的后缀是hpi文件
![424279d75db21bc186b22f48bebb12ab.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p105)
下载完成之后点击高级上传本地插件即可
![afe7af273ce1a2eba25cbf3ef58883fc.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p106)
系统管理员的邮箱一定要设置,这是个坑,要是不设置,你的邮箱怎么配置都不会触发,Jenkins URL则是访问地址安装的时候会要求设置,我这里是设置成本机电脑ip,这样局域网内别的电脑也可以访问。
![923b236e9821d8ba685ba7f268ce48d7.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p136)
![24f94ef3e9ac947bb8c6b4bbf00f4846.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p137)
但是服务器好像有bug 不知道为什么暂时未解决
![3633c1c179eb123af0f685fba2eae133.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p138)
**备注这些插件我都已经安装了**
## 开始构建项目
首先环境变量的设置
设置服务器端安卓的环境变量已经设置
![f5fc52b89acca3c104c1f928d64b1946.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p110)
如果你的项目需要跟新android SDK 可以登录服务器运行
```
android list sdk --all
```
如下
![e75c81d9cb38a0d844faee1a94899f79.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p111)
选择你需要
如果需要安装多个软件包进行更新安装,比如:
```
android update sdk -u -a -t 1,2,3,4,..,n
```
* 选择自由项目,输入项目名字
* ![0755b3cd49dc4065618d193d1fed2d32.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p112)
配置项目开始
1. 选择源码管理,填入你的git项目地址
![b221ae37a1c6e52728388b2b41a97959.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p113)
2.然后配置构建,选择Invoke Gradle script
![6578dc2d72687113e2a6be543f3c3d49.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p117)
3. 点击展开Tasks,然后输入
```
clean
assembleDebug
--stacktrace
--debug
```
4. 输入完上面内容后,展开高级内容,勾选![cd1543a9a456e08bc8893f65597096ba.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p118)
windows一定要勾选,不然构建失败,这个选项就相当于Android Studio的Gradle的缓存目录,如果项目多,懒得勾选,则可以在第一步的系统设置中的环境变量中配置GRADLE_USER_HOME环境,本地找个文件夹即可(最好使用Android Studio的Gradle默认缓存目录)
如下
![bd3e481ca7e5b9fb52856a453c913ba8.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p119)
5.点击应用,保存,然后点击![ef6e78d4315c2de306003b754149e963.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p120)
即可进行构建,如图构建成功,可以进去查看日志,或者到工作空间去查看生成的apk包
### 配置参数化构建
选择![c4e0e4bab7291545dcbefcc0e1a64d7a.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p121)
这里可自由配置任何参数
![f07a8ac8acb21d874baca56e38bc52c9.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p122)
部分参数的翻译
| 参数名 | 翻译 |
| --- | --- |
| Boolean Parameter | bool值 true或者false|
| Choice Parameter |可以选择的参数,一定要注意每个选项换行 |
| String Parameter | 字符串参数|
6. 参数配置完成,可以自己持续添加自己需要的参数,也可以自己更改参数名称,但是更改的参数名称要和Android项目中gradle.properties文件中的参数名对应,有些需要默认参数,签名文件为了安全尽量不要填写默认密码
例如哥伦比亚项目gradle.properties配置如下与你设置的参数进行一一对应
![f42990d7d7d380a77cc8a23d98764583.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p123)
7. 在构建中,把Tasks中的Debug改成${BUILD_TYPE}调用刚刚配置的参数,勾选Pass all job paramenters as Project properties 把参数注入到项目中
![2b9d24c2af194fdb9d4863e51d8c22d8.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p124)
注意:如果不勾选这个,jenkins不会注入所设置的参数
8. 点击应用,保存,会发现项目首页的立即构建变成了Build with Parameters,点击则出现右侧参数列表,选择release尝试构建。
![1a605ceee5988601da72770617283ae4.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p125)
9. 继续优化配置 设置构建触发器SCM
![027ecdb93ad9b2654d4a95726881f15c.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p126)
每隔10分钟检查资源库是否有提交更新,有更新则进行构建
*/10 * * * *
10. 将APK包上传到蒲公英https://www.pgyer.com
![dbaed8e7ac7d247f9db915726343fea6.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p128)
![1bbe2291360b23c6a29cdf141a750908.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p127)
输入你的蒲公英的userkey和appkey
![da771c6b9e2996cc0b1b05983b398551.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p129)
打包目录和文件
![c22d504678542d1a8d9c5103d9b770dd.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p130)
支持通配符搜索。
上面表示,在工作目录下面app目录下build目录下outputs目录下apk目录下
文件名
xxx/xxxxxxxxxxx.apk
11. 输入参数
![a0e7937d1d7d3b883504b24567132368.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p133)
12. 设置构建完成之后的显示二维码
![fad41f4837a58f52638811965f104a46.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p132)
填入下面
```HTML
${appName}_ ${appVersion}
下载地址:APK下载链接
```
可以使用的参数
![158181b37c9a393f2c9c9bfd0b8dc885.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p134)
13. 建完成后发邮件
在构建后操作添加Editable Email Notification,默认部分不需要更改,因为内容在配置系统设置的时候已经配置好,如果要动态增加接收人的邮箱,在Project Recipient List 中加入邮箱即可用 ,隔开,点击底部的Advanced Settings设置触发条件。即可发送邮件到指定邮箱。可以根据自己的需要配置邮箱触发事件,如果不配置则不会发送邮箱
![b9162fca16ae5920c82f2e8eb5f942e6.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p135)
## 最好使用阿里云镜像进行设置maven
![901641a217b58955287dfa125519bb9c.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p131)
不然很多时候编译日志会爆404 或者超时
配置安卓gradle
![87cebc0ebce3d20b48266bbd4008a62c.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p141)
build文件
![5c4a11a6faaa19dce20feea289295b4b.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p142)
## 上传keystore文件到服务器
使用
```
//local_folder 本地文件夹路径 remote_username 远程服务器登录的账户 root , remote_ip 服务器ip, remote_folder服务
//器上传的路径
scp -r local_folder remote_username@remote_ip:remote_folder
```
目前我已经在这个路径/media/new/fiberhomekey下上传了一个key
![27e39c5f649792f644f7853cb4020c2f.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p143)
可以直接使用
```
storePassword 'smartnetwork'
keyAlias = 'smartnetwork'
keyPassword 'smartnetwork'
```
![ac36b1a7907450a22cc0f51836758358.png](evernotecid://2F5C6CF8-0D7E-48CF-9680-88B84D6B037D/appyinxiangcom/13318295/ENResource/p148)
### 教程