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

如果你并不急于放到服务器上,只是想玩玩这个东西。你可以先下载好这两个下文用到的包。
下载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配置-重点
  • 3.1 环境配置:
    进入:系统管理→Global Tool Configuration
    找到 JDK、Gradle、Git 三个模块。
  • JDK :
    别名=随意。
    JAVA_HOME=即环境变量中JAVA_HOME中的内容
  • Gradle:
    别名=随意
    GRADLE_HOME= gradle的安装目录路径xx/gradle\gradle-2.14.1

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


gradle1.png

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

  • Git
    Name=别名
    Path to Git executable = git.exe文件的全路径(d:\progran files\Git\bin\git.exe)

  • 3.2 全局属性配置

sdk.png

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

  • 3.3 打包配置
    新建→构建一个自由风格的软件项目,进入到新建项目后,填写名称及说明。
    • 找到→源码管理,选择对应的代码管理工具,我这里使用的是git
      填写信息如图
      git2.png

      使用git还需要添加认证,即账号登陆,点击Add输入git账号信息
      git2.png
    • 选择→构建插件,我们准备的是gradle,所以选择 Invoke Gradle script
      选择配置的gradle的版本,在 taks 栏输入 命令:clean assembleRelease --stacktrace --debug
      点击保存!
  • 3.4 无属性构建
    点击立即构建,在 build history可看到任务执行。
    任务前有个蓝色小圆点,如果项目构建失败,任务前的小圆点为红色,构建成功依然为蓝色。
    同时在Console Output中可查看构建日志, 日志最后出现Finished: SUCCESS,即构建成功。
    如果出现 Finished:Failed构建失败,日志内容比较多,直接全局搜索error查看报错信息。
    进入→工作空间中可看到和工程目录一样的结构,找到apk包。

以上就完成了简单的部署和构建。但还不是我们的最终目的。如果你你只是为了给项目组提供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
  • 字符输入参数使用 String Parameter
  • 时间参数使用 Dynamic Parameter
    在添加参数时,配置Name的值必须与.properties文件中定义的参数名称相同。
    我们需要用到的仅这三个,具体输入如下图。
    Choice
Choice.png

Dynamic Parameter

图片.png

String Parameter

String.png

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

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

tasks.png

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

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

图片.png

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

图片.png

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

图片.png

二、生成二维码

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

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

  • 为tomcat 配置文件下载路径
    进入tomcat安装目录→conf→server.xml文件,在Host节点中添加如下配置。
      <Context  reloadable="true" docBase="E://JenkinsApk" crossContext="true"         path="/JenkinsApk"/>
  • 下载安装Python和pip,依次配置环境变量。
    Python的安装及pip插件工具的安装,直接参照此博客即可:python 安装步骤博客

  • 安装图片支持插件Pillow和二维码生成库qrcode
    Pillow 就是Python Imaging Library(PIL)的进化版。Pillow由于更新版本的问题,使用普通插件安装命令可能会失败。在安装Pillow之前,确保pip能正常使用,最好是先随便找一个包安装一下。然后命令行输入 pip list 检查是否安装成功。

    安装Pillow
    命令1:pip install Pillow (失败)
    命令2:pip install -I --no-cache-dir -v Pillow (成功)
    至于为什么失败,解释颇多也不想深究。暂且都记上多试试。
    安装qrcode 命令:pip install myqr

    qrcode这个库还是初略看一下比较好,在README文件中有详细的安装使用说明。
    下载中途如果失败, 重新输入命令执行即可,网络不稳定容易出现超时,他没有自动重连机制。
    安装完成后,在Jenkins中配置Python全局变量。这样我们才能使用Python的脚本命令,入下图。
    进入 →系统管理 →系统设置 找到 Enviroment variables

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,填写如下配置

  • 接收者
    我在顶部的自定义参数中设置 有 EMAIL参数,所以这里引用即可。你也可以直接在这里填写邮件地址,一个或者多个。


    Paste_Image.png
  • 发送者和邮件内容
    下面发送者为,Jenkins 管理员邮箱
    Subject 和 Content 都是引用我们在系统设置中的配置内容。


    Paste_Image.png

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


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

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


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

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 140,081评论 20 594
  • 之前App在提交测试和最终部署的过程中App打包一直是由开发人员来完成的,由于项目比较大, 再加上Android打...
    南若水阅读 1,881评论 0 14
  • 作为一名Android程序猿,能偷懒时是一定要偷懒的。大家在开发中一定遇到过:测试说:帮我打个包吧,产品说:帮我打...
    小朱v阅读 4,423评论 2 9
  • JenKins 是什么? 理解:是一个集成各种插件,通过配置、管理 的本地Web,去自动化打包Android、IO...
    JxMY阅读 2,296评论 0 0
  • 你的生活,只有柴米油盐人间烟火,别人的生活,却仿佛充满风花雪月诗和远方。 别人的生活,你总恋恋不忘别人的生活,你在...
    书卷卷阅读 30评论 0 0