MobDevGroupAndroid框架工具

Android-解放双手告别测试-使用Jenkins自动化打包

2017-02-13  本文已影响16777人  橘子周二

如果你并不急于放到服务器上，只是想玩玩这个东西。你可以先下载好这两个下文用到的包。
下载Tomcat9.0.zip
下载Jenkins.war

先看一下最后效果图：
Jenkins上和邮件中效果-


.png
.png

主要步骤可分为三个步骤

一 、Jenkins配置步骤

step.1 安装

准备一个tomcat版本不要太低，6.0以上。
下载最新版的Jenkins-war包。下载地址https://jenkins.io。
将war包放入tomcat下的wabapps目录下，启动tomcat。
在地址栏输入localhost:8080/jenkins。

step.2 安装所需插件

按照下面的插件列表，搜索并勾选下载安装。务必不要缺失，造成后续配置缺少参数选项和部分功能缺失。
必要的插件列表：
1.Branch API Plugin
2.build timeout plugin
3.build-name-setter
4.Credentials Binding Plugin
5.description setter plugin
6.Dynamic Parameter Plug-in
7.Environment Injector Plugin

</p>
9.Git plugin
10.GIT server Plugin
11.Gradle Plugin
12.Git Parameter Plug-In
</p>
13.Pipeline: Basic Steps
14.Pipeline: Build Step
15.Pipeline: Input Step
16.Pipeline: Nodes and Processes
17.Pipeline: Stage Step
18.Scriptler
19.Workspace Cleanup Plugin
20.Post-Build Script Plug-in
21.Email Extension Plugin
22.SSH Slaves plugin
23.Timestamper
如果你使用的SVN 还需要安装
Subversion Plug-in
Subversion Release Manager plugin

</p>插件比较多，保证网络状态良好否则个别容易失败，需要重新安装。

step.3 Jenkins配置-重点

可以直接配置android studio 安装目录中的gradle


gradle1.png

如果你使用android studio 直接更新过gradle，他们在 系统盘\users\用户名\.gradle\wrapper\dist目录下。
gradle可以配置多个，兼容不同编译版本。

sdk.png

** 需要和环境变量中的sdk路径相同**

以上就完成了简单的部署和构建。但还不是我们的最终目的。如果你你只是为了给项目组提供Jenkins工具使用，以上部署和测试就算ok了。
下面是移动端自己必须掌握的，Jenkins自定义参数配置，和二维码生成。

step.4 自定义属性配置

使用自定义属性，我们需要使用到gradle文件和properties文件
配置需要使用的自定义属性
.properties文件

APP_VERSION = 1.0.1
IS_JENKINS = false
BUILD_TYPE = debug
PRODUCT_FLAVORS = xiaomi
ALIAS_PASSWORD = android
STORE_PASSWORD = android
BUILD_PATH_JENKINS = E\:\\JenkinsApk
BUILD_PATH_LOCAL = D:\\AS_PROJECT\\TestJenkins
BUILD_TIME= 1970-1-1
APPNAME = JKApp

.gradle文件

        apply plugin: 'com.android.application'

          def getDate() {
          def date = new Date()
          def formattedDate = date.format('yyyyMMddHHmm')
            return formattedDate
       }
        def verCode = 14
        android {
        //渠道Flavors
        productFlavors {
        xiaomi {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "xiaomi"]
        }
        wandoujia {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE:    "wandoujia"]
        }
         }

        compileSdkVersion 23
         buildToolsVersion "25.0.0"
         signingConfigs {
        release {
            keyAlias 'androiddebugkey'
            keyPassword ALIAS_PASSWORD
            storeFile file('sinkkey.keystore')
            storePassword STORE_PASSWORD
            }
           }
            defaultConfig {
        applicationId "zsw.testjenkins"
        minSdkVersion 16
        targetSdkVersion 23
        versionCode verCode
        versionName "1.0"
        versionName APP_VERSION
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
           }
          buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            signingConfig signingConfigs.release
        }
        debug {
            signingConfig signingConfigs.release
        }
          }

//修改生成的apk名字及输出文件夹
    applicationVariants.all { variant ->
        variant.outputs.each { output ->
            //新名字
            def newName
            //时间戳
            def timeNow
            //输出文件夹
            def outDirectory
            //是否为Jenkins打包，输出路径不同
            if ("true".equals(IS_JENKINS)) {
                //BUILD_PATH为服务器输出路径
                timeNow = BUILD_TIME
                outDirectory = BUILD_PATH_JENKINS
                //JKApp-v1.0.1-xiaomi-release.apk
                newName = APPNAME+"-v"+APP_VERSION + '-' + variant.productFlavors[0].name + '-' + variant.buildType.name + '.apk'
            } else {
                //本机打包输出在本机路径
                timeNow = getDate()
                outDirectory = BUILD_PATH_LOCAL
                newName = APPNAME+"-v"+APP_VERSION + '-' + variant.productFlavors[0].name + '-' + variant.buildType.name + '.apk'
            }
            output.outputFile = new File(outDirectory+"/"+timeNow, newName)
        }
    }
}


dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support', module: 'support-annotations'
    })
    compile 'com.android.support:appcompat-v7:23.0.0'
    testCompile 'junit:junit:4.12'
}

