Pgyer document center

使用 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 开发流程、终端的使用方法
  5. 本文使用环境为: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 之前,我们首先需要在项目中初始化 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")
end

注意:

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

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

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

fastlane beta

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

fastlane

进阶用法

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

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

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

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

错误排查

  1. 出现错误时,首先请升级到最新版本的 Fastlane、Xcode、和 fastlane-plugin-pgyer 插件,然后进行重新尝试;
  2. 如果是 Fastlane 本身的问题,可以尝试卸载 Fastlane 后,重新安装。