iOS自动化打包-Fastlane入门

iOS开发者都经历过在测试阶段一遍一遍地Product->Archive->WaitWait>Export->Confirm，然后打开网页上传到蒲公英或者fir发给测试，每次打个包至少花费5分钟，上传iTunesConnect的话时间就更久了，如果你还是在这么做，那么是时候考虑引入自动化打包了，节约下来的时间可以做很多事。本文将以最简单的步骤配置Fastlane，达到自动化打出AdHoc包并上传到蒲公英或者fir的目的。更详细的教程和原理讲解会在文末列出。

1.安装fastlane

1.1确保安装了最新版的Xcode command line tools

xcode-select --install

1.2选择安装方式

Homebrew	Installer Script	Rubygems(Ruby 2.0.0 或者以上)
brew cask install fastlane	下载压缩包. 然后双击安装脚本.	sudo gem install fastlane -NV

1.3安装bundler

sudo gem install bundler

2.配置fastlane

cd到项目的根目录下

2.1初始化fastlane

fastlane init

会询问你AppleID和密码，填完之后fastlane会自动检测当前项目的App Name和App Identifier并显示在屏幕上，如果检测不对，在确认信息的时候选择n然后手动输入。

2.2初始化Gemfile

新建Gemfile

vim Gemfile 

然后填入以下内容

source "https://rubygems.org"

gem "fastlane"
gem "cocoapods"

运行 bundle update 命令，然后将Gemfile和Gemfile.lock加入git管理

2.3安装蒲公英和fir插件

fastlane add_plugin pgyer  #蒲公英
fastlane add_plugin firim    #fir.im

2.4配置Fastfile

在Fastfile中：
action => Fastlane中的每一条命令都是一个action
lane => Fastlane中流程的合集

使用vim打开Fastfile

vim ./fastlane/Fastfile

以下是我的lane，分别对应了上传到蒲公英，fir的配置

#打出测试包，上传到蒲公英
  lane :beta do            // beta是lane的名字，可以修改
  gym(output_name: "beta", # 导出的ipa名字
           scheme: "debug",  # 用哪个scheme打包，关于scheme的使用可参考我的上一篇文章
    export_method: "ad-hoc",# export_method 可以根据打包类型进行相应设置。可选的值有：app-store、ad-hoc、development、enterprise
 output_directory:"~/Documents/ipa")# ipa导出目录
  pgyer(api_key: "df59c69bfe382fa70f3e96acf104****", user_key: "33d775f94e25df07938ca164241****")// 蒲公英的key
  end

#打出正式包，上传到fir.im
  lane :release do |op|
increment_version_number(version_number: op[:version]) #根据入参version获取app版本号
  gym(output_name: "appstore",
           scheme: "Release",
    export_method: "ad-hoc",
 output_directory:"~/Documents/ipa") 
 firim(firim_api_token:"637bfd3dfeb2c123bd45de864575a****") # fir.im api_token
 
  end

#打出正式包，上传到iTunes Connect
  lane :itunes do
  gym(output_name: "AppStore",
           scheme: "YMPicture_Release",
    export_method: "app-store",
 output_directory:"~/Documents/ipa")
  appstore       # 上传你的App iTunes Connect
  end

3.执行自动化打包

1.测试包上传到蒲公英

fastlane beta

2.正式包上传到fir

fastlane release version:版本号
如
fastlane release version:1.0.0

3.上传到itunes connect

fastlane itunes

4.升级Fastlane

bundle update fastlane

5.常见错误

1. It seems like you wanted to load some plugins, however they couldn't be loaded
   解决方法：
   https://github.com/fastlane/fastlane/blob/master/fastlane/docs/PluginsTroubleshooting.md
   2.升级Xcode 9 之后打包导出失败
   解决办法：
   gym里面要加入export_options ，详见
   https://docs.fastlane.tools/codesigning/xcode-project/#xcode-9-and-up

2019.1.16更新

最近升级到macOS Mojave，fastlane 打包报错。解决方法是升级ruby到2.5.1，重新安装fastlane。

参考资料

官方文档
小团队的自动化发布－Fastlane带来的全自动化部署
Fastlane实战（一）：移动开发自动化之道
Fastlane实战（二）：Action和Plugin机制
Fastlane实战（四）：自动化测试篇
Fastlane实战（五）：高级用法