【iOS 開發】使用 Jenkins + Fastlane 持續集成 iOS 項目

Jenkins

持續集成(Continuous Integration 簡稱 CI)。Jenkins 是一個開源項目,提供了一種易于使用的持續集成系統,使開發者從繁雜的集成中解脫出來,專注于更為重要的業務邏輯實現上。具體就不多說了,想要更多的了解可以去查一下,下面是集成方法。


本文最終目的:

  • 測試人員可登錄 Jenkins 網頁自行選擇 開發分支打包類型 ,然后自動打包完成并自動上傳至 蒲公英iTunes Connect ,不再需要開發人員手動安裝或上傳。

1. 配置 Fastlane

由于項目的編譯打包以及上傳全部要依賴 Fastlane 來進行,所以在配置 Jenkins 之前要保證項目已經配置好了 Fastlane ,這里看我的另一篇文章:【iOS 開發】使用 Fastlane 自動化打包并發布 iOS 項目

2. 安裝 Jenkins

  • Jenkins 依賴于 Java 運行環境,因此需要先保證電腦已經安裝了 Java JDK ,如果沒有的話前往 這里 下載安裝即可。

  • 我這里是使用 homebrew 安裝 Jenkins ,沒有安裝 homebrew 的輸入以下命令安裝一下。

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  • 千萬不要去 Jenkins 官網下載 pkg 安裝包安裝,因為用安裝包安裝會自動生成一個共享用戶 jenkins,而這個用戶的權限和系統登錄用戶的權限不同,會造成大量的權限問題,我已經被坑慘了,用 homebrew 裝是不會生成共享用戶的。

  • homebrew 安裝完成后輸入以下命令安裝 Jenkins

brew install jenkins
安裝
  • 如果想要卸載直接執行以下命令即可卸載 Jenkins
brew uninstall jenkins
  • 安裝完成后輸入以下命令鏈接 launchd 配置文件。
ln -sfv /usr/local/opt/jenkins/*.plist ~/Library/LaunchAgents
  • 然后執行以下命令啟動 Jenkins
launchctl load ~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist
  • Jenkins 默認是開機自動啟動的,如果想關閉就執行以下命令即可關閉。
launchctl unload ~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist
Jenkins
  • Jenkins 默認端口號是 8080 ,如果想要更改端口號的話可以用 Xcode 打開以下文件,將 httpPort 后面的 8080 改成你想要的端口號即可,如果想要別人訪問你的 Jenkins 服務器,只要把 httpListenAddress 改為 0.0.0.0 即可,改完重啟后生效。
/usr/local/opt/jenkins/homebrew.mxcl.jenkins.plist
修改端口

3. 配置 Jenkins

  • 等待啟動完成后 ,會出現以下界面讓你輸入密碼解鎖。
Jenkins
  • 密碼就在上面提示的 /Users/Jonzzs/.jenkins/secrets/initialAdminPassword 文件中,打開 initialAdminPassword 文件將密碼復制到瀏覽器解鎖即可,然后點擊第一個 Install suggested plugins
Jenkins
  • 然后等待插件全部安裝完成。
Jenkins
  • 安裝完成后會跳出創建用戶界面,按照提示創建用戶即可。
Jenkins
  • 最后到這個頁面就算是安裝完成了。
Jenkins

4. 安裝插件

  • 在建任務之前需要先安裝幾個插件,前往 系統管理 - 管理插件 ,在 可選插件 中搜索 GitLab PluginGitlab Hook PluginXcode integration 這三個插件,然后安裝。
Jenkins

5. 配置環境變量

  • 前往 系統管理 - 系統設置 找到 全局屬性 ,然后添加以下三個環境變量。
LANG
en_US.UTF-8
LANGUAGE
en_US.UTF-8
LC_ALL
en_US.UTF-8
環境變量
  • 這三個環境變量是用來修改編碼格式的,如果不加下面腳本執行 fastlane 命令時會報錯。

6. 創建任務

  • 插件安裝完成以后就可以開始創建項目了,點擊新建任務,輸入你的項目名稱。
Jenkins
  • 勾選 參數化構建過程 ,添加一個 String Parameter 和一個 Choice Parameter ,第一個 ARCHIVE_BRANCH 主要是輸入要打包的項目分支,第二個 ARCHIVE_TYPE 是選擇打包的類型,我這邊 beta 是打包發布到 蒲公英release 是打包發布到 iTunes Connect ,如果你不需要這些參數可以跳過。
Jenkins
  • 源碼管理 輸入你的倉庫地址,地址為 SSH 方式,然后需要在點擊 Add 添加 SSH Key
Jenkins
  • 選擇 SSH Username with private key 類型,Username 隨便填,然后選擇 From the Jenkins master ~/.ssh ,添加完之后在 Credentials 那里選擇即可。
Jenkins
  • 如果自己電腦沒有生成過 SSH Key ,就自己去查一下吧,這里就不重復了。

  • 最后在 構建 中增加一個 Execute Shell ,主要用來填寫腳本內容。

Jenkins
  • 填寫以下腳本命令,xxx 處填寫自己項目相應文件夾名,因為在執行 fastlane 指令之前需要進入 fastlane 文件夾所在目錄,如果你的 git 根目錄就是在項目目錄的話,可以不用這句,然后點擊 保存 即可。
git checkout ${ARCHIVE_BRANCH}
git pull
cd ./xxx
fastlane ${ARCHIVE_TYPE}

7. 開始打包

  • 進入你創建的任務,點擊 Build with Parameters ,然后輸入要打包的項目分支以及類型,然后點擊 開始構建 即可開始打包。
Jenkins
  • 如果構建失敗,也可以在 Build History 中點擊 Console Output 查看控制臺輸出記錄,找到錯誤原因。
Jenkins

配置方法到這里就完成了,有不明白的地方可以留言。

將來的你,一定會感激現在拼命的自己,愿自己與讀者的開發之路無限美好。

我的傳送門: 博客簡書微博GitHub

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,563評論 6 544
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,694評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,672評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,965評論 1 318
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,690評論 6 413
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 56,019評論 1 329
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,013評論 3 449
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,188評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,718評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,438評論 3 360
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,667評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,149評論 5 365
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,845評論 3 351
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,252評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,590評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,384評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,635評論 2 380

推薦閱讀更多精彩內容