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.常见错误
- 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实战（五）：高级用法
