1.前言
前段时间应测试要求，需要重复测试App安装启动，为了避免重复性的工作和节省时间，所以就想到了用 Fastlane 自动化打包上传到蒲公英方便测试安装。
2.简介
Fastlane 是一套使用Ruby写的自动化工具集，用于iOS和Android的自动化打包、发布等工作，可以节省大量的时间。
3.安装
3.1 安装正确的Ruby版本，需要2.0及以上版本：
ruby -v
3.2 然后检查 Xcode 命令行工具是否安装：
xcode-select --install
报如下错误，说明已安装：
3.3 通过RubyGem安装 Fastlane 工具集:
sudo gem install fastlane
执行命令时，输入用户密码，如下图安装完成：
4.配置
4.1 打开终端，进入你的工程目录，然后执行 fastlane init：
执行过程中，需要输入对应的苹果开发账号。接下来，出现确认提示，确认无误输入y：
4.2 Fastlane 初始化完成后，工程目录下会自动生成 fastlane 文件夹，如下所示：
-
metadata： 目录：存放 App 元数据，包括 App 简介，Icon，Copyright 等； -
screenshots： 目录：顾名思义，存放 App store 中的截图； -
Appfile：用于指定app_identifier,apple_id,team_id； -
Deliverfile：用于指定跟 App 版本发布相关的信息，除了apple_identifier外，还包括submit_for_review,automatic_release等可配置项，基本覆盖 iTunes Connect 里面的所有选项 -
Fastfile：用于编写逻辑脚本，使用 ruby 语言，例如首先执行 cocoapods 更新第三方依赖库，然后执行 pem 更新相关证书，接着通过 gym 来编译并打包 ipa 文件，最后通过 deliver 发布到 iTunes Connect 中，并提交审核。具体逻辑按照开发者需求自行设计。
推荐使用Sublime Text工具打开 Appfile、Deliverfile 和 Fastfile 三个配置文件，首次打开是以文本格式显示的，可设置文件默认格式为Ruby。
进入 fastlane 文件，执行如下命令：
open -a /Applications/Sublime\ Text.app/ Appfile Deliverfile Fastfile
操作步骤：在Sublime Text 工作窗口，点击右下角Plain Text区域，出现的下拉菜单中选择Ruby，之后文件内容将以Ruby语法格式打开，便于编辑查看。三个文件需要分别设置默认格式。
4.3 安装蒲公英的 Fastlane 插件
在终端中，输入以下命令，即可安装蒲公英的 fastlane 插件：
fastlane add_plugin pgyer
执行过程中，出现确认提示，确认无误输入y，接下来，需要输入两次用户密码即可。
稍等几秒钟，如果出现类似下面的信息，就说明安装成功了：
5.执行
5.1 在 Fastlane 配置蒲公英插件
首先，进入工程目录，并打开 Fastlane 的配置文件（一般在 fastlane/Fastfile），这里我们用 Sublime Text打开。
然后，我们找到我们在用的工作流（action），在 gym 指令后，加入蒲公英插件的配置信息。例如：
desc "发布 测试版本 到 蒲公英"
lane :beta_pgy do
gym(export_method: "ad-hoc")
pgyer(api_key: "d066f633dc2d970eb230dba7823ff022",
user_key: "4477d913a078c11df32be931523619dc",
update_description: "fastlane自动打包上传测试 ",
password: "123456",
install_type: "2")
end
注意：
以上的 api_key 和 user_key，请开发者在自己账号下的 应用管理 - App概述 - API 中可以找到，并替换到以上相应的位置。password 为安装时，需要输入的密码，install_type 为安装类型。
5.2 打包并自动上传 App 到蒲公英
bundle exec fastlane beta_pgy
执行过程中，如果出现如下错误，需要在工程目录下的Gemfile文件中添加如下信息：
gem 'cocoapods'
保存文件后，重新执行下面的命令：
bundle exec fastlane beta_pgy
稍等几十秒，最后如果出现类似下面的信息，就说明Fastlane打包上传成功了，可以进入蒲公英【我的应用】扫码下载。打包上传成功截图如下：
5.3 配置文件
有时候我们希望把账号信息、更新描述和版本号等信息单独放在一个配置文件。在这里Fastlane给我们提供了相应的解决方案。
我们可以在工程目录下创建一个名为 .env 的文件，自定义所需的临时变量，然后Fastlane的三个配置文件（Appfile、Deliverfile和Fastfile）分别从.env文件中读取配置信息。
关于ENV用法可参考以下链接：
https://docs.fastlane.tools/advanced/#environment-variables
https://github.com/bkeepers/dotenv
.env 文件为影藏文件，可使用如下命令查看：
ls -a
截图如下：
下面给出的 .env 文件配置可做参考：
.env :
#APP唯一标识符
APP_IDENTIFIER = "xxx.xxx.TestGitProject"
#发布版本号
APP_VERSION_RELEASE = "1.1.0"
#新版本修改记录
RELEASE_NOTES = "1) 升级测试第一行\n2) 升级测试第二行"
#蒲公英 更新描述
PGY_UPDATE_DESCRIPTION = "fastlane自动打包上传测试"
#自动提交审核
SUBMIT_FOR_REVIEW = false
#审核通过后立刻发布
AUTOMATIC_RELEASE = false
#苹果开发者账号
APPLE_ID = "[email protected]"
#苹果开发者帐号密码
FASTLANE_PASSWORD = "xxxxxx"
#套装ID
TEAM_ID = "94xxxxx02"
#应用名称
SCHEME_NAME = "TestGitProject"
#APP元数据及截图存放路径
METADATA_PATH = "./metadata/TestGitProject"
SCREENSHOTS_PATH = "./screenshots/TestGitProject"
#APP元数据及截图下载时，直接覆盖原有数据，不询问
DELIVER_FORCE_OVERWRITE = true
Appfile、Deliverfile和Fastfile配置文件修改如下：
Appfile ：
app_identifier ENV['APP_IDENTIFIER'] # The bundle identifier of your app
apple_id ENV['APPLE_ID'] # Your Apple email address
team_id ENV['TEAM_ID'] # Developer Portal Team ID
Deliverfile :
app_identifier ENV['APP_IDENTIFIER'] # The bundle identifier of your app
username ENV['APPLE_ID'] # your Apple ID user
Fastfile :
desc "发布 测试版本 到 蒲公英"
lane :beta_pgy do
gym(scheme: ENV['SCHEME_NAME'],
export_method: "ad-hoc",
silent: true, # 隐藏没有必要的信息
clean: true # 在构建前先clean
)
pgyer(api_key: ENV['PGY_API_KEY'],
user_key: ENV['PGY_USER_KEY'],
update_description: ENV['PGY_UPDATE_DESCRIPTION'],
password: "123456",
install_type: "2")
end
配置文件截图如下：
修改完上述配置文件后，重新执行以下命令：
bundle exec fastlane beta_pgy
6.其他
Fastlane 如何实现多 Target 自动化打包发布，以及如何配置 Appfile、Deliverfile 和 Fastfile 等配置文件，发布和构建版本号自增，修改更新内容，自动上传苹果商店和自动提交审核，可参考另一篇文章：Fastlane 实现多 Target 自动化打包发布
参考链接：
- �Fastlane 使用中遇到的问题
- 使用 Fastlane 上传 App 到蒲公英