android 自动构建,利用Jenkins进行Android自动化构建

前言

搭建流程如下

Jenkins的下载和运行

Android环境配置

创建Android项目及项目build配置

构建项目

结束语

环境都是在Mac上配置的，Window上的配置还没试，有时间再研究啦。

Jenkins的下载和运行

Jenkins下载

Jenkins它是基于Java的独立程序，所以呢，你电脑上如果配置了java环境，理论上都是可以运行,引用官网上的话：

Jenkins 是一个基于 Java 的独立程序，可以立即运行，包含 Windows、Mac OS X 和其他类 Unix 操作系统。

Jenkins的安装方式有好几种；各个系统对应的安装包、通过Docker镜像、war包等。对比了一下感觉war形式的好像便捷一些，果断用这种方式(主要还是懒)。先去下载Jenkins的war包。

在Jenkins官网，有各种安装方式的包,因为我们要用war包的形式嘛，所以下载它，下图红框圈的就是：

不知道什么原因，这个war它也不大(60M左右)，但是下载的奇慢，得下载数小时，差评!

运行Jenkins

下载完以后，就可以愉快的运行了，下载下来的这个包你随便放置，执行的时候你能找到就行。接着我们打开终端，开始运行：

输入java -jar jenkins.war

注意这行命令得是在jenkins.war当前的目录下运行,不然找不到。

在运行过程中，你可能会看到这样一段话：

这个密码你现在可以先粘贴出来后面要用，当然，如果你觉得不方便，也可以在用到的时候再去找，后面还会有提示，等他默默的运行起来之后，我们就可以开始浏览jenkins了。

打开浏览器，在地址栏输入localhost:8080就能开始我们的jenkins之旅了。如果一切正常的话，首先看到的会是下面这个界面 解锁jenkins：

上面让输入管理员密码，就是上面说的那一串密码，粘出来贴上去，如果找不到，上面提供了查看路径(那一行红字)进去看再粘贴出来就行了。

点continue，等一会儿，就会出来下一个界面，让选择安装插件，我们是新手，就选第一个推荐安装，放个图片：

接着就是漫长的等待，会装不少插件，装插件的界面：

等它装完后，会跳转到一个填写账号密码的界面，这里填的账号就是以后我们登录的账号了

按照提示的信息，每一项都填写好，保存就好了，成功后会有页面提示。至此jenkins的安装工作告一段落，接下来就可以配置一些环境和创建项目了。

配置Android编译环境

进入到jenkins界面后，我们先不急着创建项目，先去配置环境，在界面的左侧导航栏，找到Manager Jenkins接着在列表第四项找到Global Tool Configuration，点进去可以配置Java JDK和Gradle的环境,如下图:

配置java JDK：

1、名称：随意写，没有特殊规定

2、路径：本地java JDK的路径

这里说一下这个JDK路径，macOS本身带有java的环境，可以直接使用，可能不是最新的包，你可以选择升级，我们这里要填写的就是这个路径。如果你本地配置过java的环境变量(配置环境变量这里就不说了，网上很多，搜一哈)，打开.bash_profile文件，找到JAVA_HOME对应的路径，复制出来放在这里就好。

打开命令 open ~/.bash_profile

你的配置信息可能是这样的，圈住的就是我们需要的路径：

如果本地的JDK 不知道在哪个位置，就使用下面的方式查看：

终端输入/usr/libexec/java_home -V,你会看到下面的信息：

从箭头指向的位置开始到结束，这个就是我们要配置的路径，如果你安装了多个JDK，会显示多个的信息，使用任何一个都可以，看你选择。

配置Gradle：

1、名称：随意写，没有特殊规定

2、路径：gradle的路径

查找gradle路径

方法一

gradle的位置在Android studio3.5之前，可以按照

应用程序 --> android studio --> 右键 --> 显示包内容 --> Contents --> gradle

找到gradle对应的位置，然后选择想要使用的gradle的版本，路径粘贴可以按以下操作：

选中文件-->右键-->显示简介-->位置

将位置处所对应的路径粘贴出来；或者你可以把选择的gradle版本文件夹拖拽到终端里面，然后复制出全路径，放到我们图中2的位置。

方法二

另外一种方式是，打开本地的.gradle，从里面获取想要构建使用的gradle版本。由于.gradle文件默认是隐藏的，所以我们操作前需要先显示出隐藏文件。操作方式如下:

