Fastlane 使用大致流程如下：

思路弄清楚后操作時，參照demo中的文件修改即可。參數(shù)可以自定義配置（參數(shù)說明可查看官方文檔）?

一.安裝fastlane

1.安裝最新的Xcode命令行工具：

xcode-select --install

2.使用安裝fastlane,下面兩種方法使用其中一個即可

sudo gem install fastlane -NV

或者：

brew cask install fastlane

Fastlane官方文檔https://docs.fastlane.tools/getting-started/ios/setup

現(xiàn)在對Appfile，F(xiàn)astfile，Gemfile，Deliverfile文件說明如下（后面會用到）

Appfile: 存儲有關(guān)開發(fā)者賬號相關(guān)信息

Fastfile: 核心文件，用于命令行調(diào)用和處理具體的流程，lane相對于一個action方法或函數(shù)?

Gemfile 類似于cocopods 的Podfile文件

.env 配置環(huán)境變量（在fastlane init進(jìn)行初始化后并不會自動生成，如果需要可以自己創(chuàng)建

Deliverfile: deliver工具的配置文件，上傳截圖蘋果和后臺一些app信息 ?(默認(rèn)不生成，需要sudo gem install deliver安裝)然后在fastlane 目錄下執(zhí)行deliver init 即可）

要注意的點：

build_app命令等同于gym(別名)

deliver 命令相當(dāng)于upload_to_app_store(別名)

二. 使用（操作流程）

2.1?在項目目錄下執(zhí)行 ? ?fastlane init

新版本安裝的時候出現(xiàn)了下面的分支選擇，按要求選擇就行

1. ??? Automate screenshots （自動截屏

2. ?????? Automate beta distribution to TestFlight (自動testfilght型配置)

3. ??? Automate App Store distribution (自動發(fā)布型配置)

4. ??? Manual setup - manually setup your project to automate your (需要手動配置內(nèi)容)

這里我們選擇4，然后一直按回車。會生成Gemfile文件，fastlane文件夾，Appfile，F(xiàn)astfile文件

Appfile: 存儲有關(guān)開發(fā)者賬號相關(guān)信息

Fastfile: 核心文件，用于命令行調(diào)用和處理具體的流程，lane相對于一個action方法或函數(shù)?

Gemfile 類似于cocopods 的Podfile文件

.env 配置環(huán)境變量（在fastlane init進(jìn)行初始化后并不會自動生成，如果需要可以自己創(chuàng)建

Deliverfile: deliver工具的配置文件，上傳截圖等 (默認(rèn)不生成，需要sudo gem install deliver安裝)然后在fastlane 下執(zhí)行deliver init 即可）#此處不使用，自己去蘋果后臺配置

注意：自動生成的Gemfile里的路徑需要把'.' 改為'fastlane'

plugins_path = File.join(File.dirname(__FILE__), '.', 'Pluginfile')eval_gemfile(plugins_path) if File.exist?(plugins_path)

plugins_path = File.join(File.dirname(__FILE__), 'fastlane', 'Pluginfile') eval_gemfile(plugins_path) if File.exist?(plugins_path)

執(zhí)行init

執(zhí)行init后生成

2.2.1 修改Fastfile文件（以下為部分示例，后面有完整demo。這種使用時在項目目錄下執(zhí)行fast lane即可）?

????desc "Push a new release build to the 蒲公英"?

????lane :pgyAction do

? ? increment_build_number(xcodeproj: "XXXX")//這里是build版本號自增，防止小于等于之前build號，這里需要打開Xcode-- build Setting --Versioning System --為Apple Generic (此處有坑，后面解釋)

? ? build_app(workspace: "項目名", scheme: "XXXX")

? ? # 插件 --- 蒲公英

? ? # fastlane add_plugin pgyer ? 發(fā)布到蒲公英需要執(zhí)行這個命令安裝pgyer工具

? ? # fastlane add_plugin firim ? ?發(fā)布到firim需要執(zhí)行這個命令安裝firim工具

? ? # fastlane add_plugin fastlane-plugin-version ?安裝版本管理

?? pgyer(api_key:"XXXX", ? ?

? ?user_key:"XXXX")

? ?#這里的"XXX"可以使用.env里的環(huán)境變量替換為?ENV['User_Key'] 注：User_Key環(huán)境變量

? end

使用時在項目目錄下執(zhí)行fastlane 即可，選擇對應(yīng)操作

