該平臺(tái)主要實(shí)現(xiàn)的功能有3點(diǎn)：

　　定期對(duì)GitHub倉庫進(jìn)行檢測(cè)，若有更新則自動(dòng)執(zhí)行構(gòu)建打包；構(gòu)建成功后根據(jù)ipa/apk生成二維碼，并可在歷史構(gòu)建列表中展示各個(gè)版本的二維碼，通過手機(jī)掃描二維碼可直接安裝對(duì)應(yīng)版本；在構(gòu)建結(jié)果頁面中展示當(dāng)次構(gòu)建的成果物（Artifact，如.ipa、.app、.apk、info.plist等文件），供有需要的用戶進(jìn)行下載。

　　接下來，本文就開始對(duì)平臺(tái)建設(shè)的完整實(shí)現(xiàn)過程進(jìn)行詳細(xì)介紹。

　　安裝Jenkins

　　Jenkins依賴于Java運(yùn)行環(huán)境，因此需要首先安裝Java。

　　安裝Jenkins的方式有多種，可以運(yùn)行對(duì)應(yīng)系統(tǒng)類型的安裝包，可以通過docker獲取鏡像，也可以直接運(yùn)行war包。

　　我個(gè)人傾向于直接運(yùn)行war包的形式，只需下載jenkins.war后，運(yùn)行如下命令即可啟動(dòng)Jenkins。

　　$ nohup java -jar jenkins_located_path/jenkins.war --httpPort=88 &

　　如果不指定httpPort，Jenkins的默認(rèn)端口為8080。

　　Jenkins插件

　　Jenkins有非常多的插件，可以實(shí)現(xiàn)各種功能的擴(kuò)展。

　　針對(duì)搭建的iOS/Android持續(xù)集成打包平臺(tái)，我使用到了如下幾個(gè)插件。

　　GIT pluginSSH Credentials PluginGit Changelog Plugin： 獲取倉庫提交的commit logbuild-name-setter：用于修改Build名稱deion setter plugin：用于在修改Build描述信息，在描述信息中增加顯示QRCode（二維碼）Post-Build Plug-in：在編譯完成后通過執(zhí)行腳本實(shí)現(xiàn)一些額外功能

　　Xcode integration： iOS專用（可選）Gradle plugin： Android專用（可選）

　　安裝方式也比較簡單，直接在Jenkins的插件管理頁面搜索上述插件，點(diǎn)擊安裝即可。

　　創(chuàng)建項(xiàng)目（Job）

　　在Jenkins中，構(gòu)建項(xiàng)目以Job的形式存在，因此需要針對(duì)每個(gè)項(xiàng)目創(chuàng)建一個(gè)Job。有時(shí)候，一個(gè)項(xiàng)目中可能有多個(gè)分支同時(shí)在進(jìn)行開發(fā)，為了分別進(jìn)行構(gòu)建，也可以針對(duì)每個(gè)分支創(chuàng)建一個(gè)Job。

　　創(chuàng)建Job的方式有多種，本次只需要?jiǎng)?chuàng)建Freestyle project類型的即可。

　　Main page -》 New Item -》 Freestyle project

　　對(duì)于一個(gè)持續(xù)集成打包平臺(tái)，每次打包都由4步組成：觸發(fā)構(gòu)建、拉取代碼、執(zhí)行構(gòu)建、構(gòu)建后處理。對(duì)應(yīng)的，在每個(gè)Job中也對(duì)應(yīng)了這幾項(xiàng)的配置。

　　配置Git代碼倉庫

　　要對(duì)項(xiàng)目進(jìn)行構(gòu)建，配置項(xiàng)目的代碼倉庫是必不可少的。由于當(dāng)前我們的項(xiàng)目托管在GitHub私有倉庫中，因此在此需要對(duì)Git進(jìn)行配置。

　　在【Source Code Management】配置欄目下，如果之前GIT plugin安裝成功，則會(huì)出現(xiàn)Git選項(xiàng)。

　　配置Git代碼倉庫時(shí)，有三項(xiàng)是必須配置的：倉庫URL地址（Repository URL）、倉庫權(quán)限校驗(yàn)方式（Credentials），以及當(dāng)前Job需要構(gòu)建的代碼分支（Branches to build）。

　　在配置Repository URL時(shí)，選擇HTTPS URL或SSH URL均可。不過需要注意的是，Credentials要和Repository URL對(duì)應(yīng)，也就是說：

