使用 Fastlane 實現 iOS 跟 Android 自動打包腳本

對於一個iOS APP的發佈上線，通常來講都須要經歷:編譯打包 -> 截圖 -> 填寫一些說明文字 -> 上傳ipa到itunes connect -> 提交供審覈。每次都要進行這麼多「繁瑣」的步驟，對於某些步驟可能一次還不能執行成功須要等着界面提示上傳錯誤而後手動從新再來一次（想一想都以爲可怕）。 在平常開發中，打包也是最後上線不可缺乏的環節，若是須要生成ipa文件一般須要在Xcode裏點擊Product -> Archive，而後在彈出來的Organizer中選擇導出什麼類型(ad hoc/enterprise)的包。對於大項目來講動輒編譯十分鐘以上的來講，一天打幾個包就差很少過去了。 爲了解決這些問題，Felix Krause 大神寫了一個工具集 fastlane。fastlane 是一套使用Ruby寫的自動化工具集，用於 iOS 和 Android 的自動化打包、發佈等工做。

前言

最近用shell打包ipa發現終端老是提示:
shell error: exportArchive: "***.app" requires a provisioning profile.
把配置文件刪除從新下載也同樣，因此索性從新換用另外一種腳本工具來打包ipa，發現這個仍是挺好用的

介紹

• Fastlane是一套使用Ruby寫的自動化工具集，用於 iOS 和 Android 的自動化打包、發佈等工做，能夠節省大量的時間。

• Github：github.com/fastlane/fa…
  官網： fastlane.tools
  文檔： docs.fastlane.tools

配置環境

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

• 若是沒有安裝，則輸入命令安裝 gym: sudo gem install gym

• 確保Xcode命令行工具安裝最新版本，使用以下命令進行安裝: xcode-select --install

• 以上依賴配置好以後就能夠經過 rubygem 進行安裝 fastlane: sudo gem install fastlane

• 完成安裝

fastlane實戰

初始化

• 打開終端，cd到你的工程目錄，而後執行 fastlane init 命令開始初始化

• 在執行的過程當中會要求填寫一些項目的資料，如 Apple ID 等，fastlane 會自動檢測當前目錄下項目的 App Name 和 App Identifier，能夠選擇自行輸入這些信息。初始化完成會在當前目錄下面生成一個fastlane的文件夾。

• 最重要的兩個文件就是 Appfile 和 Fastfile，主要的說明以下

• Appfile裏面存放了App的基本信息包括 app_identifier、apple_id、team_id 等，若是在 init 的時候輸入了正確的 apple_id 和密碼會自動獲取 team_id。

• Fastfile 是最重要的一個文件，在這個裏面能夠編寫和定製咱們的自動化腳本，全部的流程控制功能都寫在這個文件裏面。

fastfile 文件

Fastfile 管理你所建立的 lane ，瞭解詳情。它的格式是這樣的：

desc "企業版"
lane :inHouse do
gym(scheme: "XXX",
export_method:"enterprise",
output_directory "./build", # 打包後的 ipa 文件存放的目錄
output_name "XXX"  # ipa 文件名
)
end
複製代碼

---

個人用法

fastfile 文件裏主要修改四個地方內容

1. platform :ios do（安卓，iOS 均可以用）

2. desc "ad_Hoc 版本"（對 lane 的描述，fastlane 會自動將 desc 的內容生成說明文檔）

3. lane :beta do （定義一個 lane (任務)，能夠理解爲一個函數，咱們在執行的時候使用 fastlane lane 名稱，好比 cd到項目根目錄，而後 fastlane beta ）

4. gym(scheme: 「項目名稱」, export_method:"app-store",output_directory: "./build",）

我通常用gym語法操做

gym(scheme: scheme_name, clean: true, export_method:'appstore', configuration: configuration, output_directory: output_directory, output_name: output_name)
複製代碼

結果

此次我只是用來打包測試，fastlane裏的源碼：

# This file contains the fastlane.tools configuration
# You can find the documentation at https://docs.fastlane.tools
# For a list of all available actions, check out``
#
# https://docs.fastlane.tools/actions
#
# For a list of all available plugins, check out
#
# https://docs.fastlane.tools/plugins/available-plugins
#

# Uncomment the line if you want fastlane to automatically update itself
# update_fastlane
# 指定打包所使用的輸出方式，目前支持 app-store, package, ad-hoc, enterprise, development, 和developer-id


default_platform(:ios)

platform :ios do
desc "ad_Hoc 版本"
lane :beta do
gym(scheme: "***",
export_method:"ad-hoc",
output_directory: "./build",#文件路徑
)
end
end
複製代碼

---

接下來咱們開始進階教程，將打包好的 ipa 上傳到 fir 在Fastfile文件裏寫入：

# This is the minimum version number required.
# Update this, if you use features of a newer version
# 指定打包所使用的輸出方式，目前支持 app-store, package, ad-hoc, enterprise, development, 和developer-id



default_platform :ios

platform :ios do


desc "開始打包-內測版--開發證書 - dev"
#內測版--開發證書
lane :adhoc do 
#開始打包
puts "開始打包-內測版--開發證書 - dev"

gym(
export_method:"ad-hoc",
output_directory:"/Users/weiyuxiang/Desktop/Order/build",# 打包後的 ipa 文件存放的目錄
) 
#使用fir-cli上傳ipa
sh "fir publish /Users/weiyuxiang/Desktop/Order/build/***.ipa -T fir的token"
end

desc "開始打包 -- 企業公測版--hoc"
lane :inhoc do
gym(
export_method:"app-store",
output_directory:"/Users/weiyuxiang/Desktop/Order/build",
)
#使用fir-cli上傳ipa
sh "fir publish /Users/weiyuxiang/Desktop/Order/build/***.ipa -T fir的token"
end

end
複製代碼

在測試的時候用
fastlane adhoc
上架則用
fastlane inhoc
到這裏通常沒有問題，可是樓主我還會遇到一個問題，最後用fir上傳的時候會報這些錯誤：

/Users/weiyuxiang/.rvm/rubies/ruby-2.2.4/lib/ruby/gems/2.2.0/gems/fastlane-2.95.0/fastlane_core/lib/fastlane_core/ui/interface.rb:153:in `shell_error!': [!] Exit status of command 'fir publish /Users/weiyuxiang/Desktop/Order/build/***.ipa -T a5bd6574b7292220d5c4b44b6' was 1 instead of 0. (FastlaneCore::Interface::FastlaneShellError) /Users/weiyuxiang/.rvm/gems/ruby-2.2.4@global/gems/bundler-1.16.1/lib/bundler/rubygems_integration.rb:458:in `block in replace_bin_path': can't find executable fir for gem fir-cli. fir-cli is not currently included in the bundle, perhaps you meant to add it to your Gemfile? (Gem::Exception) from /Users/weiyuxiang/.rvm/gems/ruby-2.2.4@global/gems/bundler-1.16.1/lib/bundler/rubygems_integration.rb:478:in `block in replace_bin_path'
from /Users/weiyuxiang/.rvm/gems/ruby-2.2.4/bin/fir:22:in `<main>' from /Users/weiyuxiang/.rvm/gems/ruby-2.2.4/bin/ruby_executable_hooks:15:in `eval'
from /Users/weiyuxiang/.rvm/gems/ruby-2.2.4/bin/ruby_executable_hooks:15:in `<main>' 複製代碼

按照錯誤提示，在 Gemfile 文件里加一句： gem "fir" 便可

---

Fastlane 能作的事情還有不少，你們能夠去好好看看Fastlane文檔，研究一些高級的用法吧！