Using the Unity Developer Dashboard to configure Cloud Build for Mercurial

Cloud Build supports projects stored in Mercurial repositories. You can host your repository on Bitbucket or 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 ProjectsIn Unity, you use a project to design and develop a game. A project stores all of the files that are related to a game, such as the asset and Scene files. More info
   See in Glossary page, select your Project.
3. In the left-hand navigation pane, click Cloud BuildA continuous integration service for Unity projects that automates the process of creating builds on Unity’s servers. More info
   See in Glossary > 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 username 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 click Next: Target Setup.

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 settingsA broad collection of settings which allow you to configure how Physics, Audio, Networking, Graphics, Input and many other areas of your project behave. More info
   See in Glossary, 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 iOSApple’s mobile operating system. More info
See in Glossary 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 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 keystoreAn Android system that lets you store cryptographic key entries for enhanced device security. More info
  See in Glossary 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