搭建持續(xù)集成打包平臺的方案分析
該平臺主要實現(xiàn)的功能有3點:
定期對GitHub倉庫進行檢測,若有更新則自動執(zhí)行構(gòu)建打包;構(gòu)建成功后根據(jù)ipa/apk生成二維碼,并可在歷史構(gòu)建列表中展示各個版本的二維碼,通過手機掃描二維碼可直接安裝對應(yīng)版本;在構(gòu)建結(jié)果頁面中展示當次構(gòu)建的成果物(Artifact,如.ipa、.app、.apk、info.plist等文件),供有需要的用戶進行下載。
接下來,本文就開始對平臺建設(shè)的完整實現(xiàn)過程進行詳細介紹。
安裝Jenkins
Jenkins依賴于Java運行環(huán)境,因此需要首先安裝Java。
安裝Jenkins的方式有多種,可以運行對應(yīng)系統(tǒng)類型的安裝包,可以通過docker獲取鏡像,也可以直接運行war包。
我個人傾向于直接運行war包的形式,只需下載jenkins.war后,運行如下命令即可啟動Jenkins。
$ nohup java -jar jenkins_located_path/jenkins.war --httpPort=88 &
如果不指定httpPort,Jenkins的默認端口為8080。
Jenkins插件
Jenkins有非常多的插件,可以實現(xiàn)各種功能的擴展。
針對搭建的iOS/Android持續(xù)集成打包平臺,我使用到了如下幾個插件。
GIT pluginSSH Credentials PluginGit Changelog Plugin: 獲取倉庫提交的commit logbuild-name-setter:用于修改Build名稱deion setter plugin:用于在修改Build描述信息,在描述信息中增加顯示QRCode(二維碼)Post-Build Plug-in:在編譯完成后通過執(zhí)行腳本實現(xiàn)一些額外功能
Xcode integration: iOS專用(可選)Gradle plugin: Android專用(可選)
安裝方式也比較簡單,直接在Jenkins的插件管理頁面搜索上述插件,點擊安裝即可。
創(chuàng)建項目(Job)
在Jenkins中,構(gòu)建項目以Job的形式存在,因此需要針對每個項目創(chuàng)建一個Job。有時候,一個項目中可能有多個分支同時在進行開發(fā),為了分別進行構(gòu)建,也可以針對每個分支創(chuàng)建一個Job。
創(chuàng)建Job的方式有多種,本次只需要創(chuàng)建Freestyle project類型的即可。
Main page -》 New Item -》 Freestyle project
對于一個持續(xù)集成打包平臺,每次打包都由4步組成:觸發(fā)構(gòu)建、拉取代碼、執(zhí)行構(gòu)建、構(gòu)建后處理。對應(yīng)的,在每個Job中也對應(yīng)了這幾項的配置。
配置Git代碼倉庫
要對項目進行構(gòu)建,配置項目的代碼倉庫是必不可少的。由于當前我們的項目托管在GitHub私有倉庫中,因此在此需要對Git進行配置。
在【Source Code Management】配置欄目下,如果之前GIT plugin安裝成功,則會出現(xiàn)Git選項。
配置Git代碼倉庫時,有三項是必須配置的:倉庫URL地址(Repository URL)、倉庫權(quán)限校驗方式(Credentials),以及當前Job需要構(gòu)建的代碼分支(Branches to build)。
在配置Repository URL時,選擇HTTPS URL或SSH URL均可。不過需要注意的是,Credentials要和Repository URL對應(yīng),也就是說:
如果Repository URL是HTTPS URL形式的,那么Credentials就要采用GitHub用戶名密碼的校驗方式;而且,如果在GitHub中開啟了2FA(two-factor authentication),那么還需要在GitHub中創(chuàng)建一個Personal access token,輸入密碼時將這個Personal access token作為密碼進行輸入。如果Repository URL是SSH URL形式的,那么就需要先在Jenkins所在的服務(wù)器上創(chuàng)建一個SSH秘鑰對,并將公鑰添加到GitHub的SSH keys中,然后在填寫Credentials時,選擇SSH Username with private key的校驗方式,填入GitHub Username、SSH私鑰、以及創(chuàng)建SSH秘鑰對時設(shè)置的Passphrase。
如果對Git權(quán)限校驗的概念還比較模糊,可以參考《深入淺出Git權(quán)限校驗》。
在配置Branches to build時,可以采用多種形式,包括分支名稱(branchName)、tagName、commitId等。其中分支名稱的形式用的最多,例如,若是構(gòu)建master分支,則填寫refs/heads/master,若是構(gòu)建develop分支,則填寫refs/heads/develop。
除了以上關(guān)于Git的必填配置項,有時根據(jù)項目的實際情況,可能還需要對Jenkins的默認配置項進行修改。
比較常見的一種情況就是對clone的配置進行修改。
在Jenkins的默認配置中,clone代碼時會拉取所有歷史版本的代碼,而且默認的超時時限只有10分鐘。這就造成在某些項目中,由于代碼量本身就比較大,歷史版本也比較多,再加上網(wǎng)絡(luò)環(huán)境不是特別好,Jenkins根本沒法在10分鐘之內(nèi)拉取完所有代碼,超時后任務(wù)就會被自動終止了(錯誤狀態(tài)碼143)。
這種問題的解決方式也很簡單,無非就是兩種思路,要么少拉取點代碼(不獲取歷史版本),要么提高超時時限。對應(yīng)的配置在Advanced clone behaviours中:
Shallow clone:勾選后不獲取歷史版本;Timeout (in minutes) for clone and fetch operation:配置后覆蓋默認的超時時限。
配置構(gòu)建觸發(fā)器
代碼倉庫配置好了,意味著Jenkins具有了訪問GitHub代碼倉庫的權(quán)限,可以成功地拉取代碼。
那Jenkins什么時候執(zhí)行構(gòu)建呢?
這就需要配置構(gòu)建觸發(fā)策略,即構(gòu)建觸發(fā)器,配置項位于【Build Triggers】欄目。
觸發(fā)器支持多種類型,常用的有:
定期進行構(gòu)建(Build periodically)根據(jù)提交進行構(gòu)建(Build when a change is pushed to GitHub)定期檢測代碼更新,如有更新則進行構(gòu)建(Poll SCM)
構(gòu)建觸發(fā)器的選擇為復(fù)合選項,若選擇多種類型,則任一類型滿足構(gòu)建條件時就會執(zhí)行構(gòu)建工作。如果所有類型都不選擇,則該Jenkins Job不執(zhí)行自動構(gòu)建,但可通過手動點擊【Build Now】觸發(fā)構(gòu)建。
關(guān)于定時器(Schedule)的格式,簡述如下:
MINUTE HOUR DOM MONTH DOW
MINUTE: Minutes within the hour (0-59)HOUR: The hour of the day (0-23)DOM: The day of the month (1-31)MONTH: The month (1-12)DOW: The day of the week (0-7) where 0 and 7 are Sunday.
通常情況下需要指定多個值,這時可以采用如下operator(優(yōu)先級從上到下):
適配所有有效的值: * ,若不指定某一項,則以 * 占位;M-N適配值域范圍,例如7-9代表7/8/9均滿足;M-N/X或*/X:以X作為間隔;A,B,C:枚舉多個值。
另外,為了避免多個任務(wù)在同一時刻同時觸發(fā)構(gòu)建,在指定時間段時可以配合使用H字符。添加H字符后,Jenkins會在指定時間段內(nèi)隨機選擇一個時間點作為起始時刻,然后加上設(shè)定的時間間隔,計算得到后續(xù)的時間點。直到下一個周期時,Jenkins又會重新隨機選擇一個時間點作為起始時刻,依次類推。
為了便于理解,列舉幾個示例:
H/15 * * * *:代表每隔15分鐘,并且開始時間不確定,這個小時可能是:07,:22,:37,:52,下一個小時就可能是:03,:18,:33,:48;H(0-29)/10 * * * *:代表前半小時內(nèi)每隔10分鐘,并且開始時間不確定,這個小時可能是:04,:14,:24,下一個小時就可能是:09,:19,:29;H 23 * * 1-5:工作日每晚23:00至23:59之間的某一時刻;
配置構(gòu)建方式
觸發(fā)策略配置好之后,Jenkins就會按照設(shè)定的策略自動執(zhí)行構(gòu)建。但如何執(zhí)行構(gòu)建操作,這還需要我們通過配置構(gòu)建方式來進行設(shè)定。
常用的構(gòu)建方式是根據(jù)構(gòu)建對象的具體類型,安裝對應(yīng)的插件,然后采用相應(yīng)的構(gòu)建方式。例如,若是構(gòu)建Android應(yīng)用,安裝Gradle plugin之后,就可以選擇Invoke Gradle ,然后采用Gradle進行構(gòu)建;若是構(gòu)建iOS應(yīng)用,安裝Xcode integration插件之后,就可以選擇Xcode,然后選擇Xcode進行構(gòu)建。
該種方式的優(yōu)勢是操作簡單,UI可視化,在場景不復(fù)雜的情況下可以快速滿足需求。不過缺點就是依賴于插件已有的功能,如果場景較復(fù)雜時可能單個插件還無法滿足需求,需要再安裝其它插件。而且,有些插件可能還存在一些問題,例如對某些操作系統(tǒng)版本或XCode版本兼容不佳,出現(xiàn)問題時我們就會比較被動。
我個人更傾向于另外一種方式,就是自己編寫打包腳本,在腳本中自定義實現(xiàn)所有的構(gòu)建功能,然后在Execute Shell中執(zhí)行。這種方式的靈活度更高,各種場景的構(gòu)建需求都能滿足,出現(xiàn)問題后也能自行快速修復(fù)。
另外,對于iOS應(yīng)用的構(gòu)建,還有一個需要額外關(guān)注的點,就是開發(fā)者證書的配置。
如果是采用Xcode integration插件進行構(gòu)建,配置會比較復(fù)雜,需要在Jenkins中導(dǎo)入開發(fā)證書,并填寫多個配置項。不過,如果是采用打包腳本進行構(gòu)建的話,情況就會簡單許多。只要在Jenkins所運行的計算機中安裝好開發(fā)者證書,打包命令在Shell中能正常工作,那么在Jenkins中執(zhí)行打包腳本也不會有什么問題。
構(gòu)建后處理
完成構(gòu)建后,生成的編譯成果物(ipa/apk)會位于指定的目錄中。但是,如果要直接在手機中安裝ipa/apk文件還比較麻煩,不僅在分發(fā)測試包時需要將好幾十兆的安裝包進行傳送,體驗用戶在安裝時也還需要通過數(shù)據(jù)線將手機與計算機進行連接,然后再使用PP助手或豌豆莢等工具進行安裝。
非常好我支持^.^
(0) 0%
不好我反對
(0) 0%
下載地址
搭建持續(xù)集成打包平臺的方案分析下載
相關(guān)電子資料下載
- iOS17.1可能明天發(fā)布,iOS17.1主要修復(fù)哪些問題? 380
- 社區(qū)說|多才多藝: 探索 Android 應(yīng)用更多可能 13
- 浩辰軟件正式登陸上交所科創(chuàng)板 274
- 鴻蒙原生應(yīng)用,對開發(fā)者意味著什么? 77
- Android端自定義鈴聲 MobPush對安卓端自定義鈴聲的教程 531
- Android推送問題排查技巧 針對MobPush安卓端推送問題的解決辦法 54
- 如何使用Proxyman抓取Android的https請求? 43
- 基于OkHttp 3.10.0的源碼案例解析 26
- 基于MacroBenchmark的性能測試量化指標方案 77
- 圖像放大為什么還能保持清晰度 圖像縮放的原理是什么 45