Android 使用 Jenkins 实现自动化打包【流程】&【踩坑】

引言

每个Android开发应该都有经历过正在码代码的时候突然被打断要求打个啥啥环境啥啥配置的安装包，然后就得暂存代码、切换分支、更改配置、等待build、balabala……往大了说就是浪费时间消耗员工价值对公司的不负责（胡扯），往小了说就是这TMD真的好烦啊（真实）。
如果可以将打包操作交给产品/测试/运维/XX呢？谁要安装包谁自己打去别来烦我。Then，就是自动化打包的事情了。自动化打包应该都有听说，感觉很高大上很难搞。然而实际操作后也就那么回事儿。下文将从头至尾图文并叙得记录过程和踩坑。

目录

#正文

1，下载 Jenkins

Jenkins 官网下载地址：https://jenkins.io/download/
选择你喜欢的对应你的操作系统的版本（我的是长期支持的Windows版本）

2，安装 Jenkins

下载后别BB直接安装就行。没啥好说的，安装目录想改就改，下一步就行。
安装好你的默认浏览器会自动弹出窗口链接：http://localhost:8080

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

安装插件。我们只用到2个插件，选择安装就好了。找到Gradle和Git（如果你是SVN，不用我说吧？），勾选后安装，相关的依赖插件会自动安装的。
下面几步就不截图了，并不是必要过程。
然后会让你创建管理员账号，选择继续使用admin就行（想创建也随你开心）。
继续，让你配置路径，也跳过就行（还是随你开心）。
已就绪，开始使用。
PS：如果上述安装插件的地方你没有安装需要的Gradle和Git插件，你也可以进入 Jenkins 环境页面后选择[系统管理] - [管理插件] - [可选插件]，然后去找/搜到对应插件安装。
PS：*本博就是本地配置一下试试，服务器上肯定是该创建账号、配置路径、安装需要的别的插件balabala。

3，配置 Jenkins

配置JDK、Git、Gradle：

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

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

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


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

4，新建任务并配置

选择自由风格，确定。

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

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

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


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

5，构建

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


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

6，参数化构建

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

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

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

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

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

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

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

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

踩坑

坑1：AAPT error

错误提示：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……
其实仔细看错误日志，会发现那一串错误都是好长的路径（共同点），所以这个说法显然站得住脚。

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

坑2：aidl is missing

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

结语

很多东西感觉很难，其实实践下来也就那么回事儿。事先少想点儿乱七八糟的，上去就是干。另外，Fxxk。