Fastlane 简介
Fastlane 是一款为 iOS 和 Android 开发者提供的自动化构建工具,它可以帮助开发者将 App 打包、签名、测试、发布、信息整理、提交 App Store 等工作完整的连接起来,实现完全自动化的工作流,如果使用得当,可以显著的提高开发者的开发效率。
为了让使用 Fastlane 的用户,可以将 Fastlane 的自动化工作流与蒲公英结合起来,我们为大家提供了 Fastlane 的蒲公英插件。该插件使用起来非常简单,安装该插件后,由 Fastlane 打包生成的 App 可以自动上传到蒲公英。
前置条件
开发者使用的是 mac 或 linux 系统
已经安装好 ruby、rubygems、bundler
已经安装了 Fastlane。如果没有安装,请参考:官方安装指南
开发者了解基本的 App 开发流程、终端的使用方法
本文使用环境为:macOS 10.13, Xcode 9.2, Fastlane 2.78.0, fastlane-plugin-pgyer 0.2.1
安装蒲公英的 Fastlane 插件
在终端中,输入以下命令,即可安装蒲公英的 fastlane 插件。
fastlane add_plugin pgyer
稍等几秒钟,如果出现类似下面的信息,就说明安装成功了:
在 Fastlane 启动蒲公英插件
在使用 Fastlane 之前,我们首先需要在项目中初始化 Fastlane。首先进入 App 的开发目录,执行以下命令来初始化 Fastlane:
fastlane init
执行上述命令后,Fastlane 会自动在 App 目录中生成 fastlane 目录,其中就会有 Fastlane 的配置文件 fastlane/Fastfile,这里,我们用 vim 打开:
vim ./fastlane/Fastfile
然后,我们找到我们在用的工作流(action),在 build_app 指令后,加入蒲公英插件的配置信息。例如:
lane :beta do
build_app(export_method: "ad-hoc")
pgyer(api_key: "7f15xxxxxxxxxxxxxxxxxx141", user_key: "4a5bcxxxxxxxxxxxxxxx3a9e")
end
注意:
以上的 api_key 和 user_key,请开发者在自己账号下的 应用管理 - App概述 - API 中可以找到,并替换到以上相应的位置。
在 Xcode 8.3 和 Xcode 8.3 以后的版本中,对于 build_app 的 export_method 的值,需要根据开发者的打包类型进行设置,可选的值有:app-store、ad-hoc、development、enterprise。对于 Xcode 8.3 以下的版本,则不需要设置 export_method。
打包并自动上传 App 到蒲公英
经过以上配置后,就可以使用 Fastlane 来打包 App,并自动上传到蒲公英了。在终端下,定位到项目所在目录,输入以下命令即可:
fastlane beta
在成功的情况下,可以看到类似下面的信息:
进阶用法
您也可以设置 App 上传到蒲公英时,设置密码:
lane :beta do
build_app(export_method: "ad-hoc")
pgyer(api_key: "7f15xxxxxxxxxxxxxxxxxx141", user_key: "4a5bcxxxxxxxxxxxxxxx3a9e", password: "123456", install_type: "2")
end
设置一个版本更新时的描述信息:
lane :beta do
build_app(export_method: "ad-hoc")
pgyer(api_key: "7f15xxxxxxxxxxxxxxxxxx141", user_key: "4a5bcxxxxxxxxxxxxxxx3a9e", update_description: "update by fastlane")
end
错误排查
出现错误时,首先请升级到最新版本的 Fastlane、Xcode、和 fastlane-plugin-pgyer 插件,然后进行重新尝试;
如果是 Fastlane 本身的问题,可以尝试卸载 Fastlane 后,重新安装。