Fastlane是一套使用Ruby寫的自動化工具集夺衍,用于iOS和Android的自動化打包浙芙、發(fā)布等工作捐迫,可以節(jié)省大量的時間乾翔。
Fastlane
Github:https://github.com/fastlane/fastlane
官網(wǎng):https://fastlane.tools/
文檔:https://docs.fastlane.tools/
在寫這篇文章的時候,他在Github上已經(jīng)有15000+ star。
安裝
1反浓、首先要安裝正確的 Ruby 版本萌丈。在終端窗口中用下列命令來確認(rèn):
ruby -v
2、然后檢查 Xcode 命令行工具是否安裝雷则。在終端窗口中輸入命令:
xcode-select --install
如果未安裝辆雾,終端會開始安裝,如果報錯誤:
command line tools are already installed, use "Software Update" to install updates.代表已經(jīng)安裝月劈。
3度迂、以上依賴配置好之后就可以通過 rubygem 進(jìn)行安裝了:
$ sudo gem install fastlane
安心等待一會,fastlane就安裝完成了猜揪。
初始化
打開終端惭墓,cd到你的工程目錄,然后執(zhí)行fastlane init:
$ cd to/your/ios/project $ fastlane init[14:21:43]: Detected iOS/Mac projectincurrent directory...[14:21:43]: This setup will help you get upandrunninginno time.[14:21:43]: fastlane will check what tools you're already using and set up
[14:21:43]: the tool automatically for you. Have fun!
[14:21:43]: Created new folder './fastlane'.
[14:21:43]: $ xcodebuild -showBuildSettings -project ./xxx.xcodeproj
[14:21:48]: Your Apple ID (e.g. fastlane@krausefx.com): xxx@xxx.xom
[14:21:54]: Verifying that app is available on the Apple Developer Portal and iTunes Connect...
[14:21:54]: Starting login with user 'xxx@xxx.com'
+----------------+--------------------------------------+
|? ? ? ? ? ? ? ? ? ? Detected Values? ? ? ? ? ? ? ? ? ? |
+----------------+--------------------------------------+
| Apple ID? ? ? | xxx@xxx.com? ? ? ? ? ? ? ? ? ? |
| App Name? ? ? | xxx? ? ? ? ? ? ? ? ? ? ? ? ? ? |
| App Identifier | com.xxx.xxx? ? ? ? ? ? ? ? |
| Project? ? ? ? | /Users/lisong/Desktop/xxx/x? |
|? ? ? ? ? ? ? ? | xx.xcodeproj? ? ? ? ? ? ? ? ? ? |
+----------------+--------------------------------------+
[14:22:06]: Please confirm the above values (y/n)
y
[14:22:09]: Created new file './fastlane/Appfile'. Edit it to manage your preferred app metadata information.
[14:22:09]: Loading up 'deliver', this might take a few seconds
[14:22:09]: Login to iTunes Connect (xxx@xxx.com)
[14:22:13]: Login successful
+-----------------------+------------------------+
|? ? ? ? ? ? deliver 2.30.1 Summary? ? ? ? ? ? |
+-----------------------+------------------------+
| screenshots_path? ? ? | ./fastlane/screenshots |
| metadata_path? ? ? ? | ./fastlane/metadata? ? |
| username? ? ? ? ? ? ? | xxx@xxx.com? ? ? |
| app_identifier? ? ? ? | com.xxx.xxx? |
| edit_live? ? ? ? ? ? | false? ? ? ? ? ? ? ? ? |
| platform? ? ? ? ? ? ? | ios? ? ? ? ? ? ? ? ? ? |
| skip_binary_upload? ? | false? ? ? ? ? ? ? ? ? |
| skip_screenshots? ? ? | false? ? ? ? ? ? ? ? ? |
| skip_metadata? ? ? ? | false? ? ? ? ? ? ? ? ? |
| force? ? ? ? ? ? ? ? | false? ? ? ? ? ? ? ? ? |
| submit_for_review? ? | false? ? ? ? ? ? ? ? ? |
| automatic_release? ? | false? ? ? ? ? ? ? ? ? |
| dev_portal_team_id? ? | WKR87TTKML? ? ? ? ? ? |
| overwrite_screenshots | false? ? ? ? ? ? ? ? ? |
+-----------------------+------------------------+
[14:22:21]: Writing to 'fastlane/metadata/zh-Hans/description.txt'
...
[14:22:21]: Writing to 'fastlane/metadata/review_information/notes.txt'
[14:22:21]: Successfully created new configuration files.
[14:22:22]: Successfully downloaded large app icon
[14:22:22]: Downloading all existing screenshots...
[14:22:27]: Downloading existing screenshot '1_iphone4_1.1.jpg' for language 'zh-Hans'
···
[14:22:34]: Downloading existing screenshot '5_iphone6_5.5.jpg' for language 'zh-Hans'
[14:22:34]: Successfully downloaded all existing screenshots
[14:22:34]: Successfully created new Deliverfile at path 'fastlane/Deliverfile'
[14:22:34]: $ xcodebuild -list -project ./xxx.xcodeproj
[14:22:35]: 'snapshot' not enabled.
[14:22:35]: 'cocoapods' enabled.
[14:22:35]: 'carthage' not enabled.
[14:22:35]: Created new file './fastlane/Fastfile'. Edit it to manage your own deployment lanes.
[14:22:35]: fastlane will collect the number of errors for each action to detect integration issues
[14:22:35]: No sensitive/private information will be uploaded
[14:22:35]: Learn more at https://github.com/fastlane/fastlane#metrics
[14:22:35]: Successfully finished setting up fastlane
在 "Your Apple ID" 這一步輸入蘋果開發(fā)者賬號而姐。在“Please confirm the above values”這一步腊凶,確認(rèn)信息,沒問題輸入 y拴念。然后钧萍,fastlane 會進(jìn)行一系列的初始化操作,包括下載 App Store 上的元數(shù)據(jù)和截屏文件政鼠。
等待初始化完成之后风瘦,工程目錄下就多了一個 fastlane目錄,其內(nèi)容如下:
fastlane目錄
咱們來看兩個主要的缔俄,Appfile和Fastfile弛秋。
Appfile
Appfile用來存放app_identifier,apple_id和team_id俐载。了解詳情蟹略,它的格式是這樣的:
app_identifier"com.xxx.xxx"# app的bundle identifierapple_id"xxx@xxx.com"# 你的Apple IDteam_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:inhousedoapp_identifier"com.bbb.bbb"apple_id"bbb@bbb.com"team_id"AAAAAAAAAA"end
這里就是為Fastfile中定義的:inhouse設(shè)置單獨的信息遏佣。
Fastfile
Fastfile管理你所創(chuàng)建的 lane挖炬,了解詳情。它的格式是這樣的:
···# 自動更新fastlane 工具# update_fastlane#需要的fastlane的最小版本状婶,在每次執(zhí)行之后會檢查是否有新版本意敛,如果有會在最后末尾追加新版本提醒fastlane_version"2.30.1"#默認(rèn)使用平臺是 ios,也就是說文件可以定義多個平臺default_platform:iosplatform:iosdobefore_alldo# ENV["SLACK_URL"] = "https://hooks.slack.com/services/..."cocoapodsenddesc"Runs all the tests"lane:testdoscanenddesc"提交一個新的Beta版本到 Apple TestFlight"desc"This will also make sure the profile is up to date"lane:betado# match(type: "appstore") # more information: https://codesigning.guidegym(scheme:"Docment")# Build your app - more options availablepilot# sh "your_script.sh"enddesc"部署一個新版本到App Store"lane:releasedo# match(type: "appstore")# snapshotgym(scheme:"Docment")# Build your app - more options availabledeliver(force:true)# frameitend# 你可以定義自己的lane#執(zhí)行l(wèi)ane成功后的回調(diào)after_alldo|lane|# slack(#? message: "Successfully deployed new App Update."# )end# 如果流程發(fā)生異常會走這里并終止errordo|lane, exception|# slack(#? message: exception.message,#? success: false# )endend
我們也可以定義一個自己的lane:
desc"企業(yè)版"lane:inHousedogym(scheme:"XXX",export_method:"enterprise",output_directory:"./build",# 打包后的 ipa 文件存放的目錄output_name:"XXX.ipa"# ipa 文件名)end
其中一個lane就是一個任務(wù)膛虫,里面是一個個的action組成的工作流草姻。
利用目前支持的工具可以做所有包含自動化和可持續(xù)化構(gòu)建的每個環(huán)節(jié),例如:
scan自動化測試工具稍刀,很好的封裝了 UnitTest
sigh針對于 iOS 項目開發(fā)證書和 Provision file 的下載工具
match同步團(tuán)隊每個人的證書和 Provision file 的超贊工具
gym針對于 iOS 編譯打包生成 ipa 文件
deliver用于上傳應(yīng)用的二進(jìn)制代碼撩独,應(yīng)用截屏和元數(shù)據(jù)到 App Store
snapshot可以自動化iOS應(yīng)用在每個設(shè)備上的本地化截屏過程
執(zhí)行
定義完lane之后怎么執(zhí)行呢敞曹?打開終端,切換到項目的根目錄:執(zhí)行fastlane lane'name就可以了综膀。成功之后會在相應(yīng)的路徑下生成ipa文件澳迫,如果報錯的話就根據(jù)錯誤信息好好查看文檔。
其他
1剧劝、這里是官方提供的一些例子橄登。
2、想了解fastlane命令的話可以執(zhí)行$ fastlane --help
3讥此、查看可用任務(wù)的列表拢锹,可以執(zhí)行命令$ fastlane lanes
4、fastlane也提供了很多插件方便我們使用暂论,例如pgyer(發(fā)布app到蒲公英)面褐。我們也可以打完包直接傳到蒲公英上,具體的可以看蒲公英提供的文檔取胎。
如果你感覺有些插件不符合自己的情況展哭,你甚至可以自定義插件
5、多個 lane 的話實際上是可以相互調(diào)用的闻蛀,這個其實特別實用匪傍。例如:
default_platform:iosplatform:iosdolane:preparedococoapods? ? matchenddesc'fastlane build''fastlane build type:adhoc'lane:builddo|options|# 調(diào)用上面的 prepare 任務(wù)preparecaseoptions[:type]when'adhoc'adhocelseappstoreendendlane : adhocdo···endlane : appstoredo···endend
6、我們可以在 Fastfile 文件中添加一個函數(shù)來設(shè)置version號和build號觉痛。
default_platform:iosdefprepare_version(options)increment_version_number(version_number:options[:version]? ? )? ? increment_build_number(build_number:options[:build]? ? )end
然后可以在一個lane中使用這個函數(shù):
lane:appstoredo|options|···? ? prepare_version(options)? ···end
然后執(zhí)行這個lane的時候:
$ fastlane appstoreversion:2.4.0build:2.0
好啦役衡,先說到這里吧,F(xiàn)astlane能做的事情還有很多薪棒,大家可以去好好看看文檔手蝎,研究一些高級的用法吧!
作者:徐鳳年_
鏈接:http://www.reibang.com/p/abd3d2707b53
來源:簡書
著作權(quán)歸作者所有俐芯。商業(yè)轉(zhuǎn)載請聯(lián)系作者獲得授權(quán)棵介,非商業(yè)轉(zhuǎn)載請注明出處。