Pgyer Docs
CI/CD & Dev Tools

Upload via Fastlane

Install and configure Pgyer's Fastlane plugin to upload the app Fastlane just built.

Fastlane is an automation tool for iOS and Android developers that strings together build, signing, testing, release, and App Store submission into a single workflow. With Pgyer's Fastlane plugin, the app Fastlane just built is uploaded to Pgyer automatically.

Prerequisites

  • macOS or Linux.
  • Ruby, RubyGems, and Bundler installed.
  • Fastlane installed — see the official setup guide if needed.
  • Your Pgyer API Key — find it under App Management → Overview → API.
Reference environment used in this guide: macOS 10.13, Xcode 9.2, Fastlane 2.78.0, fastlane-plugin-pgyer 0.2.1.

Install the Plugin

In the terminal:

fastlane add_plugin pgyer

A message similar to the screenshot below indicates a successful install:

fastlane

Configure the Plugin

From the app project directory, initialize Fastlane:

fastlane init

Fastlane creates a fastlane folder in the project with a fastlane/Fastfile config. Open it:

vim ./fastlane/Fastfile

Find the lane you use and append the Pgyer plugin call after build_app:

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

On Xcode 8.3 and later, build_app needs an export_method matching the packaging type — options are app-store, ad-hoc, development, enterprise. Older Xcode versions don't require it.

Build and Upload

From the project directory:

fastlane beta

On success, you'll see output similar to:

fastlane

Advanced Usage

Set an Install Password

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

Set Release Notes

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

Troubleshooting

  • Hit an error? Upgrade Fastlane, Xcode, and fastlane-plugin-pgyer to the latest versions and retry.
  • If the issue is in Fastlane itself, uninstall and reinstall it.

On this page