使用 Jenkins 实现Android自动化打包和踩坑经历

每当有项目做的过程中，测试需要做单元测试，每次手动的切换生产和测试环境，切换各种推送、统计和第三方账号相当的麻烦，同时还需要暂存代码，切换分支深的太过繁琐。此时如果将项目配置自动化打包了，那么就可以将这些问题解决了。我们来看一下Jenkins的配置流程。

1.下载 Jenkins

Jenkins 官网下载地址：https://jenkins.io/download/，选择你电脑对应你的操作系统的版本

Jenkins 下载截图

2.安装 Jenkins

下载后直接安装就行，下一步就行。安装好你的默认浏览器会自动弹出窗口链接：http://localhost:8080

入门

如图，路径都给了就不用多说了，找到对应文件把里面的密码复制粘贴上去。继续。

新手入门

安装插件。我们只用到2个插件，选择安装就好了。找到Gradle和Git，勾选后安装，相关的依赖插件会自动安装的。
下面几步就不截图了，并不是必要过程。
然后会让你创建管理员账号，选择继续使用admin就行。
继续，让你配置路径，也跳过就行。
已就绪，开始使用。
说明：如果上述安装插件的地方你没有安装需要的Gradle和Git插件，你也可以进入 Jenkins 环境页面后选择[系统管理] - [管理插件] - [可选插件]，然后去找/搜到对应插件安装。

特别注意：这里就是本地配置一下试试，服务器上肯定是该创建账号、配置路径、安装需要的别的插件balabala。

3.配置 Jenkins

全局工具配置

配置需要的插件信息

配置JDK、Git、Gradle：

配置JDK信息

我的JDK路径当初安装的时候不规范，打码是为了防止误导。

Git配置

Git貌似不能自动安装，貌似默认的不改动也能用。有兴趣可以试试。

Gradle配置

Gradle配置同上，没啥好说的。
划重点 -- Android SDK需要另行配置，见下图

系统配置

环境变量

[系统管理] - [系统设置] - [全局属性] - [环境变量]，对应图去找，添加环境变量，键为“ANDROID_HOME”，值指向SDK目录。
以上，配置完成。

4.新建任务并配置

新建任务

自由风格

选择自由风格，确定。

基本信息

基本信息里点击右下角高级有个“使用自定义的工作空间”，勾选可以指定目录，不勾选默认在 Jenkins 安装目录下的 “workspace” 文件夹里。

源码管理

源码管理选择Git，URL填入你的项目地址，没有认证的时候会报错，点击图中圈出的“Add”，弹出下图：

Add

添加凭证后下拉选择对应凭证，如果正确则不会报错，同时下方展示检出分支。默认master分支，可以自己看情况指定某分支。
构建触发器不用管。

构建

构建2

Tasks是构建执行的语句，一般都是“app:clean app:assembleRelease”，先clean再build。
构建后操作看需求，可以实现自动上传apk到蒲公英/fir、邮件通知等等。

5.构建

![构建](https://upload-images.jianshu.io/upload_images/6653666-e5645d8f9363e464?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240

点击立即构建后会出现下图进度展示条。

构建后进度条

成功失败

蓝色正常，build成功。红色表明构建失败，鼠标移动右侧有个向下箭头，点击展开选项，点击控制台输出可以查看错误。

6.参数化构建

构建时可选参数，这样就可以打出不同参数的包。比如不同baseUrl。

参数化构建

[添加参数] - [选项参数]，或者你愿意用某种参数都行。

选项参数

参数化构建配置上了，需要在构建时将参数映射到代码中，如下图：

导入代码

以上， Jenkins 上的参数化构建配置完成。我们还需要在代码中接收该参数。
参数会映射到gradle.properties文件中的对应参数名，我们先在该文件中定义一个参数并赋默认值：

baseUrl = "http://qa-xxxxxx.com/api/"

然后在build.gradle中获取该参数并添加到BuildConfig.java中：

......
android {
    ......
    defaultConfig {
        ......
        buildConfigField "String", "baseUrl", baseUrl
    }
    ......
}
......

BuildConfig.java

代码中可以直接获取该参数：BuildConfig.baseUrl
以上配置后，项目会有所变化：

Build with Parameters

**遇到的坑 **

一。AAPT error

错误日志1

错误提示：java.util.concurrent.ExecutionException: com.android.builder.internal.aapt.v2.Aapt2Exception: AAPT error: check logs for details
百度的解决方案有三种，一是说在gradle.properties中加入代码android.enableAapt2=false，二是说统一各module的compileSdkVersion、buildToolsVersion、minSdkVersion、targetSdkVersion等，三就是更不相干的东西了。
这里我要说一下，各位的代码本地肯定都是跑过的，编译打包都正常，只是上了 Jenkins 才报了这个错，这三个解决方案都站不住脚啊！理论上不应该是代码里的啥问题啊！！
最后在某不存在的搜索引擎找到个说法，Gradle路径太长了导致编译错误balabala……
其实仔细看错误日志，会发现那一串错误都是好长的路径（共同点），所以这个说法比较靠谱。

GRADLE_USER_HOME

项目设置里的构建处，点击右下角高级，找到下方此选项打勾。
再次构建，BUILD SUCCESSFUL。

二。aidl is missing

问题发生在我部署到服务器的时候，先是提示说少build-tools，然后说少对应版本的sdk，挨个上传服务器sdk目录。然后就报了这个错。但是本地都是正常的，sdk没问题，没理由到服务器上就不行了啊。
这里我要谴责一下运维同事，他坚定的告诉我服务器上的sdk是从另一个Android同事那里copy上传的（windows），但后来发现是他自己down的（linux）。找该Android同事询问，得到的回复是“我不知道啊”、“你百度看看”。：）
折腾了很久才定位到这个问题，服务器是Linux环境，本地是Windows环境，sdk是分版本的。不同版本的sdk下的文件不一致，导致错误。

以上就是Jenkins配置的过程，以及在配置过程中遇到的问题，自动化配置就算完成了。