使用fastlane工具自動(dòng)打包發(fā)布App Store或蒲公英測(cè)試平臺(tái)
?在以往的iOS開發(fā)過程中，我們大都使用xcode提供的工具進(jìn)行手動(dòng)打包ipa，這種打包方式會(huì)帶來大量時(shí)間上的浪費(fèi)，想必對(duì)于有追求的開發(fā)者來說時(shí)間都是寶貴的。那么，有沒有一種方式可以通過一行指令自動(dòng)完成打包呢？答案是：有的，通過筆者行走于江湖多年，得到了fastlane的這個(gè)開源的神器，可以到以下地址進(jìn)行查看參考和學(xué)習(xí)：
- Github：https://github.com/fastlane/fastlane
- 官網(wǎng)：https://fastlane.tools/
- 文檔：https://docs.fastlane.tools/
?本篇文章將分為兩大部分進(jìn)行全面的講解關(guān)于打包的內(nèi)容：
- 使用xcode提供的打包工具進(jìn)行手動(dòng)打包；
- 使用fastlane工具進(jìn)行自動(dòng)打包；
?下面我們先來看下xcode工具的打包流程：
寫在前面：本文中您所看到的效果都是基于xcode9.1進(jìn)行的，當(dāng)然，開發(fā)環(huán)境證書配置都是自動(dòng)配置的，這里我不會(huì)再多贅述。
1.設(shè)置如圖所示：
xcode工具打包.png
導(dǎo)出ipa.png
- ad-hoc：打包發(fā)布蒲公英測(cè)試平臺(tái)；
- app-store：打包發(fā)布App Store；
- 其他的簽名方式在xcode9.0后是自動(dòng)選擇；4.將導(dǎo)出的ipa包存放到指定路徑。選擇導(dǎo)出ipa包方式.png
?到這里，打包的流程就完成了，下面我們就把導(dǎo)出的ipa通過xcode提供的上傳工具進(jìn)行發(fā)布app至App Store：這一步也會(huì)進(jìn)行對(duì)ipa進(jìn)行編譯，也是消耗時(shí)間的過程。。。上傳ipa.png
?至此，我們的ipa就會(huì)在iTunes content 中構(gòu)建出新的版本，選擇該版本上線即可；my friend ~這種操作，你能忍？！我可是忍不了！
如果對(duì)于維護(hù)多個(gè)app或者多個(gè)target的工程，發(fā)布測(cè)試平臺(tái)或者App Store來講，這樣的操作是令人崩潰的，那么，我們收拾下令人窒息的心情，請(qǐng)繼續(xù)往下看~
?大家先來腦補(bǔ)一下這張圖
fastlane打包流程.png
?接下來，向大家詳細(xì)的講解fastlane自動(dòng)打包，這里分以下 3 部分：
1.單個(gè)工程使用fastlane自動(dòng)打包
2.針對(duì)多個(gè)target環(huán)境使用fastlane自動(dòng)打包
3.建議安裝下蒲公英的mac客戶端
首先來看單個(gè)工程使用fastlane自動(dòng)打包的流程及配置：
- 使用
fastlane環(huán)境打包，我們得先配置一下環(huán)境，fastlane是基于ruby的，所以我們需要安裝下ruby環(huán)境，安裝ruby環(huán)境參考此鏈接;
*然后檢查 Xcode 命令行工具是否安裝。在終端窗口中輸入命令：
xcode-select --install
如果未安裝，終端會(huì)開始安裝，如果報(bào)錯(cuò)誤：command line tools are already installed, use "Software Update" to install updates.代表已經(jīng)安裝。
- 以上依賴配置好之后就可以通過 rubygem 進(jìn)行安裝了：
sudo gem install fastlane
安心等待一會(huì)，fastlane就安裝完成了。
- 接下來就是要初始化
fastlane：
打開終端，cd到你的工程目錄，然后執(zhí)行fastlane init：
Peter-2:~ Peter$ cd desktop
Peter-2:desktop Peter$ cd Popo/
Peter-2:Popo Peter$ fastlane init
[?] ?? /Users/peter/.rvm/rubies/ruby-2.4.1/lib/ruby/gems/2.4.0/gems/tty-screen-0.6.4/lib/tty/version.rb:3: warning: already initialized constant TTY::Screen::VERSION
/Users/peter/.rvm/gems/ruby-2.4.1@global/gems/tty-screen-0.6.4/lib/tty/version.rb:3: warning: previous definition of VERSION was here
[?] ??
[?] Looking for iOS and Android projects in current directory...
[17:08:01]: Created new folder './fastlane'.
[17:08:01]: Detected an iOS/macOS project in the current directory: 'Popo.xcodeproj'
[17:08:01]: -----------------------------
[17:08:01]: --- Welcome to fastlane ?? ---
[17:08:01]: -----------------------------
[17:08:01]: fastlane can help you with all kinds of automation for your mobile app
[17:08:01]: We recommend automating one task first, and then gradually automating more over time
[17:08:01]: What would you like to use fastlane for?
1. ?? Automate screenshots
2. ????? Automate beta distribution to TestFlight
3. ?? Automate App Store distribution
4. ?? Manual setup - manually setup your project to automate your tasks
?
寫在當(dāng)前：
- 1、代表app市場(chǎng)圖片素材；
- 2、發(fā)布到TestFlight進(jìn)行測(cè)試；
- 3、發(fā)布到App Store；
- 4、自定義
在初始化```fastlane```的過程中，可能會(huì)出現(xiàn)要輸入蘋果開發(fā)者賬號(hào)，
在 "Your Apple ID" 這一步輸入蘋果開發(fā)者賬號(hào)。
在“Please confirm the above values”這一步，確認(rèn)信息，沒問題輸入 y。
然后，```fastlane ```會(huì)進(jìn)行一系列的初始化操作，包括下載 App Store 上的元數(shù)據(jù)和截屏文件。
在這里，我們選擇序號(hào) 4 ，來手動(dòng)去設(shè)置自定義的打包內(nèi)容，在這一步，你會(huì)發(fā)現(xiàn)新的世界~
? 4
[17:17:37]: ------------------------------------------------------------
[17:17:37]: --- Setting up fastlane so you can manually configure it ---
[17:17:37]: ------------------------------------------------------------
[17:17:37]: Installing dependencies for you...
[17:17:37]: $ bundle update
[17:17:48]: --------------------------------------------------------
[17:17:48]: --- ? Successfully generated fastlane configuration ---
[17:17:48]: --------------------------------------------------------
[17:17:48]: Generated Fastfile at path `./fastlane/Fastfile`
[17:17:48]: Generated Appfile at path `./fastlane/Appfile`
[17:17:48]: Gemfile and Gemfile.lock at path `Gemfile`
[17:17:48]: Please check the newly generated configuration files into git along with your project
[17:17:48]: This way everyone in your team can benefit from your fastlane setup
[17:17:48]: Continue by pressing Enter ?
[17:17:51]: fastlane will collect the number of errors for each action to detect integration issues
[17:17:51]: No sensitive/private information will be uploaded, more information: https://docs.fastlane.tools/#metrics
[17:17:51]: ----------------------
[17:17:51]: --- fastlane lanes ---
[17:17:51]: ----------------------
[17:17:51]: fastlane uses a `Fastfile` to store the automation configuration
[17:17:51]: Within that, you'll see different lanes.
[17:17:51]: Each is there to automate a different task, like screenshots, code signing, or pushing new releases
[17:17:51]: Continue by pressing Enter ?
[17:17:51]: --------------------------------------
[17:17:51]: --- How to customize your Fastfile ---
[17:17:51]: --------------------------------------
[17:17:51]: Use a text editor of your choice to open the newly created Fastfile and take a look
[17:17:51]: You can now edit the available lanes and actions to customize the setup to fit your needs
[17:17:51]: To get a list of all the available actions, open https://docs.fastlane.tools/actions
[17:17:51]: Continue by pressing Enter ?
[17:17:52]: ------------------------------
[17:17:52]: --- Where to go from here? ---
[17:17:52]: ------------------------------
[17:17:52]: ?? Learn more about how to automatically generate localized App Store screenshots:
[17:17:52]: https://docs.fastlane.tools/getting-started/ios/screenshots/
[17:17:52]: ????? Learn more about distribution to beta testing services:
[17:17:52]: https://docs.fastlane.tools/getting-started/ios/beta-deployment/
[17:17:52]: ?? Learn more about how to automate the App Store release process:
[17:17:52]: https://docs.fastlane.tools/getting-started/ios/appstore-deployment/
[17:17:52]: ????? Learn more about how to setup code signing with fastlane
[17:17:52]: https://docs.fastlane.tools/codesigning/getting-started/
[17:17:52]:
[17:17:52]: To try your new fastlane setup, just enter and run
[17:17:52]: $ fastlane custom_lane
#######################################################################
# fastlane 2.88.0 is available. You are on 2.87.0.
# You should use the latest version.
# Please update using `sudo gem install fastlane`.
#######################################################################
2.88.0 Improvements
* [action] Fix crashlytics to not autoload gsp_path if api_token is set (#12176) via Josh Holtz
* Improve error message when specified scheme is not found (#12182) via Cédric Luthi
* [action] Support checking remote git tags existence (#11675) via Takeru Chuganji
* Use Android environment to find adb (don't just rely on it being in PATH) (#12168) via Adam Cohen-Rose
* [snapshot] Make sure matched window has a non-empty frame (#12174) via Fran?ois Pradel
* [swift] Fixes string return value and shows all lanes (even without description) (#12171) via Josh Holtz
* [scan] Default skip_build to true in Scanfile template (#12162) via Aaron Brager
Please update using `sudo gem install fastlane`
等待初始化完成之后，工程目錄下就多了一個(gè) fastlane目錄，其內(nèi)容如下：
fastlane文件
初始化后，我們還需要添加一個(gè)蒲公英測(cè)試平臺(tái)的插件以供提交測(cè)試，在終端輸入
fastlane add_plugin pgyer即可；然后到工程目錄下可以看到有個(gè)
fastlane文件創(chuàng)建成功了，子目錄里面有三個(gè)文件，一個(gè)Appfile，一個(gè)Fastfile文件，另一個(gè)Pluginfile，我們通過名稱可知他們的大概用途：Appfile用來編輯設(shè)置app_identifier，apple_id和team_id的信息;Pluginfile是存放蒲公英測(cè)試平臺(tái)的默認(rèn)配置；Fastfile管理你所創(chuàng)建的 lane ，了解詳情。它的格式是這樣的：
#---------- begin -----------
default_platform :ios
platform :ios do
desc "發(fā)布 蒲公英"
lane :beta_pgy do
gym(scheme: "Test",
export_method: "ad-hoc",
silent: true, # 隱藏沒有必要的信息
clean: true # 在構(gòu)建前先clean
)
pgyer(api_key: "b*******************************4",
user_key: "e********************************7",
update_description: get_update_description(),
# password: "123456",
# install_type: "2"
)
end
desc "發(fā)布 到 蘋果TestFlight"
lane :beta_apple do
gym(scheme: "Test"],
silent: true, # 隱藏沒有必要的信息
clean: true # 在構(gòu)建前先clean
)
pilot #管理TestFlight測(cè)試用戶，上傳二進(jìn)制文件
end
desc "發(fā)布蘋果商店"
lane :release_apple do
gym(scheme: "Test"],
silent: true, # 隱藏沒有必要的信息
clean: true # 在構(gòu)建前先clean
)
deliver #上傳截圖、元數(shù)據(jù)、App到iTunesConnect
end
#---------- end -------------
# You can define as many lanes as you want
after_all do |lane|
# This block is called, only if the executed lane was successful
# slack(
# message: "Successfully deployed new App Update."
# )
end
error do |lane, exception|
# slack(
# message: exception.message,
# success: false
# )
end
end
其中一個(gè)lane就是一個(gè)任務(wù)，里面是一個(gè)個(gè)的action組成的工作流。
利用目前支持的工具可以做所有包含自動(dòng)化和可持續(xù)化構(gòu)建的每個(gè)環(huán)節(jié)，例如：
- scan 自動(dòng)化測(cè)試工具，很好的封裝了 Unit Test
- sigh 針對(duì)于 iOS 項(xiàng)目開發(fā)證書和 Provision file 的下載工具
- match 同步團(tuán)隊(duì)每個(gè)人的證書和 Provision file 的超贊工具
- gym 針對(duì)于 iOS 編譯打包生成 ipa 文件
- deliver 用于上傳應(yīng)用的二進(jìn)制代碼，應(yīng)用截屏和元數(shù)據(jù)到 App Store
- snapshot 可以自動(dòng)化iOS應(yīng)用在每個(gè)設(shè)備上的本地化截屏過程
執(zhí)行l(wèi)ane
定義完lane之后怎么執(zhí)行呢？打開終端，切換到項(xiàng)目的根目錄：執(zhí)行fastlane lane'name就可以了。成功之后會(huì)在相應(yīng)的路徑下生成ipa文件，如果報(bào)錯(cuò)的話就根據(jù)錯(cuò)誤信息好好查看文檔。
如果安裝了mac版的蒲公英客戶端的朋友，在自動(dòng)打包完成之后，客戶端會(huì)自動(dòng)攔截ipa的動(dòng)作（前提是保證你的賬戶和fastfile里面對(duì)于蒲公英的配置api_key 和user_key的配置保持一致即可）然后將ipa上傳即可；
?怎么樣，my friend，這一波操作下來是不是省去的時(shí)間可以去喝杯咖啡了。來來來，接下來就是多個(gè)target環(huán)境使用fastlane自動(dòng)打包。這里分 3 部分來講解配置：
- 配置.env 文件(工程里面有幾個(gè)traget，需要?jiǎng)?chuàng)建幾個(gè).env)
- 配置 Deliverfile文件
- 如何使用其進(jìn)行打包
比如工程里面有兩個(gè)target（一個(gè)Test1，一個(gè)Test2），那么通過終端命令cd到上次初始化的fastlane目錄，然后在終端輸入touch .env.Test1，touch .env.Test2,繼續(xù)在當(dāng)前目錄下創(chuàng)建Deliverfiale，在終端輸入touch Deliverfile，創(chuàng)建完成后，你會(huì)發(fā)現(xiàn)在fastlane目錄下找不到剛剛創(chuàng)建的兩個(gè).env文件，可參考此文章,接下來對(duì).env.Test1和.env.Test2兩個(gè)文件進(jìn)行編輯;
.env.Test1內(nèi)容如下：
#APP唯一標(biāo)識(shí)符
APP_IDENTIFIER = "com.Peter.Test1"
#發(fā)布版本號(hào)
APP_VERSION_RELEASE = "2.4.0"
#新版本修改記錄
RELEASE_NOTES = "1) 升級(jí)測(cè)試第一行\(zhòng)n2) 升級(jí)測(cè)試第二行"
#蒲公英 更新描述
PGY_UPDATE_DESCRIPTION = "fastlane自動(dòng)打包上傳測(cè)試"
#自動(dòng)提交審核
SUBMIT_FOR_REVIEW = false
#審核通過后立刻發(fā)布
AUTOMATIC_RELEASE = false
#蘋果開發(fā)者賬號(hào)
APPLE_ID = "XXXXXXXXXXXXXX"
#蘋果開發(fā)者帳號(hào)密碼
FASTLANE_PASSWORD = "*************"
#套裝ID
TEAM_ID = "XXXXXXXXXXXXXX"
#應(yīng)用名稱
SCHEME_NAME = "Test1"
#APP元數(shù)據(jù)及截圖存放路徑
METADATA_PATH = "./metadata/Test1Copy"
SCREENSHOTS_PATH = "./screenshots/Test1Copy"
#APP元數(shù)據(jù)及截圖下載時(shí)，直接覆蓋原有數(shù)據(jù)，不詢問
DELIVER_FORCE_OVERWRITE = true
.env.Test2內(nèi)容如下：
#APP唯一標(biāo)識(shí)符
APP_IDENTIFIER = "com.Peter.Test2"
#發(fā)布版本號(hào)
APP_VERSION_RELEASE = "2.4.1"
#新版本修改記錄
RELEASE_NOTES = "1) 升級(jí)測(cè)試第一行\(zhòng)n2) 升級(jí)測(cè)試第二行"
#蒲公英 更新描述
PGY_UPDATE_DESCRIPTION = "fastlane自動(dòng)打包上傳測(cè)試"
#自動(dòng)提交審核
SUBMIT_FOR_REVIEW = false
#審核通過后立刻發(fā)布
AUTOMATIC_RELEASE = false
#蘋果開發(fā)者賬號(hào)
APPLE_ID = "XXXXXXXXXXXXXXXXXXXXX"
#蘋果開發(fā)者帳號(hào)密碼
FASTLANE_PASSWORD = "****************"
#套裝ID
TEAM_ID = "XXXXXXXXXXXXXXXXXXXXX"
#應(yīng)用名稱
SCHEME_NAME = "Test2"
#APP元數(shù)據(jù)及截圖存放路徑
METADATA_PATH = "./metadata/Test2Copy"
SCREENSHOTS_PATH = "./screenshots/Test2Copy"
#APP元數(shù)據(jù)及截圖下載時(shí)，直接覆蓋原有數(shù)據(jù)，不詢問
DELIVER_FORCE_OVERWRITE = true
Deliverfile內(nèi)容如下：
app_identifier ENV['APP_IDENTIFIER'] # The bundle identifier of your app
username ENV['APPLE_ID'] # your Apple ID user
# 元數(shù)據(jù)的路徑
metadata_path ENV['METADATA_PATH']
screenshots_path ENV['SCREENSHOTS_PATH']
#App store 中待發(fā)布的 App 版本，若每個(gè) target 的版本號(hào)不同，可以通過.env 文件來分別定義
app_version ENV['APP_VERSION_RELEASE']
#下載 metadata 及 screenshots 時(shí)直接覆蓋，不詢問
force true
#不覆蓋 iTunes Connect原有截圖
skip_screenshots true
#自動(dòng)提交審核
submit_for_review ENV['SUBMIT_FOR_REVIEW']
#審核通過后立刻發(fā)布
automatic_release ENV['AUTOMATIC_RELEASE']
#新版本修改記錄
release_notes({
"zh-Hans" => ENV['RELEASE_NOTES']
})
Appfile內(nèi)容如下：
# app_identifier("[[APP_IDENTIFIER]]") # The bundle identifier of your app
# apple_id("[[APPLE_ID]]") # Your Apple email address
# For more information about the Appfile, see:
# https://docs.fastlane.tools/advanced/#appfile
app_identifier ENV['APP_IDENTIFIER'] # The bundle identifier of your app
apple_id ENV['APPLE_ID'] # Your Apple email address
team_id ENV['TEAM_ID'] # Developer Portal Team ID
Fastfile內(nèi)容如下：
#---------- begin -----------
default_platform :ios
platform :ios do
desc "1).Test1版本 發(fā)布到 蒲公英"
lane :beta_test1_pgy do
sh "fastlane beta_pgy --env Test1"
end
desc "2).Test2版本 發(fā)布到 蒲公英"
lane :beta_test2_pgy do
sh "fastlane beta_pgy --env Test2"
end
desc "3).Test1版本 發(fā)布到 蘋果商店"
lane :release_test1_apple do
sh "fastlane release_apple --env Test1"
end
desc "4).Test2版本 發(fā)布到 蘋果商店"
lane :release_test2_apple do
sh "fastlane release_apple --env Test2"
end
desc "5).Test1版本 和 Test2版本 同時(shí) 發(fā)布到 蒲公英"
lane :beta_all_pgy do
sh "fastlane beta_pgy --env Test1"
sh "fastlane beta_pgy --env Test2"
end
desc "6).Test1版本 和 Test2版本 同時(shí) 發(fā)布到 蘋果TestFlight"
lane :beta_all_apple do
sh "fastlane beta_apple --env Test1"
sh "fastlane beta_apple --env Test2"
end
desc "7).Test1版本 和 Test2版本 同時(shí) 發(fā)布到 蘋果商店"
lane :release_all_apple do
sh "fastlane release_apple --env Test1"
sh "fastlane release_apple --env Test2"
end
desc "發(fā)布 指定版本 到 蒲公英"
lane :beta_pgy do
gym(scheme: ENV['SCHEME_NAME'],
export_method: "ad-hoc",
silent: true, # 隱藏沒有必要的信息
clean: true # 在構(gòu)建前先clean
)
pgyer(api_key: "b******************************4",
user_key: "e*******************************7",
update_description: get_update_description(),
# password: "123456",
# install_type: "2"
)
end
desc "發(fā)布 指定版本 到 蘋果TestFlight"
lane :beta_apple do
gym(scheme: ENV['SCHEME_NAME'],
silent: true, # 隱藏沒有必要的信息
clean: true # 在構(gòu)建前先clean
)
pilot
end
desc "發(fā)布 指定版本 到 蘋果商店"
lane :release_apple do
gym(scheme: ENV['SCHEME_NAME'],
silent: true, # 隱藏沒有必要的信息
clean: true # 在構(gòu)建前先clean
)
deliver
end
#---------- end -------------
# You can define as many lanes as you want
after_all do |lane|
# This block is called, only if the executed lane was successful
# slack(
# message: "Successfully deployed new App Update."
# )
end
error do |lane, exception|
# slack(
# message: exception.message,
# success: false
# )
end
end
到這里，所有的配置都已經(jīng)配置好了，另外還有一個(gè)需要設(shè)置的地方，在xcode開發(fā)工具中請(qǐng)將scheme的shared勾選上，如圖：
設(shè)置scheme1.png
設(shè)置scheme2.png
緊接著，在終端用命令進(jìn)入項(xiàng)目根目錄，輸入
fastlane ios命令,效果如下：
fastlane ios
[?] ??
[22:28:04]: fastlane detected a Gemfile in the current directory
[22:28:04]: however it seems like you don't use `bundle exec`
[22:28:04]: to launch fastlane faster, please use
[22:28:04]:
[22:28:04]: $ bundle exec fastlane ios
[22:28:04]:
[22:28:04]: Get started using a Gemfile for fastlane https://docs.fastlane.tools/getting-started/ios/setup/#use-a-gemfile
[22:28:04]: In the config file './fastlane/Deliverfile' you have the line app_identifier, but didn't provide any value. Make sure to append a value right after the option name. Make sure to check the docs for more information
+-----------------------+---------+--------+
| Used plugins |
+-----------------------+---------+--------+
| Plugin | Version | Action |
+-----------------------+---------+--------+
| fastlane-plugin-pgyer | 0.2.1 | pgyer |
+-----------------------+---------+--------+
[22:28:04]: ------------------------------
[22:28:04]: --- Step: default_platform ---
[22:28:04]: ------------------------------
[22:28:04]: Welcome to fastlane! Here's what your app is setup to do:
+--------+-------------------------+----------------------------------------+
| Available lanes to run |
+--------+-------------------------+----------------------------------------+
| Number | Lane Name | Description |
+--------+-------------------------+----------------------------------------+
| 1 | ios beta_test1_pgy | 1).test1版本 發(fā)布到 蒲公英 |
| 2 | ios beta_test2_pgy | 2).test2版本 發(fā)布到 蒲公英 |
| 3 | ios release_test1_apple | 3).test1版本 發(fā)布到 蘋果商店 |
| 4 | ios release_test2_apple | 4).test2版本 發(fā)布到 蘋果商店 |
| 5 | ios beta_all_pgy | 5).test1版本 和 test2版本 同時(shí) 發(fā)布到 |
| | | 蒲公英 |
| 6 | ios beta_all_apple | 6).test1版本 和 test2版本 同時(shí) 發(fā)布到 |
| | | 蘋果TestFlight |
| 7 | ios release_all_apple | 7).test1版本 和 test2版本 同時(shí) 發(fā)布到 |
| | | 蘋果商店 |
| 8 | ios beta_pgy | 發(fā)布 指定版本 到 蒲公英 |
| 9 | ios beta_apple | 發(fā)布 指定版本 到 蘋果TestFlight |
| 10 | ios release_apple | 發(fā)布 指定版本 到 蘋果商店 |
| 0 | cancel | No selection, exit |
| | | fastlane! |
+--------+-------------------------+----------------------------------------+
[22:28:04]: Which number would you like run?
1
此時(shí)，你想打什么包就打什么包，是不是很隨心所欲呀？！
自動(dòng)打包成功.png
fastlane自動(dòng)打包發(fā)布蒲公英.png
由于時(shí)間的問題，我就不一一進(jìn)行測(cè)試了，剩下的就交給各位朋友們自行測(cè)試看看效果。。。。
?親們，如遇到問題可隨時(shí)交流，歡迎來撩！
