每當(dāng)有項(xiàng)目做的過(guò)程中,測(cè)試需要做單元測(cè)試山憨,每次手動(dòng)的切換生產(chǎn)和測(cè)試環(huán)境,切換各種推送弥喉、統(tǒng)計(jì)和第三方賬號(hào)相當(dāng)?shù)穆闊┯艟梗瑫r(shí)還需要暫存代碼,切換分支深的太過(guò)繁瑣档桃。此時(shí)如果將項(xiàng)目配置自動(dòng)化打包了枪孩,那么就可以將這些問(wèn)題解決了。我們來(lái)看一下Jenkins的配置流程藻肄。
1.下載 Jenkins
Jenkins 官網(wǎng)下載地址:https://jenkins.io/download/,選擇你電腦對(duì)應(yīng)你的操作系統(tǒng)的版本
2.安裝 Jenkins
下載后直接安裝就行拒担,下一步就行嘹屯。安裝好你的默認(rèn)瀏覽器會(huì)自動(dòng)彈出窗口鏈接:http://localhost:8080
如圖,路徑都給了就不用多說(shuō)了从撼,找到對(duì)應(yīng)文件把里面的密碼復(fù)制粘貼上去州弟。繼續(xù)钧栖。
安裝插件。我們只用到2個(gè)插件婆翔,選擇安裝就好了拯杠。找到Gradle和Git,勾選后安裝啃奴,相關(guān)的依賴插件會(huì)自動(dòng)安裝的潭陪。
下面幾步就不截圖了,并不是必要過(guò)程最蕾。
然后會(huì)讓你創(chuàng)建管理員賬號(hào)依溯,選擇繼續(xù)使用admin就行。
繼續(xù)瘟则,讓你配置路徑黎炉,也跳過(guò)就行。
已就緒醋拧,開(kāi)始使用慷嗜。
說(shuō)明:如果上述安裝插件的地方你沒(méi)有安裝需要的Gradle和Git插件,你也可以進(jìn)入 Jenkins 環(huán)境頁(yè)面后選擇[系統(tǒng)管理] - [管理插件] - [可選插件]丹壕,然后去找/搜到對(duì)應(yīng)插件安裝洪添。
特別注意:這里就是本地配置一下試試,服務(wù)器上肯定是該創(chuàng)建賬號(hào)雀费、配置路徑干奢、安裝需要的別的插件balabala。
3.配置 Jenkins
配置JDK盏袄、Git忿峻、Gradle:
我的JDK路徑當(dāng)初安裝的時(shí)候不規(guī)范,打碼是為了防止誤導(dǎo)辕羽。
Git貌似不能自動(dòng)安裝逛尚,貌似默認(rèn)的不改動(dòng)也能用。有興趣可以試試刁愿。
Gradle配置同上绰寞,沒(méi)啥好說(shuō)的。
劃重點(diǎn) -- Android SDK需要另行配置铣口,見(jiàn)下圖
[系統(tǒng)管理] - [系統(tǒng)設(shè)置] - [全局屬性] - [環(huán)境變量]滤钱,對(duì)應(yīng)圖去找,添加環(huán)境變量脑题,鍵為“ANDROID_HOME”件缸,值指向SDK目錄。
以上叔遂,配置完成他炊。
4.新建任務(wù)并配置
選擇自由風(fēng)格争剿,確定。
基本信息里點(diǎn)擊右下角高級(jí)有個(gè)“使用自定義的工作空間”痊末,勾選可以指定目錄蚕苇,不勾選默認(rèn)在 Jenkins 安裝目錄下的 “workspace” 文件夾里。
源碼管理選擇Git凿叠,URL填入你的項(xiàng)目地址涩笤,沒(méi)有認(rèn)證的時(shí)候會(huì)報(bào)錯(cuò),點(diǎn)擊圖中圈出的“Add”幔嫂,彈出下圖:
添加憑證后下拉選擇對(duì)應(yīng)憑證辆它,如果正確則不會(huì)報(bào)錯(cuò),同時(shí)下方展示檢出分支履恩。默認(rèn)master分支锰茉,可以自己看情況指定某分支。
構(gòu)建觸發(fā)器不用管切心。
Tasks是構(gòu)建執(zhí)行的語(yǔ)句飒筑,一般都是“app:clean app:assembleRelease”,先clean再build绽昏。
構(gòu)建后操作看需求协屡,可以實(shí)現(xiàn)自動(dòng)上傳apk到蒲公英/fir、郵件通知等等全谤。
5.構(gòu)建
點(diǎn)擊立即構(gòu)建后會(huì)出現(xiàn)下圖進(jìn)度展示條肤晓。
藍(lán)色正常,build成功认然。紅色表明構(gòu)建失敗补憾,鼠標(biāo)移動(dòng)右側(cè)有個(gè)向下箭頭,點(diǎn)擊展開(kāi)選項(xiàng)卷员,點(diǎn)擊控制臺(tái)輸出可以查看錯(cuò)誤盈匾。
6.參數(shù)化構(gòu)建
構(gòu)建時(shí)可選參數(shù),這樣就可以打出不同參數(shù)的包毕骡。比如不同baseUrl削饵。
[添加參數(shù)] - [選項(xiàng)參數(shù)],或者你愿意用某種參數(shù)都行未巫。
參數(shù)化構(gòu)建配置上了窿撬,需要在構(gòu)建時(shí)將參數(shù)映射到代碼中,如下圖:
以上橱赠, Jenkins 上的參數(shù)化構(gòu)建配置完成尤仍。我們還需要在代碼中接收該參數(shù)。
參數(shù)會(huì)映射到
gradle.properties
文件中的對(duì)應(yīng)參數(shù)名狭姨,我們先在該文件中定義一個(gè)參數(shù)并賦默認(rèn)值:
baseUrl = "http://qa-xxxxxx.com/api/"
然后在build.gradle
中獲取該參數(shù)并添加到BuildConfig.java
中:
......
android {
......
defaultConfig {
......
buildConfigField "String", "baseUrl", baseUrl
}
......
}
......
代碼中可以直接獲取該參數(shù):
BuildConfig.baseUrl
以上配置后宰啦,項(xiàng)目會(huì)有所變化:
**遇到的坑 **
一。AAPT error
錯(cuò)誤提示:java.util.concurrent.ExecutionException: com.android.builder.internal.aapt.v2.Aapt2Exception: AAPT error: check logs for details
百度的解決方案有三種饼拍,一是說(shuō)在gradle.properties中加入代碼android.enableAapt2=false赡模,二是說(shuō)統(tǒng)一各module的compileSdkVersion、buildToolsVersion师抄、minSdkVersion漓柑、targetSdkVersion等,三就是更不相干的東西了叨吮。
這里我要說(shuō)一下辆布,各位的代碼本地肯定都是跑過(guò)的,編譯打包都正常茶鉴,只是上了 Jenkins 才報(bào)了這個(gè)錯(cuò)锋玲,這三個(gè)解決方案都站不住腳啊涵叮!理論上不應(yīng)該是代碼里的啥問(wèn)題安氧濉!割粮!
最后在某不存在的搜索引擎找到個(gè)說(shuō)法盾碗,Gradle路徑太長(zhǎng)了導(dǎo)致編譯錯(cuò)誤balabala……
其實(shí)仔細(xì)看錯(cuò)誤日志,會(huì)發(fā)現(xiàn)那一串錯(cuò)誤都是好長(zhǎng)的路徑(共同點(diǎn))舀瓢,所以這個(gè)說(shuō)法比較靠譜廷雅。
項(xiàng)目設(shè)置里的構(gòu)建處,點(diǎn)擊右下角高級(jí)京髓,找到下方此選項(xiàng)打勾航缀。
再次構(gòu)建,BUILD SUCCESSFUL朵锣。
二谬盐。aidl is missing
問(wèn)題發(fā)生在我部署到服務(wù)器的時(shí)候,先是提示說(shuō)少build-tools诚些,然后說(shuō)少對(duì)應(yīng)版本的sdk飞傀,挨個(gè)上傳服務(wù)器sdk目錄。然后就報(bào)了這個(gè)錯(cuò)诬烹。但是本地都是正常的砸烦,sdk沒(méi)問(wèn)題,沒(méi)理由到服務(wù)器上就不行了啊绞吁。
這里我要譴責(zé)一下運(yùn)維同事幢痘,他堅(jiān)定的告訴我服務(wù)器上的sdk是從另一個(gè)Android同事那里copy上傳的(windows),但后來(lái)發(fā)現(xiàn)是他自己down的(linux)家破。找該Android同事詢問(wèn)颜说,得到的回復(fù)是“我不知道啊”购岗、“你百度看看”。:)
折騰了很久才定位到這個(gè)問(wèn)題门粪,服務(wù)器是Linux環(huán)境喊积,本地是Windows環(huán)境,sdk是分版本的玄妈。不同版本的sdk下的文件不一致乾吻,導(dǎo)致錯(cuò)誤。
以上就是Jenkins配置的過(guò)程拟蜻,以及在配置過(guò)程中遇到的問(wèn)題绎签,自動(dòng)化配置就算完成了。