每当有项目做的过程中,测试需要做单元测试,每次手动的切换生产和测试环境,切换各种推送、统计和第三方账号相当的麻烦,同时还需要暂存代码,切换分支深的太过繁琐。此时如果将项目配置自动化打包了,那么就可以将这些问题解决了。我们来看一下Jenkins的配置流程。
1.下载 Jenkins
Jenkins 官网下载地址:https://jenkins.io/download/,选择你电脑对应你的操作系统的版本
2.安装 Jenkins
下载后直接安装就行,下一步就行。安装好你的默认浏览器会自动弹出窗口链接:http://localhost:8080
如图,路径都给了就不用多说了,找到对应文件把里面的密码复制粘贴上去。继续。
安装插件。我们只用到2个插件,选择安装就好了。找到Gradle和Git,勾选后安装,相关的依赖插件会自动安装的。
下面几步就不截图了,并不是必要过程。
然后会让你创建管理员账号,选择继续使用admin就行。
继续,让你配置路径,也跳过就行。
已就绪,开始使用。
说明:如果上述安装插件的地方你没有安装需要的Gradle和Git插件,你也可以进入 Jenkins 环境页面后选择[系统管理] - [管理插件] - [可选插件],然后去找/搜到对应插件安装。
特别注意:这里就是本地配置一下试试,服务器上肯定是该创建账号、配置路径、安装需要的别的插件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
以上配置后,项目会有所变化:
**遇到的坑 **
一。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。
二。aidl is missing
问题发生在我部署到服务器的时候,先是提示说少build-tools,然后说少对应版本的sdk,挨个上传服务器sdk目录。然后就报了这个错。但是本地都是正常的,sdk没问题,没理由到服务器上就不行了啊。
这里我要谴责一下运维同事,他坚定的告诉我服务器上的sdk是从另一个Android同事那里copy上传的(windows),但后来发现是他自己down的(linux)。找该Android同事询问,得到的回复是“我不知道啊”、“你百度看看”。:)
折腾了很久才定位到这个问题,服务器是Linux环境,本地是Windows环境,sdk是分版本的。不同版本的sdk下的文件不一致,导致错误。
以上就是Jenkins配置的过程,以及在配置过程中遇到的问题,自动化配置就算完成了。