還有一種寫法外部傳入版本號和build參數(shù) (這種使用時需fastlane adhoc_pgy version:1.5 build:1?

fastlane ?lane名稱 version:?build:）

?# 函數(shù)（一個方法）

desc "版本處理"

def setup_version_build(options)

increment_build_number(

build_number:options[:build])

increment_version_number(

version_number:options[:version])

end

---------------------------------------------------

desc "上線蒲公英"

lane :adhoc_pgy do |options|

setup_version_build(options)#調(diào)用上面函數(shù)

#increment_build_number(xcodeproj: ENV['Xcodeproj'])#不需要執(zhí)行這行

build_app(

workspace: ENV['Workspace'],#指定workspace (使用cocopods)

scheme: ENV['Scheme'],#指定打的哪個scheme

silent: true,

clean: true,#打包前clean

output_directory: ENV['Pgy_Output_Path'],#輸出目錄

output_name: logDirectory,#輸出名字

export_xcargs: "-allowProvisioningUpdates",#允許自動更新配置

export_method:"ad-hoc")#出包方法 app-store, ad-hoc, package, enterprise, development

pgyer(api_key: ENV['Api_Key'],

user_key: ENV['User_Key'])#ENV['XX']使用環(huán)境變量，看2.2.3

end

2.2.2修改Appfile文件(部分)

# Appfile使用.env方式直接讀取變量即可（看2.2.3）

app_identifier???????? ENV['App_Identifier']

apple_id? ? ? ???????????? ENV['Apple_Id']

team_id ? ? ? ? ? ? ? ? ? ?ENV['Team_Id']

2.2.3 添加環(huán)境變量.env

在fastlane文件夾下創(chuàng)建添加.env 環(huán)境變量（touch .env ）

例如：# 蒲公英的api_key

Api_Key = "de1a6608cce966dee05a5df3c654113b"

# 蒲公英的user_key

User_Key = "cd4b534a73e5bce41a9fa92b1fdc7b31"

2.2.4 添加發(fā)布到蒲公英和fir工具，如不需要可跳過

? 在項目中fastlane目錄下執(zhí)行

? fastlane add_plugin pgyer ? 發(fā)布到蒲公英需要執(zhí)行這個命令安裝pgyer工具

? fastlane add_plugin firim ? ?發(fā)布到firim需要執(zhí)行這個命令安裝firim工具

? 安裝后生成Pluginfile

2.3以上要修改的地方修改好了（發(fā)布是否需要指定版本號和build）

1.不需要指定版本號，使用build自增（不指定版本號，使用時執(zhí)行fastlane命令）

increment_build_number(xcodeproj: ENV['Xcodeproj'])#修改Fastfile 需要執(zhí)行這行?

---------------------------------------------------------

2.指定版本號和build（使用時執(zhí)行fastlane + lane名?version:X build:X）例如fastlane adhoc_pgy version:1.5 build:1??

setup_version_build(options)#調(diào)用函數(shù) ?#修改Fastfile ?需要執(zhí)行這行?

不指定版本選3發(fā)布蒲公英

如出現(xiàn)Apple Generic Versioning is Not enabled ，需要打開Xcode-- build Setting --Versioning System --為Apple Generic 。如果已經(jīng)打開，還是報錯。Xcode10的問題，需要在Xcode菜單欄選擇File-- Workspace Setting就會出現(xiàn)如下的界面，選擇Legacy Build即可

出現(xiàn)SuccessFully Exported 則導(dǎo)出ipa和dSYM成功

導(dǎo)出ipa

發(fā)布蒲公英成功如下圖：

導(dǎo)出包成功發(fā)布成功

是否需要自動發(fā)布APP后臺截圖和更新信息備注等：配置有兩種方法

發(fā)布到appstore時發(fā)現(xiàn)后臺的描述不見了或者被覆蓋了，需要在lane 里添加禁止使用元數(shù)據(jù)和截圖.不傳截圖和元數(shù)據(jù) skip_screenshots，skip_metadata設(shè)為true。要傳的話設(shè)為false 如下圖。（PS:可以配置多個參數(shù)，需要可查看下面Deliver文件說明傳送門）

1.修改Fastfile文件pload_to_app_store 方法添加參數(shù)

pload_to_app_store(skip_screenshots: true,skip_metadata: true )

2.在fantlane文件夾下，修改Deliverfile 文件，如下圖（沒有的話在fantlane文件夾下執(zhí)行deliver init）

skip_screenshots(true)?

skip_metadata(true)

如果需要手動上傳元數(shù)據(jù)等，可以先更新下來，然后修改需要的txt文件。如下圖：截圖則放在screenshots下即可.發(fā)布時會彈出一個html文件預(yù)覽配置的信息（如下圖），終端會彈出Does the Preview on path './fastlane/Preview.html' look okay for you？查看沒問題后y ，如果錯了n ，然后修改。

從App Store Connect下載現(xiàn)有屏幕截圖

fastlane deliver download_screenshots

從App?Store?Connect下載現(xiàn)有元數(shù)據(jù)

fastlane deliver download_metadata