Deploying apps to DeployGate from Bitrise

DeployGate is a mobile app distribution platform for iOS and Android, delivering your in-development iOS/Android apps to your dev team, members, employees, QA testing team in your organization or testers outside of your company.

DeployGate has many features to accelerate your app development cycle including QA testing and app improvement with beta tester’s feedbacks.

DeployGate offers:

  • Real-time App distribution with automatic version control, even without requiring accounts for testers

  • Flexible user account management with granular access control

  • Git-like multi-track distribution allows individual version/user/device management for the same app

With DeployGate and Bitrise, you can quickly build a fully automated in-house dogfooding environment for your team. To see more details, please visit DeployGate Features.

Automated app distribution workflow

To upload your app to DeployGate, add the DeployGate Upload Step to your bitrise workflow.

DeployGate Workflow Step

This Step should be added after the Step that builds your app's binary that will be uploaded. You need to set several required parameters as below:

Input Variables

Description

API Key

Set upload user’s DeployGate API Key from Account Settings.

If you want to upload apps as organization account, please use organization’s API Key. Upload account will be shown on the activity timeline.

Owner Name

App owner’s account name in DeployGate.

You can use username or organization name.

App file path

App’s binary file (IPA/APK) to be uploaded.

For default setting, use $BITRISE_APK_PATH for Android or $BITRISE_IPA_PATH for iOS

App Visibility

You can list your app name and icon on your DeployGate profile page. This variable effects in just for visibility, not for allowing download or install by anonymous.

You can also set optional variables for using advanced features as below:

Input Variables

Description

Short Message

Summary of update shown on DeployGate.

You can use $BITRISE_GIT_MESSAGE if you want to use the commit message, the pull request title, or the message you specified when you triggered the build manually.

Distribution Key

You can make multiple public install links (we called it Distribution Page) for a different version of app binary in the same app.

By specifying the distribution page’s hash, that distribution page will be updated simultaneously. The “xxxx” portion of the distributed page’s URL like https://deploygate.com/distributions/xxxx

Distribution Name

Specify the name of the updated distribution page. If nothing exists, a new distribution page will be created. Possible usage includes creating distribution pages for each Git branch name. (for example $BITRISE_GIT_BRANCH)

Release Note

Message for the new release in distribution page. This message will be notified to your distribution page’s testers

Disable Notify(iOS Only)

There is no DeployGate client app in iOS platform. By default, we use email notifications for release updates. If you don’t need email notification, please set this option as true

These options are based on DeployGate API. For more details, please read the references at DeployGate.com.

You can use DeployGate's Distribution Page (Shareable link) feature to generate a landing page for the app installation of your app’s specific version.

Distribution Page

When you upload an app to DeployGate, the system automatically assigns a sequential number (we are calling it **Revision Number**) for each uploaded build. On the Distribution Page, you can choose specific revision of app to distribute for each group of testers. This feature is handy for distributing your app to multiple tester groups for different purposes such as QAs, Dog Fooding, or Test Marketing.

You can also generate a distribution page when you upload an app from Bitrise with DeployGate Upload step. Please refer to the optional variables above.