上面我们配置了、渠道包、签名文件、版本号、apk命名、apk输出文件夹，在.properties文件中需要 一 一 与之对应。
下面我们进入到Jenkins对上述参数进行对应配置。

找到 参数化构建过程选项→打勾

params1.png
选择→添加参数 Choice.png

Dynamic Parameter

图片.png

String Parameter

String.png

将需要的参数按类别添加即可。

参数引用
找到上面我们使用Gradle 插件的 Invoke Gradle script
修改tasks命令，应用上面的参数，并勾选Pass job parameters as Gradle properties选项。如下图。

tasks.png
PRODUCT_FLAVORS和BUILD_TYPE即我们上面配置的参数，务必保持一致。
点击保存，回到项目首页。
就可以看到，原先的立即构建已经变成了Build with Parameter
点击参数构建，就可以看到如下上面我们配置的参数。
等待构建完成，前往在.Gradle文件中配置的路径中即可找到我们配置的命名apk。

另外提一点，更换名称。因为原命名只是构建编号，没有识别度。相信你从无参构建时就想更换了。

图片.png

进入项目配置找到→构建环境→勾选Set build Name 设置参数

图片.png

重新打包，如上图我们使用了BUILD_NUMBER 自带参数，以及 APPNAME、APP_VERSION、BUILD_TYPE ，最后效果如下图。

图片.png

二、生成二维码

这里必须用到Python这个陌生的语言。第一次接触python，虽只用到冰山一角，但也体会到了他插件化集成的便捷性。

** step.1 准备工作**：

      <Context  reloadable="true" docBase="E://JenkinsApk" crossContext="true"         path="/JenkinsApk"/>
Paste_Image.png
step.2 生成二维码

进入项目→构建→增加构建步骤，选择Execute windows batch command,填写qrcode生成二维码的命令

Paste_Image.png

上述命令中使用到的$参数，是通过动态拼接指定对于的apk文件。
生成一个jenkins_app.png的二维码图片，输出路径为 -d之后的路径。
此时点击保存，再重新构建一次，在配置目录下应该能找到生成的二维码图片了。

** step.3 展示二维码**
找到构建后操作 → 增加构建后操作步骤→Set build description
使用html标签引用我们的二维码图片和apk文件即可，当然这里我们依然需要动态拼接地址，来锁定目标。

Paste_Image.png

完整代码-

![](http://localhost:8080/JenkinsApk/${BUILD_TIME}/jenkins_app.png) <br>
 <a href='http://localhost:8080/JenkinsApk/${BUILD_TIME}/${APPNAME}-v${APP_VERSION}-${PRODUCT_FLAVORS}-${BUILD_TYPE}.apk'>�点击下载-V${APP_VERSION}.apk</a>

OK!大功告成，保存再次打包。就能得到文章开头我们贴图的效果了。
**PS:对于二维码和apk的存放路径，需要预先定义好。为了清晰这里使用时间参数BUILD_TIME 作为文件夹区分，二维码图片则只需要用同一名称。
所以apk下载地址：xx/download/2017-02-10-15-25/apk参数拼接名称.apk
二维码图片地址:xx/download/2017-02-10-15-25/jenkins_app.png
**

三、发送通知邮件

Jenkins自带了邮件通知功能，但是不太好用。跟着老司机的建议使用Email Extension Plugin来做。

step.1 配置
进入→系统管理→系统设置→邮件通知
填写如下配置

Paste_Image.png
内容填写完成后，勾选通过发送测试邮件测试配置填写接受邮箱进行测试，如果成功会收到一封如下的邮件。 Paste_Image.png

如果失败，在下面会输出红色异常信息，根据异常修改配置再测试直到成功。
这里直接使用了公司邮箱服务器，一次就通。
之前使用smtp.qq.com测试一直失败，SSL协议勾选，端口465。如果有同学配置好了，希望能在下方评论或者私信我下。

**step.2 配置邮件内容 **
找到 Extended E-mail Notification →高级，填写配置信息。上面的测试通过，只需要抄上来就好了。

Paste_Image.png
下面是邮件内信息的拼接参数，我这里只是一个我喜欢的模板，个人喜好和项目组要求可随意修改参数 Paste_Image.png
配置内容搞定，下面进入项目中对邮件配置进行引用。
step.3 添加邮件通知

进入→配置 →构建后操作 →增加构建后操作步骤 →Editable Email Notification，填写如下配置

保存重新构建就大功告成了。
如果遇到问题欢迎下方评论区留言，有留必回。（ - - 我也是多亏了其他博主为我解惑）

此篇是在我部署发布完成后，回头再写的。遇到问题还不少。
比如，代码中gradle 中的版本 和Jenkins上选择的Gradle版本如果不一样有时会打包失败。python 安装 PIL失败，使用qrcode库时按照博主的命令无法执行等。

也有其他方式，使用curl 命令行上传到蒲公英（用curl 很久了，但是上传到蒲公英总是返回空数据 大写尴尬），将返回信息打印到日志输出，使用正则匹配到二维码图片连接，但这种方式远不如本文本地生成二维码来的利索和便利，而且保证了每一个apk都有一个唯一的二维码。

十分感谢以下博客的分享：
Android Jenkins+Git+Gradle持续集成-实在太详细
利用Jenkins玩转Android自动打包发包
windows下面安装Python和pip终极教程

上一篇下一篇

猜你喜欢

热点阅读