您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

用 fastlane 打造 iOS 持續整合的一鍵打包流程

編輯:iOS 相關資訊

前言

持續整合屬於「一次設定、長期受益」的投資,但很多小團隊其實並沒有認真做。以前做 Windows 開發時,我覺得這套東西配置起來還算直觀;這次換到 iOS,才發現環節多了不少。乾脆把過程整理出來分享,寫錯的地方歡迎指正。

本文示範如何用 fastlane 建立 iOS 的持續整合,做到自動編譯、自動產出多個版本的 ipa。最近轉做 iOS 開發,第一件任務就是用 Jenkins 把 iOS 專案的持續整合搭起來。翻過一堆資料之後,我整理出幾個關鍵詞:

  • 搭建 Jenkins
  • 用 fastlane 提供的工具修改專案設定
  • 用 gym 或 ipa 指令完成編譯打包

目標

讓一台機器自動拉程式碼,並定時產出以下幾種 ipa:

  • 內部測試版:用標準開發者的 Developer 憑證簽名。
  • 公開測試版:用企業帳號的 Distribute In House 憑證簽名。
  • App Store 版:用標準開發者的 AppStore 憑證簽名。
  • 渠道版:本質上是內部測試版,只是 Info.plist 裡多寫入各渠道的識別碼(因為像是 fir.im 這類平台會用自己的憑證重簽,所以內部測試版就夠用)。

另外,每個版本的 dSYM 除錯符號檔都要保留下來。

範例專案放在 https://github.com/everettjf/ios_ci_fastlane_demo。

安裝

fastlane 與 shenzhen 都靠 gem 安裝,建議先把 gem 來源換成國內鏡像。

sudo gem install fastlane
  • fastlane 以 Ruby 撰寫,透過 gem 安裝。
  • 官網:https://fastlane.tools/
sudo gem install shenzhen
  • 如果你只用 gym、不用 ipa 指令,這個可以不裝。
  • 專案位址:https://github.com/nomad/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 美元)。

  • 標準開發者帳號:aaa@aaa.com
  • 企業帳號:bbb@bbb.com

另外務必注意:跑 Jenkins 的那台機器上的 Xcode 必須先匯入開發者帳號(也就是含有私鑰、由最初建立憑證的那台電腦匯出的那份),否則簽章環節一定失敗。

參考資料

  • fastlane:https://github.com/KrauseFx/fastlane/tree/master/docs
  • shenzhen:https://github.com/nomad/shenzhen

其他思路

  1. Jenkins 的 Xcode 插件:網路上有些文章介紹過,我自己沒實測,不確定能不能動態切換憑證。
  2. 一次編譯、多次簽名:在還沒導入 fastlane 之前,我曾用 gym 先產出一個 Developer 簽名的 ipa,再用其他憑證逐一重簽。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved