簡介
Fastlane是一套使用Ruby寫的自動化工具集,用于iOS和Android的自動化打包、發布等工作,可以節省大量的時間。
Github:https://github.com/fastlane/fastlane
官網:https://fastlane.tools/
文檔:https://docs.fastlane.tools/
安裝
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[14:21:43]: Detected iOS/Mac project in current directory...[14:21:43]: This setup will help you get up and running in no 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” 這一步輸入蘋果開發者賬號。在“Please confirm the above values”這一步,確認信息,沒問題輸入 y。然后,fastlane 會進行一系列的初始化操作,包括下載 App Store 上的元數據和截屏文件。
等待初始化完成之后,工程目錄下就多了一個 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 :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 :iosplatform :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 # ) endend我們也可以定義一個自己的lane: desc "企業版" lane :inHouse do gym(scheme: "XXX", export_method:"enterprise", output_directory "./build", # 打包后的 ipa 文件存放的目錄 output_name "XXX" # ipa 文件名 ) end
其中一個lane就是一個任務,里面是一個個的action組成的工作流。
利用目前支持的工具可以做所有包含自動化和可持續化構建的每個環節,例如:
scan 自動化測試工具,很好的封裝了 Unit Test
sigh 針對于 iOS 項目開發證書和 Provision file 的下載工具
match 同步團隊每個人的證書和 Provision file 的超贊工具
gym 針對于 iOS 編譯打包生成 ipa 文件
deliver 用于上傳應用的二進制代碼,應用截屏和元數據到 App Store
snapshot 可以自動化iOS應用在每個設備上的本地化截屏過程
執行
定義完lane之后怎么執行呢?打開終端,切換到項目的根目錄:執行fastlane lane'name就可以了。成功之后會在相應的路徑下生成ipa文件,如果報錯的話就根據錯誤信息好好查看文檔。
其他
1、這里是官方提供的一些例子。
2、想了解fastlane命令的話可以執行$ fastlane 主站蜘蛛池模板: 鄂伦春自治旗| 新泰市| 霍山县| 彭泽县| 枣强县| 保山市| 建阳市| 东乌珠穆沁旗| 合山市| 龙陵县| 砀山县| 瑞丽市| 克拉玛依市| 剑河县| 安化县| 盘山县| 太湖县| 博客| 天等县| 博湖县| 顺昌县| 醴陵市| 江油市| 松原市| 长白| 乌审旗| 大英县| 绥滨县| 汉川市| 房山区| 海城市| 昌平区| 兴仁县| 平江县| 崇文区| 甘孜县| 汉源县| 正宁县| 万州区| 香格里拉县| 略阳县|