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

Unity Cloud Build supports Projects stored in Perforce repositories.

Note: This feature requires a subscription to Unity Teams Advanced. For more information, see the Unity Teams page.

This topic covers:

• Configuring Perforce in the Dashboard
• Setting up a target build platform

Configuring Perforce on the Dashboard

To configure Cloud Build to build your Project from a Perforce repository:

1. Sign in to the Unity Developer Dashboard.

2. On 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 dashboard Overview window, on the Cloud BuildA continuous integration service for Unity Projects that automates the process of creating builds on Unity’s servers. More info
   See in Glossary tile, click OPEN CLOUD BUILD DASHBOARD.

4. In the Build History window, click Set up Cloud Build.

5. In the Source Control window, click the MANUAL tab.

6. In the SCM URL field, enter the URL of your Perforce server in either of the following formats:

   • Non-SSL: host:port
   • SSL: ssl:host:port

7. To connect to your repository, you must specify the URL to your Perforce server. For information on the format of the URL, see the URL syntax section below.

8. From the SCM Types drop-down menu, select PerforceA version control system for file change management. More info
   See in Glossary.

9. Click the NEXT: ACCESS button. When Unity Cloud Build connects to the hosting site, it automatically detects whether your repository is public or private. If your repository is public, Cloud Build automatically connects to it and you can skip to Setting up a target build platform.

10. On the the Grant us access to your source control window, enter the user Username and Password for your Perforce repository.

11. Click NEXT: TARGET SETUP.

URL syntax

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

• HTTPS
• SSL

The following are examples of valid URLs:

• https://127.0.0.1:1667
• ssl:127.0.0.1:167

Setting up a target build platform

In the dashboard, on the NEW BUILD TARGET: BASIC INFO window:

1. In the Target Label field, enter a name for the build.
2. From the Client Workspace drop-down menu, select the workspace from which to build your Project.
3. 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.
4. From the Unity Version drop-down menu, select the version of Unity with which to build the Project.
5. 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

In the Android 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

In 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.