使用 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配置的过程,以及在配置过程中遇到的问题,自动化配置就算完成了。

你可能感兴趣的:(使用 Jenkins 实现Android自动化打包和踩坑经历)