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出现类似下图的提示即表示安装成功:

配置插件
进入 App 的开发目录,初始化 Fastlane:
fastlane initFastlane 会在项目目录下生成 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_app 的 export_method,可选值为 app-store、ad-hoc、development、enterprise。Xcode 8.3 以下版本无需设置。
打包并上传
在终端定位到项目目录,执行:
fastlane beta成功后会看到类似下图的输出:

进阶用法
设置安装密码
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 自身,可尝试卸载后重新安装。