前言
在項目測試階段，頻繁的打包發布會耗費團隊很多的時間。搭建一個自動化打包發布的平臺，可以將我們從那些繁瑣的打包發布流程中解放出來。
本文采用的方案是：Jenkins + Fastlane + GitLab + 蒲公英。
Fastlane安裝
Fastlane是一套使用Ruby寫的自動化工具集，用于iOS和Android的自動化打包、發布等工作，可以節省大量的時間。
安裝過程如下：
1.檢查Ruby版本，需要2.0及以上版本。在終端輸入以下命令確認：
ruby -v
需要注意的是需要將gem的source改為https://gems.ruby-china.org/。
如何檢查?在終端輸入以下命令:
gem sources
結果應為：
*** CURRENT SOURCES ***
https://gems.ruby-china.org/
2.檢查Xcode命令行工具是否安裝。在終端輸入以下命令：
xcode-select --install
如果沒有安裝會進行安裝。如果已經安裝了則會提示：
xcode-select: error: command line tools are already installed, use "Software Update" to install updates
3.安裝Fastlane
sudo gem install fastlane --verbose
如果出現以下錯誤：
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/rougify
則輸入以下命令：
sudo gem install -n /usr/local/bin fastlane
4.檢查Fastlane是否正確安裝。輸入以下命令：
fastlane --version
可以看到Fastlane版本信息，我的是2.46.1。
蒲公英的Fastlane插件安裝
打開終端，進入你的項目工程的根目錄，輸入以下命令：
fastlane add_plugin pgyer
出現
Plugin 'fastlane-plugin-pgyer' was added to './fastlane/Pluginfile'
It looks like fastlane plugins are not yet set up for this project.
fastlane will create a new Gemfile at path 'Gemfile'
This change is necessary for fastlane plugins to work
Should fastlane modify the Gemfile at path 'Gemfile' for you?
(y/n)
輸入y按回車，出現
Installing plugin dependencies...
Successfully installed plugins
便是安裝成功了。
Fastlane配置
1.打開終端，進入你的項目工程的根目錄，輸入以下命令：
fastlane init
中間會讓你輸入蘋果開發者賬號的賬號和密碼，之后會在你項目工程的目錄下生成一個fastlane文件夾，里面有Fastlane的配置文件，一個是Appfile文件，一個是Fastfile文件(如果要上傳AppStore的話還有Deliverfile文件)。Appfile保存蘋果開發者的相關信息、項目的相關信息等。Fastfile是運行腳本。
2.編輯Fastfile文件
有時候一天需要打好幾個包，為了區分，我們這里實現一個遞增build號的功能。
(1)修改項目工程配置
修改Build Settings中的Versioning配置，Current Project Version隨便填一個，Versioning System選擇Apple Generic。
修改Info.plist File路徑
(2)定義一個遞增build號的函數，添加到Fastfile中
def updateProjectBuildNumber
currentTime = Time.new.strftime("%Y%m%d")
build = get_build_number()
if build.include?"#{currentTime}."
# => 為當天版本 計算迭代版本號
lastStr = build[build.length-2..build.length-1]
lastNum = lastStr.to_i
lastNum = lastNum + 1
lastStr = lastNum.to_s
if lastNum < 10
lastStr = lastStr.insert(0,"0")
end
build = "#{currentTime}.#{lastStr}"
else
# => 非當天版本 build 號重置
build = "#{currentTime}.01"
end
puts("*************| 更新build #{build} |*************")
# => 更改項目 build 號
increment_build_number(
build_number: "#{build}"
)
end
實現自動打包的完整Fastfile如下：
# 定義fastlane版本號
fastlane_version “2.46.1”
# 定義打包平臺
default_platform :ios
def updateProjectBuildNumber
currentTime = Time.new.strftime("%Y%m%d")
build = get_build_number()
if build.include?"#{currentTime}."
# => 為當天版本 計算迭代版本號
lastStr = build[build.length-2..build.length-1]
lastNum = lastStr.to_i
lastNum = lastNum + 1
lastStr = lastNum.to_s
if lastNum < 10
lastStr = lastStr.insert(0,"0")
end
build = "#{currentTime}.#{lastStr}"
else
# => 非當天版本 build 號重置
build = "#{currentTime}.01"
end
puts("*************| 更新build #{build} |*************")
# => 更改項目 build 號
increment_build_number(
build_number: "#{build}"
)
end
#指定項目的scheme名稱
scheme=“TestCI”
#蒲公英api_key和user_key
api_key=“”
user_key=“”
# 任務腳本
platform :ios do
lane :development_build do|options|
branch = options[:branch]
puts “開始打development ipa”
updateProjectBuildNumber #更改項目build號
# 開始打包
gym(
#輸出的ipa名稱
output_name:”#{scheme}_#{get_build_number()}”,
# 是否清空以前的編譯信息 true：是
clean:true,
# 指定打包方式，Release 或者 Debug
configuration:"Release",
# 指定打包所使用的輸出方式，目前支持app-store, package, ad-hoc, enterprise, development
export_method:"development",
# 指定輸出文件夾
output_directory:"./fastlane/build",
)
puts "開始上傳蒲公英"
# 開始上傳蒲公英
pgyer(api_key: “#{api_key}”, user_key: “#{user_key}”)
end
end
注意：蒲公英的 api_key 和 user_key，開發者在自己賬號下的 賬號設置-API信息 中可以找到。打其它類型的包的方法與development類似，可自定義一個新的lane實現。
在終端輸入
fastlane development_build
便會進行自動打包并上傳蒲公英了。
Jenkins安裝
Jenkins 是一個開源項目，提供了一種易于使用的持續集成系統，使開發者從繁雜的集成中解脫出來，專注于更為重要的業務邏輯實現上。同時 Jenkins 能實施監控集成中存在的錯誤，提供詳細的日志文件和提醒功能，還能用圖表的形式形象地展示項目構建的趨勢和穩定性。
安裝過程如下：
1.點擊 http://mirrors.jenkins.io/war-stable/latest/jenkins.war 下載最新的Jenkins.war
2.打開終端，進入war包所在目錄，執行以下命令：
java -jar jenkins.war
注意：Jenkins依賴于Java運行環境，因此需要首先安裝JDK,下載地址：http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
3.執行完成之后打開瀏覽器輸入http://localhost:8080/
4.彈出Jenkins安裝界面，會讓你輸入安全密碼,輸入完成之后選擇默認安裝。
5.新建管理員賬號密碼
對以上過程有疑問的話可以參考手把手教你利用Jenkins持續集成iOS項目
安裝插件
還是登錄http://localhost:8080/ ，選擇系統管理 - 管理插件。
安裝GitLab插件
在可選插件中選擇GitLab Plugin和Gitlab Hook Plugin進行安裝。
安裝Xcode插件
在可選插件中選擇Xcode integration進行安裝。
安裝完成之后，我們就可以配置構建項目了。
構建任務
1.點擊新建，輸入名稱，構建一個自由風格的軟件項目
2.配置Git
添加Git倉庫地址，可以是HTTP也可以是SSH。點擊Add
如果是HTTP
如果是SSH
注意：UserName是取一個名字，填寫的Key是私鑰。
3.配置腳本
因為我的Git倉庫的目錄是這樣的
所以在執行fastlane development_build之前需要進入TestCI目錄，即fastlane文件夾所在目錄。
4.添加完成之后點擊立即構建
5.執行成功顯示如下
可以點擊進入查看控制臺輸出
