使用 Fastlane 上传 App 到蒲公英

Fastlane 简介

Fastlane 是一款为 iOS 和 Android 开发者提供的自动化构建工具,它可以帮助开发者将 App 打包、签名、测试、发布、信息整理、提交 App Store 等工作完整的连接起来,实现完全自动化的工作流,如果使用得当,可以显著的提高开发者的开发效率。

为了让使用 Fastlane 的用户,可以将 Fastlane 的自动化工作流与蒲公英结合起来,我们为大家提供了 Fastlane 的蒲公英插件。该插件使用起来非常简单,安装该插件后,由 Fastlane 打包生成的 App 可以自动上传到蒲公英。

前置条件

  1. 开发者使用的是 mac 或 linux 系统
  2. 已经安装好 ruby、rubygems、bundler
  3. 已经安装了 Fastlane。如果没有安装,请参考:官方安装指南
  4. 开发者了解基本的 App 开发流程、终端的使用方法

安装蒲公英的 Fastlane 插件

在终端中,输入以下命令,即可安装蒲公英的 fastlane 插件。

fastlane add_plugin pgyer

稍等几秒钟,如果出现类似下面的信息,就说明安装成功了:

fastlane

在 Fastlane 启动蒲公英插件

首先,进入 App 的开发目录,并打开 Fastlane 的配置文件(一般在 fastlane/Fastfile),这里我们用 vim 打开:

vim ./fastlane/Fastfile

然后,我们找到我们在用的工作流(action),在 gym 指令后,加入蒲公英插件的配置信息。例如:

lane :beta do
  gym(export_method: "ad-hoc")
  pgyer(api_key: "7f15xxxxxxxxxxxxxxxxxx141", user_key: "4a5bcxxxxxxxxxxxxxxx3a9e")
end

注意:

  1. 以上的 api_keyuser_key,请开发者在自己账号下的 应用管理 - App概述 - API 中可以找到,并替换到以上相应的位置。
  2. 在 Xcode 8.3 和 Xcode 8.3 以后的版本中,对于 gymexport_method 的值,需要根据开发者的打包类型进行设置,可选的值有:app-storead-hocdevelopmententerprise。对于 Xcode 8.3 以下的版本,则不需要设置 export_method

打包并自动上传 App 到蒲公英

经过以上配置后,就可以使用 Fastlane 来打包 App,并自动上传到蒲公英了。在终端下,定位到项目所在目录,输入以下命令即可:

bundle exec fastlane beta

在成功的情况下,可以看到类似下面的信息:

fastlane

进阶用法

您也可以设置 App 上传到蒲公英时,设置密码:

lane :beta do
  gym(export_method: "ad-hoc")
  pgyer(api_key: "7f15xxxxxxxxxxxxxxxxxx141", user_key: "4a5bcxxxxxxxxxxxxxxx3a9e", password: "123456", install_type: "2")
end

设置一个版本更新时的描述信息:

lane :beta do
  gym(export_method: "ad-hoc")
  pgyer(api_key: "7f15xxxxxxxxxxxxxxxxxx141", user_key: "4a5bcxxxxxxxxxxxxxxx3a9e", update_description: "update by fastlane")
end