
前言
持續整合屬於「一次設定、長期受益」的投資,但很多小團隊其實並沒有認真做。以前做 Windows 開發時,我覺得這套東西配置起來還算直觀;這次換到 iOS,才發現環節多了不少。乾脆把過程整理出來分享,寫錯的地方歡迎指正。
本文示範如何用 fastlane 建立 iOS 的持續整合,做到自動編譯、自動產出多個版本的 ipa。最近轉做 iOS 開發,第一件任務就是用 Jenkins 把 iOS 專案的持續整合搭起來。翻過一堆資料之後,我整理出幾個關鍵詞:
目標
讓一台機器自動拉程式碼,並定時產出以下幾種 ipa:
另外,每個版本的 dSYM 除錯符號檔都要保留下來。
範例專案放在 https://github.com/everettjf/ios_ci_fastlane_demo。
安裝
fastlane 與 shenzhen 都靠 gem 安裝,建議先把 gem 來源換成國內鏡像。
sudo gem install fastlane
sudo gem install shenzhen
初始化流程
在 xcodeproj 的同一層目錄執行:
fastlane init
fastlane 能力很強,自動截圖、自動送審 App Store 都做得到,不過這裡我們只用最基礎的打包功能。過程中它會問一串問題:
* Do you want to get started...? y * Do you have everything commited... ? y * App Identifier (com.krausefx.app): com.everettjf.fastlanedemo * Your Apple ID (fastlane@krausefx.com): xxxxxxxx@xxxx.com * ... updates to the App Store or Apple TestFlight? (y/n) n * Do you want to setup 'snapshot'... n * Do you want to use 'sigh'... n (是否自動下載 provisioning 檔) * The scheme name of your app: fastlanetest (只有一個 target 時可留空)
之所以要輸入 Apple ID,是因為 fastlane 內部的 sigh 工具會自動下載對應的 provisioning 檔。對需要頻繁新增測試裝置的 Developer 憑證來說,這功能很方便;範例裡我們先不啟用。
執行完畢後,專案目錄下會多出一個 fastlane 資料夾:
drwxr-xr-x 5 everettjf staff 170B Sep 8 22:32 fastlane drwxr-xr-x 10 everettjf staff 340B Sep 8 22:00 fastlanedemo drwxr-xr-x 5 everettjf staff 170B Sep 8 22:38 fastlanedemo.xcodeproj drwxr-xr-x 4 everettjf staff 136B Sep 8 22:00 fastlanedemoTests
接著要改的是 fastlane 資料夾裡的兩個設定檔:Appfile 與 Fastfile(本質上就是 Ruby 程式碼)。
1. Appfile
app_identifier "com.everettjf.fastlanedemo" apple_id "aaa@aaa.com" for_lane :inhouse do app_identifier "com.everettjf.fastlanedemoqiye" apple_id "bbb@bbb.com" end
企業 In House 版本的 app_identifier 與 apple_id 跟 App Store 版不同,這裡的 for_lane 就是替 Fastfile 中定義的 :inhouse lane 單獨指定一組資訊。
2. Fastfile
這個檔案要寫出每個版本的編譯與打包流程(Developer、AppStore、InHouse、各渠道),每個版本大致都會經過下面幾個步驟。
先改版本號與 build 號,通常把外部傳入的參數寫進去,例如 1.0.0 與 100:
def prepare_version(options)
increment_version_number(
version_number: options[:version],
xcodeproj: PROJECT_FILE_PATH,
)
increment_build_number(
build_number: options[:build],
xcodeproj: PROJECT_FILE_PATH,
)
end接著改 app identifier(也就是 bundle id):
def update_app_identifier(app_id)
update_info_plist(
xcodeproj: PROJECT_FILE_PATH,
app_identifier: app_id,
plist_path: "#{PLIST_FILE_PATH}"
)
update_info_plist(
xcodeproj: PROJECT_FILE_PATH,
app_identifier: app_id,
plist_path: "#{UNITTEST_PLIST_FILE_PATH}"
)
end然後設定簽章與對應的 provisioning 檔:
def update_provision(typePrefix)
update_project_provisioning(
xcodeproj: PROJECT_FILE_PATH,
profile: "./fastlane/provision/#{typePrefix}.mobileprovision",
)
end渠道版本則需要改 Info.plist 裡的識別字串:
def set_info_plist_value(path, key, value)
sh "/usr/libexec/PlistBuddy -c \"set :#{key} #{value}\" #{path}"
end
def set_channel_id(channelId)
set_info_plist_value(
"./../fastlanedemo/#{PLIST_FILE_PATH}",
'ChannelID',
"#{channelId}"
)
end最後才是編譯打包成 ipa。這一步用的是 shenzhen 的 ipa 指令,你也可以換成 fastlane 官方推薦的 gym。
3. Shell 腳本
把上面的 lane 串成一支 build.sh,傳入主版本號與一個自增的流水號(一般直接用 Jenkins 的 build number),一鍵就能產出所有版本。
設定 Jenkins
有了這支一鍵編譯的腳本,剩下的就交給 Jenkins:安裝完成後,設定好「取得原始碼」,並在之後追加一步執行 build.sh 即可。
憑證準備
這裡假設手上有兩個開發者帳號:一個標準開發者帳號(99 美元,個人或公司),一個企業帳號(299 美元)。
另外務必注意:跑 Jenkins 的那台機器上的 Xcode 必須先匯入開發者帳號(也就是含有私鑰、由最初建立憑證的那台電腦匯出的那份),否則簽章環節一定失敗。
參考資料
其他思路