Version: 2019.3
Using the Unity Editor to configure Unity Cloud Build for Git
Using the Unity Editor to configure Unity Cloud Build for Mercurial

Using the Unity Developer Dashboard to configure Unity Cloud Build for Mercurial

Unity Cloud Build supports projects stored in Mercurial repositories. Your can host your repository on Bitbucket or on a private server.

To connect to your repository, Unity Cloud Build requires that you supply appropriate access credentials. This applies to Mercurial repositories hosted on Bitbucket or elsewhere.

Configuring Mercurial in the Dashboard

  1. Sign in to the Unity Developer Dashboard.
  2. From the Projects page, select your Project.
  3. In the left-hand navigation pane, click Cloud Build > Config.
  4. If this is the first time you have configured Cloud Build, you see a Build History page informing you that Cloud Build has not been set up for this project. Click the Set up Cloud Build link to continue.
  5. In the Source Control window, click the Manual tab.
  6. In the SCM URL field, enter the URL of your Mercurial server. For information on the format of the URL, see the URL syntax section below.
  7. From the SCM Type drop-down menu, select Mercurial.
  8. Click the Next Access button.

URL syntax

To connect to your repository, you must specify the URL to your Mercurial server. You can specify the URL to use the following protocols:

  • HTTPS

  • SSH

The following are examples of URLs for bitbucket:

  • https://github.com/youraccount/yourrepo

  • git@bitbucket.org:youraccount/yourrepo.git

Use the format that is most convenient for you. Unity Cloud Build automatically re-writes the URL into the format it needs.

Setting your credentials

On your Mercurial server, create a user name for Unity Cloud Build and assign a secure password. If your Mercurial host supports it, make this a read-only user account.

On the Grant us access to your source control window, enter your user name and password, and then click Next: Target Setup.

Dashboard grant access window
Dashboard grant access window

Setting up the target build platform

In the Target Setup window, select a build platform.

On the Developer Dashboard, on the NEW BUILD TARGET: BASIC INFO window:

  1. In the Target Label field, enter a name for the build.

  2. If the root folder of your repository doesn’t contain your Assets and Project settings, in the Project Subfolder field, enter the URL of the folder that contains your Assets and Project Settings.

  3. From the Unity Version drop-down menu, select the version of Unity with which to build the Project.

  4. If you do not want the Project to automatically build whenever your repository is updated, click the Auto-build toggle to disable this feature.

If you are building for the iOS or Android platforms, your next step is to enter credentials for the build. Click Next: Credentials. For all other platforms, click Next: Build to complete the configuration and start the initial build.

Android credentials

On the IOS SIGNING CREDS window supply the following information:

  • A Bundle ID to uniquely identify your app on the device and in Google Play Store.

  • Enter your Android keystore credentials or select Auto Generated Debug Keystore to use a development keystore. For more information on Android keystores, see Android Keystore System.

iOS Credentials

On the IOS SIGNING CREDS window supply the following information:

  • A Bundle ID to uniquely identify your app on the device.

  • The Xcode version with which to build the app.

  • Enter your IOS credentials. For more information on iOS credentials, see Building for iOS.


2018–04–10 Page published

Using the Unity Editor to configure Unity Cloud Build for Git
Using the Unity Editor to configure Unity Cloud Build for Mercurial