　　如果Repository URL是HTTPS URL形式的，那么Credentials就要采用GitHub用戶名密碼的校驗(yàn)方式；而且，如果在GitHub中開啟了2FA（two-factor authentication），那么還需要在GitHub中創(chuàng)建一個(gè)Personal access token，輸入密碼時(shí)將這個(gè)Personal access token作為密碼進(jìn)行輸入。如果Repository URL是SSH URL形式的，那么就需要先在Jenkins所在的服務(wù)器上創(chuàng)建一個(gè)SSH秘鑰對(duì)，并將公鑰添加到GitHub的SSH keys中，然后在填寫Credentials時(shí)，選擇SSH Username with private key的校驗(yàn)方式，填入GitHub Username、SSH私鑰、以及創(chuàng)建SSH秘鑰對(duì)時(shí)設(shè)置的Passphrase。

　　如果對(duì)Git權(quán)限校驗(yàn)的概念還比較模糊，可以參考《深入淺出Git權(quán)限校驗(yàn)》。

　　在配置Branches to build時(shí)，可以采用多種形式，包括分支名稱（branchName）、tagName、commitId等。其中分支名稱的形式用的最多，例如，若是構(gòu)建master分支，則填寫refs/heads/master，若是構(gòu)建develop分支，則填寫refs/heads/develop。

　　除了以上關(guān)于Git的必填配置項(xiàng)，有時(shí)根據(jù)項(xiàng)目的實(shí)際情況，可能還需要對(duì)Jenkins的默認(rèn)配置項(xiàng)進(jìn)行修改。

　　比較常見的一種情況就是對(duì)clone的配置進(jìn)行修改。

　　在Jenkins的默認(rèn)配置中，clone代碼時(shí)會(huì)拉取所有歷史版本的代碼，而且默認(rèn)的超時(shí)時(shí)限只有10分鐘。這就造成在某些項(xiàng)目中，由于代碼量本身就比較大，歷史版本也比較多，再加上網(wǎng)絡(luò)環(huán)境不是特別好，Jenkins根本沒法在10分鐘之內(nèi)拉取完所有代碼，超時(shí)后任務(wù)就會(huì)被自動(dòng)終止了（錯(cuò)誤狀態(tài)碼143）。

　　這種問題的解決方式也很簡單，無非就是兩種思路，要么少拉取點(diǎn)代碼（不獲取歷史版本），要么提高超時(shí)時(shí)限。對(duì)應(yīng)的配置在Advanced clone behaviours中：

　　Shallow clone：勾選后不獲取歷史版本；Timeout （in minutes） for clone and fetch operation：配置后覆蓋默認(rèn)的超時(shí)時(shí)限。

　　配置構(gòu)建觸發(fā)器

　　代碼倉庫配置好了，意味著Jenkins具有了訪問GitHub代碼倉庫的權(quán)限，可以成功地拉取代碼。

　　那Jenkins什么時(shí)候執(zhí)行構(gòu)建呢？

　　這就需要配置構(gòu)建觸發(fā)策略，即構(gòu)建觸發(fā)器，配置項(xiàng)位于【Build Triggers】欄目。

　　觸發(fā)器支持多種類型，常用的有：

　　定期進(jìn)行構(gòu)建（Build periodically）根據(jù)提交進(jìn)行構(gòu)建（Build when a change is pushed to GitHub）定期檢測(cè)代碼更新，如有更新則進(jìn)行構(gòu)建（Poll SCM）

　　構(gòu)建觸發(fā)器的選擇為復(fù)合選項(xiàng)，若選擇多種類型，則任一類型滿足構(gòu)建條件時(shí)就會(huì)執(zhí)行構(gòu)建工作。如果所有類型都不選擇，則該Jenkins Job不執(zhí)行自動(dòng)構(gòu)建，但可通過手動(dòng)點(diǎn)擊【Build Now】觸發(fā)構(gòu)建。

　　關(guān)于定時(shí)器（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.

　　通常情況下需要指定多個(gè)值，這時(shí)可以采用如下operator（優(yōu)先級(jí)從上到下）：

　　適配所有有效的值： * ，若不指定某一項(xiàng)，則以 * 占位；M-N適配值域范圍，例如7-9代表7/8/9均滿足；M-N/X或*/X：以X作為間隔；A，B，C：枚舉多個(gè)值。

　　另外，為了避免多個(gè)任務(wù)在同一時(shí)刻同時(shí)觸發(fā)構(gòu)建，在指定時(shí)間段時(shí)可以配合使用H字符。添加H字符后，Jenkins會(huì)在指定時(shí)間段內(nèi)隨機(jī)選擇一個(gè)時(shí)間點(diǎn)作為起始時(shí)刻，然后加上設(shè)定的時(shí)間間隔，計(jì)算得到后續(xù)的時(shí)間點(diǎn)。直到下一個(gè)周期時(shí)，Jenkins又會(huì)重新隨機(jī)選擇一個(gè)時(shí)間點(diǎn)作為起始時(shí)刻，依次類推。

