Unity Build Automation: Quick start guide

1. Overview

Unity Build Automation (UBA) is a continuous integration/continuous delivery/deployment (CI/CD) service designed to empower creators to build in the cloud. Unity Build Automation allows you to keep developing while your builds compile in the cloud, across multiple platforms. This frees up your time to try more ideas, test more frequently, find bugs faster, and deliver high-quality games and applications to market.

2. Sign in to the Unity Cloud Dashboard

To begin, create a Unity account or login to the Unity Dashboard with your existing Unity ID.

3. Navigate to the DevOps gaming services page

From the DevOps gaming service page, select Product > DevOps > Launch.

4. Connect to your preferred source control provider

Under Build Automation > Settings, select the Source control tab, then select your preferred source control system to host your project. Finally, select the Save button.

5. Set up build target configurations

Under Build Automation > Configurations, select Quick target setup for basic configurations or Target setup for more advanced settings for your build target. You’ll then be prompted to select the target platform you want to build your game for. Build Automation currently supports building for iOS, macOS, Windows, Linux, Android, WebGL, UWP, and Xbox (currently in Alpha). Once you have chosen the platform you’ll need to fill out the following settings:

• Basic info: Some fields will populate based on your project. Verify and fill out required fields.

• Builder configurations: Operating system and machine specifications for your build.

• Scheduling: Gives you the option to set up auto-build triggers or recurring builds (this is optional).

Note: Select platforms may have additional required fields to fill out.

Select the Save configuration button to continue.

6. Build your project

Under Build Automation > Build history, locate your newly created build configuration and select the Build button to the right of the configuration. Select Build again to initiate the process. After you trigger a build, you’ll get a notification when the build is complete.

Under Build Automation > Build history, you can check out the status of your build. For successful builds, you can download the artifacts and share them. For failed builds, you can view and troubleshoot issues in the generated Log.

7. Getting started with Unity Build Automation

If you want to learn more about build automation in Unity, make sure to check out this video tutorial. You’ll learn how to streamline the process of building for multiple platforms as well as how to move your local build pipeline to the Unity Cloud so you can automate builds with every update.

If you want to ensure your team collaboration is smooth and efficient, make sure to check out the: Best practices for project organization and version control guide (Unity 6 edition).

8. Next steps

Great job! Now you’re ready to build across multiple platforms in the cloud.

If you need more help getting started, check out the Unity Build Automation documentation. Want to see UBA in action? Read how Second Dinner pushed 30+ multi platform builds a day using UBA while developing Marvel Snap.