显示隐藏文件快捷键：command⌘ + shift⇧ + .(此操作在用户的的根目录下进行)

找到.gradle文件后，按如下操作：

.gradle --> wrapper --> dists --> 你的gradle列表

按照上面的操作一层一层的进入到你的gradle列表里面，选择你中意的版本，按照方法一种的两种方法，复制出路径，放在图中2的位置。

方法三

如果觉得上面两个方法太繁琐，可以在配置中，根据自己项目的需求下载gradle,如图所示：

写好名字，选中Install automatically，选择gradle版本，这样在项目构建的时候，用到的就是下载的gradle版本。

到这里我们的gradle路径也配置好了，点击sava保存就行了。

配置Android SDK

配置Android SDK和上面两个配置不在同一个界面。回退到jenkins的设置界面，点击Configure System，进入设置界面，找到Global properties属性，勾选Environment variables，填写上名称和对应的Android SDK的路径：

1、勾选Environment variables属性

2、填写名字

3、填写SDK的路径

SDK的路径也很好找，我们打开Android studio编辑器，在顶部的工具栏，找到SDK Manager按钮

点击，就会显示Android所有的SDK版本，里面有些我们下载了，有的没下载，但是我们关注的不是这个，关注的是红框圈住的这个路径，复制出来，放在2的位置，如下：

到这里我们Android的运行环境差不多就配置好了，接下来就可以创建项目了。

创建Android项目及项目build配置

创建项目

准备工作都做完了，接下来开始创建项目，回到主页面。按图所示：

在项目上只需要写上名称即可，选择Freestyle project，保存。项目就创建完成了。接着进入到我们创建好的项目中，进行各项的配置

项目配置

General(常规配置)

进入到项目看到的第一项是general选项，看图：

我们目前先把项目配置好，能跑起来；后面章节再说参数化构建相关的东西。这里只填写一下描述信息。

SCM(Source Code Management)

接着是SCM模块，先上图：

这里主要设置构建项目的仓库地址，可以选择svn和git两种，我们这里以svn为例；分别填写svn的项目地址 ，和选择svn账号；默认svn账号的位置是空，需要点击Add按钮添加：

分别添加上你的账号和密码。保存之后就可以在前面界面上选中了。地址、svn账号都填写完，其他的选项保持默认就好，不需要另外操作。

再接着往下的两个标签Build Triggers,Build Environment暂时不做其他填写，保持默认就好。

Build

这一步是指定Gradle版本用来构建项目的，先点击Add build step按钮添加：

选择Invoke Gradle script选项，接着会看到下面要填写的选项

Gradle Version选项就是我们刚才在上面配置的gradle，选择你刚才命名的gradle名称，接着在

Tasks选项中，写上我们想要执行的gradle命令；这里需要注意一下，不要勾选Use Gradle Wrapper虽然Tasks是在它下方，但不属于它里面的一个选项：

Tasks中的命令就相当于我们在项目的终端输入的命令一样；

比如想要构建项目的debug版本：

assembleDebug

正式版：

assembleRelease

当然如果你在项目中配置了Flavors多渠道打包，在这里也是一样可以在Tasks中编辑。比如我配置了小米和华为渠道，在Flavors中的命名分别是xiaomi和huawei，那么在Tasks中命名就是：

assembleXiaomiRelease和assembleHuaweiRelease。

关于Flavors配置多渠道相关问题这里不多赘述，有兴趣可以参考下面这篇文章：

到这里我们的项目配置就完成了，点击保存按钮，接着就是最后一步构建了。

构建项目

保存完成后，跳转到项目的菜单页面，点击立即构建按钮，项目就开始运行啦：

在构建的过程中，如果想看控制台日志，可以选择正在构建的项目，每次构建的版本都在这里罗列。

点击后面的小三角有下拉列表，选择Console Output点进去，就是项目的构建日志了。

等待项目构建完成，如果看到下面熟悉的信息，那么我们的项目就构建成功了。

如果项目项目未构建成功，log中也会给出对应的提示，需要我们按需解决。

工作空间

构建成功，打的包在Work space列表中。

点开后可以看到，和我们的Android studio中的目录结构是一样的，构建成功的文件也在build文件中，这里不再展开叙述。

结束语

以上就是Jenkins下载安装、环境配置和创建Android项目的过程，介绍了基本的构建方式，后续有时间会介绍如何进行参数化构建，让jenkins有更多的玩法。