　　為了便于理解，列舉幾個(gè)示例：

　　H/15 * * * *：代表每隔15分鐘，并且開始時(shí)間不確定，這個(gè)小時(shí)可能是：07，：22，：37，：52，下一個(gè)小時(shí)就可能是：03，：18，：33，：48；H（0-29）/10 * * * *：代表前半小時(shí)內(nèi)每隔10分鐘，并且開始時(shí)間不確定，這個(gè)小時(shí)可能是：04，：14，：24，下一個(gè)小時(shí)就可能是：09，：19，：29；H 23 * * 1-5：工作日每晚23:00至23:59之間的某一時(shí)刻；

　　配置構(gòu)建方式

　　觸發(fā)策略配置好之后，Jenkins就會(huì)按照設(shè)定的策略自動(dòng)執(zhí)行構(gòu)建。但如何執(zhí)行構(gòu)建操作，這還需要我們通過配置構(gòu)建方式來進(jìn)行設(shè)定。

　　常用的構(gòu)建方式是根據(jù)構(gòu)建對(duì)象的具體類型，安裝對(duì)應(yīng)的插件，然后采用相應(yīng)的構(gòu)建方式。例如，若是構(gòu)建Android應(yīng)用，安裝Gradle plugin之后，就可以選擇Invoke Gradle ，然后采用Gradle進(jìn)行構(gòu)建；若是構(gòu)建iOS應(yīng)用，安裝Xcode integration插件之后，就可以選擇Xcode，然后選擇Xcode進(jìn)行構(gòu)建。

　　該種方式的優(yōu)勢(shì)是操作簡單，UI可視化，在場景不復(fù)雜的情況下可以快速滿足需求。不過缺點(diǎn)就是依賴于插件已有的功能，如果場景較復(fù)雜時(shí)可能單個(gè)插件還無法滿足需求，需要再安裝其它插件。而且，有些插件可能還存在一些問題，例如對(duì)某些操作系統(tǒng)版本或XCode版本兼容不佳，出現(xiàn)問題時(shí)我們就會(huì)比較被動(dòng)。

　　我個(gè)人更傾向于另外一種方式，就是自己編寫打包腳本，在腳本中自定義實(shí)現(xiàn)所有的構(gòu)建功能，然后在Execute Shell中執(zhí)行。這種方式的靈活度更高，各種場景的構(gòu)建需求都能滿足，出現(xiàn)問題后也能自行快速修復(fù)。

　　另外，對(duì)于iOS應(yīng)用的構(gòu)建，還有一個(gè)需要額外關(guān)注的點(diǎn)，就是開發(fā)者證書的配置。

　　如果是采用Xcode integration插件進(jìn)行構(gòu)建，配置會(huì)比較復(fù)雜，需要在Jenkins中導(dǎo)入開發(fā)證書，并填寫多個(gè)配置項(xiàng)。不過，如果是采用打包腳本進(jìn)行構(gòu)建的話，情況就會(huì)簡單許多。只要在Jenkins所運(yùn)行的計(jì)算機(jī)中安裝好開發(fā)者證書，打包命令在Shell中能正常工作，那么在Jenkins中執(zhí)行打包腳本也不會(huì)有什么問題。

　　構(gòu)建后處理

　　完成構(gòu)建后，生成的編譯成果物（ipa/apk）會(huì)位于指定的目錄中。但是，如果要直接在手機(jī)中安裝ipa/apk文件還比較麻煩，不僅在分發(fā)測(cè)試包時(shí)需要將好幾十兆的安裝包進(jìn)行傳送，體驗(yàn)用戶在安裝時(shí)也還需要通過數(shù)據(jù)線將手機(jī)與計(jì)算機(jī)進(jìn)行連接，然后再使用PP助手或豌豆莢等工具進(jìn)行安裝。

相關(guān)電子資料下載

• iOS17.1可能明天發(fā)布，iOS17.1主要修復(fù)哪些問題？ 380
• 社區(qū)說｜多才多藝: 探索 Android 應(yīng)用更多可能 13
• 浩辰軟件正式登陸上交所科創(chuàng)板 274
• 鴻蒙原生應(yīng)用，對(duì)開發(fā)者意味著什么？ 77
• Android端自定義鈴聲 MobPush對(duì)安卓端自定義鈴聲的教程 531
• Android推送問題排查技巧 針對(duì)MobPush安卓端推送問題的解決辦法 54
• 如何使用Proxyman抓取Android的https請(qǐng)求？ 43
• 基于OkHttp 3.10.0的源碼案例解析 26
• 基于MacroBenchmark的性能測(cè)試量化指標(biāo)方案 77
• 圖像放大為什么還能保持清晰度 圖像縮放的原理是什么 45