您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

CI 實踐第一篇:用 Jenkins 打通 GitHub 自動化打包與分發

編輯:iOS 開發基礎

作者:lp_馬建成,授權本站轉載。

導語

本文將循序漸進地記錄我從對 CI 一無所知,到真正把它用起來的整個過程,涵蓋 Jenkins 的安裝部署、插件安裝、JOB 配置,以及如何通過 shell 把構建產物上傳到主流測試分發平台(fir.im 與蒲公英)。

一、Jenkins 安裝與啟動

最省事的方式是用 brew 直接安裝:

brew install jenkins

若提示 brew: command not found,說明尚未安裝 Homebrew。Homebrew 是 macOS 上的 Unix 工具包管理器,依賴於 Xcode 的 Command Line Tool。

1.1 安裝 Homebrew

官網為 brew.sh,安裝命令如下:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

看到 Installation successful! 即表示安裝成功。

1.2 安裝 Java 環境

Jenkins 自身需要 Java 運行環境。建議直接去 Java 官網下載安裝包,比 brew install Cask 快得多:

brew install Caskroom/cask/java

(凌晨時分下載速度往往不理想,耐心等待即可。)

1.3 啟動 Jenkins

先找到 Jenkins 的 war 包路徑(通常在 /usr/local/Cellar/jenkins/版本號/libexec/),進入該目錄後執行:

cd /usr/local/Cellar/jenkins/1.622/libexec/ java -jar ./jenkins.war

當看到 Jenkins is fully up and running 便表示啟動成功。此時在瀏覽器訪問 https://localhost:8080 即可看到 Jenkins 首頁。

二、安裝 GitHub 相關插件

進入 Jenkins 頁面,依次選擇「系統管理 → 插件管理 → 可選插件」,安裝以下插件:

  • GIT plugin
  • GitHub plugin
  • Post-Build Script Plug-in
  • Xcode integration

三、Jenkins JOB 配置

3.1 新建 Job

選擇「自由風格」軟件項目新建一個 Job,填入 Git 倉庫地址,並配置 Xcode 編譯參數。

建議每完成一步就 save 並「立即構建」一次,及時發現問題。構建成功後,控制台會輸出類似 Finished: SUCCESS 的信息,產物(如 yxios.ipa)會生成在對應 workspace 的 build 目錄下。

四、Shell 上傳到 fir.im / 蒲公英

上傳到 fir.im

先按官方文檔搭建 fir 上傳環境(若安裝失敗,可嘗試重裝 ruby、brew 等;使用 Xcode beta 版的朋友尤其容易遇到環境問題)。安裝完成後用 fir 命令上傳:

fir b path/to/workspace -o path/to/output -w -C Release -t allTargets

在 Jenkins 中增加一個「Execute shell」構建步驟:

fir build_ipa ${WORKSPACE} -o ${WORKSPACE}/build/ -p -T YOUR_FIR_TOKEN

看到 Build Success 與 Publishing app... 等日誌,即表示已成功發布到 fir 平台。

上傳到蒲公英

蒲公英上傳請仔細參考其官方文檔,核心是一條 curl 命令:

curl -F "file=@/tmp/example.ipa" -F "uKey={$uKey}" -F "_api_key={$apiKey}" https://www.pgyer.com/apiv1/app/upload

若缺少 curl,可通過 brew install curl 安裝。把上傳命令追加到 fir.im 上傳步驟之後:

curl -F "file=@${WORKSPACE}/build/yxios.ipa" -F "uKey=你的用戶key" -F "_api_key=你的apiKey" https://www.pgyer.com/apiv1/app/upload

保存後再次構建,在 Console output 中若看到返回的 JSON(包含 appKey、appName、appVersion 等字段)以及 Finished: SUCCESS,即表示上傳成功。若安裝出現問題,記得在 Xcode 中配置證書,並在服務器環境安裝好描述文件。

總結

Jenkins 是我最近一兩周才接觸的 CI 工具,相比開發,測試與項目經理接觸它可能更多。在 iOS 領域,除了一些大廠,很多團隊基本不會提及自動化測試、部署與持續集成。此文意在拋磚引玉,歡迎 iOS、CI 及測試領域的朋友前來拍磚交流。我也希望能把 CI 做成一係列文章,吸引更多愛好者共同研究,一起推動 iOS 開發界在 CI 方面的發展。文中若有紕漏,歡迎通過 @lp_馬建成 與我取得聯繫,也特別感謝 @fir.im 與 @蒲公英 在部署測試過程中給予的無私幫助。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved