iOS - fastlane自動化打包

iOS自動化打包,我推薦fastlane 方案。

fastlane 的原理又是如何?

實現自動化打包,又有什么流程?

簡介

1、什么是打包?

? ? Objective-C是編譯語言,需要編譯后才能執行。我們發布一個版本的App,需要? ? ? 對源碼編譯、導出編譯產物的過程稱之為打包。

2、非自動化打包,是如何實現的

? ? 1)手動打包,使用Xcode

? ? 2)半自動化打包,我們都知道Xcode打包,其實使用的是`xcodebuild`命令,關于如何使用`xcodebuild`,請移駕這篇文章Xcode9+版本的打包方式,其得到了各位道友的認可。

3、fastlane

Fastlane是一套使用Ruby寫的自動化工具集,用于iOS和Android的自動化打包、發布等工作,可以節省大量的時間。

我們在選擇一些三方開源庫或是工具的前提是:可以滿足我們當下的需求并且提供好的擴展性, Fastlane做到了。我當前項目的需求主要是下面幾方面:

一行命令實現打包工作,不需要時時等待操作下一步,節省打包的時間去做其他的事。

避免頻繁修改配置導致可能出現的Release/Debug環境錯誤,如果沒有檢查機制,那將是災難,即使有檢查機制,我們也不得不重新打包,浪費了一次打包時間。畢竟人始終沒有程序可靠,可以告別便利貼了。

通過配置自動上傳到蒲公英內測平臺進行測試分發,也可以直接上傳到TestFlight,iTunes Connect。

證書的同步更新,管理,在新電腦能夠迅速具備項目打包環境。

Github:https://github.com/fastlane/fastlane

官網:https://fastlane.tools/

文檔:https://docs.fastlane.tools/

fastlane中常用的插件介紹


測試工具

scan:自動運行測試工具,可以生成漂亮的HTML報告

生成證書、配置文件工具

cert:自動創建iOS代碼簽名證書(.cert文件)

sigh:自動創建、更新、下載、修復Provisioning Profile

pem:自動生成、更新推送配置文件

截圖、描設備邊框

deliver:上傳截圖、元數據、App到iTunesConnect

snapshot:使用UI test功能實現自動截圖

frameit:在截圖的圖片外層套上物理設備邊框

自動化編譯工具

gym:自動化編譯工具

安裝

1、首先要安裝正確的 Ruby 版本。在終端窗口中用下列命令來確認:

ruby -v

2、然后檢查 Xcode 命令行工具是否安裝。在終端窗口中輸入命令:

xcode-select --install

如果未安裝,終端會開始安裝,如果報錯誤:command line tools are already installed, use "Software Update" to install updates.代表已經安裝。

3、以上依賴配置好之后就可以通過 rubygem 進行安裝了:

$ sudo gem install fastlane

安心等待一會,fastlane就安裝完成了。

使用

初始化

打開終端,cd到你的工程目錄,然后執行fastlane init:

$ cd to/your/ios/project

$ fastlane init

在 "Your Apple ID" 這一步輸入蘋果開發者賬號。在“Please confirm the above values”這一步,確認信息,沒問題輸入 y。然后,fastlane 會進行一系列的初始化操作,包括下載 App Store 上的元數據和截屏文件。

等待初始化完成之后,工程目錄下就多了一個 fastlane目錄,其內容如下:

fastlane目錄

咱們來看兩個主要的,Appfile和Fastfile。

Appfile

Appfile用來存放app_identifier,apple_id和team_id。 了解詳情,它的格式是這樣的:

app_identifier "com.xxx.xxx"# app的bundle identifier

apple_id "xxx@xxx.com"# 你的Apple ID

team_id "XXXXXXXXXX"# Team ID

···

你也可以為每個lane(后面會講到)提供不同的 app_identifier, apple_id 和 team_id,例如:

app_identifier "com.aaa.aaa"

apple_id "aaa@aaa.com"

team_id "AAAAAAAAAA"

for_lane :inhouse do

? app_identifier "com.bbb.bbb"

? apple_id "bbb@bbb.com"

? team_id "AAAAAAAAAA"

end

這里就是為Fastfile中定義的:inhouse設置單獨的信息。

Fastfile

Fastfile管理你所創建的 lane ,了解詳情。它的格式是這樣的:

# 自動更新fastlane 工具

# update_fastlane

#需要的fastlane的最小版本,在每次執行之后會檢查是否有新版本,如果有會在最后末尾追加新版本提醒

fastlane_version "2.30.1"

#默認使用平臺是 ios,也就是說文件可以定義多個平臺

default_platform :ios

platform :ios do

? before_all do

? ? # ENV["SLACK_URL"] = "https://hooks.slack.com/services/..."

? ? cocoapods

? end


? desc "Runs all the tests"

? lane :test do

? ? scan

? end


? desc "提交一個新的Beta版本到 Apple TestFlight"

? desc "This will also make sure the profile is up to date"

? lane :beta do

? ? # match(type: "appstore") # more information:https://codesigning.guide

? ? gym(scheme: "Docment") # Build your app - more options available

? ? pilot


? ? # sh "your_script.sh"

? end


? desc "部署一個新版本到App Store"

? lane :release do

? ? # match(type: "appstore")

? ? # snapshot

? ? gym(scheme: "Docment") # Build your app - more options available

? ? deliver(force: true)

? ? # frameit

? end


? # 你可以定義自己的lane

? #執行lane成功后的回調

? after_all do|lane|

? ? # slack(

? ? #? message: "Successfully deployed new App Update."

? ? # )

? end


? # 如果流程發生異常會走這里并終止

? error do|lane, exception|

? ? # slack(

? ? #? message: exception.message,

? ? #? success: false

? ? # )

? end

end

我們也可以定義一個自己的lane:

? desc "企業版"

? lane :inHouse do

? gym(scheme: "XXX",

? ? ? export_method:"enterprise",

? ? ? output_directory "./build", # 打包后的 ipa 文件存放的目錄

? ? ? output_name "XXX"# ipa 文件名

? )

? end

其中一個lane就是一個任務,里面是一個個的action組成的工作流。

執行

定義完lane之后怎么執行呢?打開終端,切換到項目的根目錄:執行fastlane lane'name就可以了。成功之后會在相應的路徑下生成ipa文件,如果報錯的話就根據錯誤信息好好查看文檔

其他

1)想了解fastlane命令的話可以執行$ fastlane --help

2)查看可用任務的列表,可以執行命令$ fastlane lanes

3)fastlane也提供了很多插件方便我們使用,例如pgyer(發布app到蒲公英)。我們也可以打完包直接傳到蒲公英上,具體的可以看蒲公英提供的文檔

如果你感覺有些插件不符合自己的情況,你甚至可以自定義插件

4)多個 lane 的話實際上是可以相互調用的,這個其實特別實用。例如:

default_platform :ios

platform :ios do

? lane :prepare do

? ? cocoapods

? ? match

? end


? desc 'fastlane build''fastlane build type:adhoc'

? lane :build do|options|

? ? # 調用上面的 prepare 任務

? ? prepare

? ? caseoptions[:type]

? ? when 'adhoc'

? ? ? adhoc

? ? else

? ? ? appstore

? ? end

? end


? lane : adhoc do

? ···

? end


? lane : appstore do

? ···

? end

end

6、我們可以在 Fastfile 文件中添加一個函數來設置version號和build號。

default_platform :ios

def prepare_version(options)

? ? increment_version_number(

? ? ? ? version_number: options[:version]

? ? )

? ? increment_build_number(

? ? ? ? build_number: options[:build]

? ? )

end

然后可以在一個lane中使用這個函數:


lane :appstore do|options|

? ···

? ? prepare_version(options)

? ···

end

然后執行這個lane的時候:

$ fastlane appstore version:2.4.0 build:2.0

證書管理-match

使用match管理證書,可以省去很多復雜操作,如:Mac上申請頒發證書、AppleDeveloper去創建證書、創建真機測試Provision文件、添加設備等。

1)搭建一個git-project,所有證書文件存放在git上,各iOS開發組員可以更方便同步證書等文件

2)在fastlane文件夾中,初始化match

$ fastlane match init

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容