蒲公英文档中心

Fastlane 上传应用

蒲公英 Fastlane 插件的安装与配置方法,将 Fastlane 打包生成的 App 自动上传到蒲公英。

Fastlane 是面向 iOS 与 Android 开发者的自动化构建工具,可将打包、签名、测试、发布、提交 App Store 等环节串联为完整的工作流。通过蒲公英 Fastlane 插件,打包生成的 App 可自动上传到蒲公英。

前置要求

  • macOS 或 Linux 系统。
  • 已安装 Ruby、RubyGems 和 Bundler。
  • 已安装 Fastlane,若尚未安装请参考 官方安装指南
  • 蒲公英 API Key:可在 应用管理 → App 概述 → API 中查看。
本文演示环境:macOS 10.13、Xcode 9.2、Fastlane 2.78.0、fastlane-plugin-pgyer 0.2.1。

安装插件

在终端执行:

fastlane add_plugin pgyer

出现类似下图的提示即表示安装成功:

fastlane

配置插件

进入 App 的开发目录,初始化 Fastlane:

fastlane init

Fastlane 会在项目目录下生成 fastlane 文件夹,其中包含配置文件 fastlane/Fastfile。打开该文件:

vim ./fastlane/Fastfile

找到当前使用的工作流(lane),在 build_app 指令后加入蒲公英插件配置:

lane :beta do
  build_app(export_method: "ad-hoc")
  pgyer(api_key: "YOUR_API_KEY")
end

在 Xcode 8.3 及以上版本中,需根据打包类型设置 build_appexport_method,可选值为 app-storead-hocdevelopmententerprise。Xcode 8.3 以下版本无需设置。

打包并上传

在终端定位到项目目录,执行:

fastlane beta

成功后会看到类似下图的输出:

fastlane

进阶用法

设置安装密码

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

设置版本更新描述

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

错误排查

  • 出现错误时,先将 Fastlane、Xcode 与 fastlane-plugin-pgyer 升级到最新版本后重试。
  • 若问题出在 Fastlane 自身,可尝试卸载后重新安装。

本页目录