Set Up Development Environment

This topic describes how to set up your development environment to build Oculus apps in Unity. It contains information about hardware and software requirements, setting up Oculus devices, and installing Unity Editor and other necessary tools.

Hardware Requirements

Oculus Device:

Minimum System Requirements:

  • 2.0+ GHz processor
  • 2 GB system RAM

Software Requirements

Operating System (any one):

  • Windows 10 (64-bit versions only)
  • macOS Sierra 10.10 or higher (x86 only) (supported with limited features)

Development Software:

Set Up Oculus Device

  1. Download the Oculus companion app for Android or iPhone and set up user account.
  2. Go to settings in your app and select the type of Oculus device you want to pair from the list.
  3. Follow the on-screen instructions to pair the device and its controllers.
  4. Follow the in-VR instructions to complete the generic device settings.

For detailed setup instructions and troubleshooting, go to Getting started with your Oculus Quest support page.

Install Unity Editor

Unity Editor versions, whether free or professional, support Windows and Android development. If you are just getting started as a Unity developer, we recommend spending time learning the basics with Unity’s documentation and tutorials.

The minimum supported Unity version for Oculus app development is 2019.4 LTS. We recommend using the minimum supported Unity version or higher.

We have condensed Unity installation steps below. However, for detailed information about the Unity installation process, go to Installing Unity in Unity documentation.

To install Unity:

Unity Hub is an installation assistant that makes the installation process easy. In addition to Unity, to build and run Android apps, you must install the Android Build Support module, Android Software Development Kit (SDK) and Native Development Kit (NDK), and OpenJDK. Unity 2019.x and higher versions let you install the necessary Android tools during the Unity installation.

  1. Go to Unity Download page, click Download Unity Hub, and install it.
  2. On the Installs tab, click Add, and select the Unity version from the list.
  3. In the Add modules to your install window, select Android Build Support and expand it, select Android SDK & NDK Tools and OpenJDK, and click Done. This is only available for Unity version 2019.x and higher. For Unity 2018.x and prior, go to Install Android Tools Manually.

In case, you’ve already installed Unity without Android support, you can still add Android tools from Unity to any existing Unity 2019.x versions.

  1. Open Unity Hub and click the Installs tab.
  2. Click the three dots next to the Unity 2019.x version and click Add Modules.
  3. In the Add Modules window, select Android Build Support and expand it, select Android SDK & NDK Tools and OpenJDK, and click Done.

Create New Project

After you’ve installed Unity, create a fresh project to get started with the rest of the settings and app development.

  1. Open Unity Hub.
  2. Click Projects tab and click New. If you’ve installed multiple Unity versions, click the arrow next to New and select the Unity version that you want to use to create the project.
  3. Select 3D, enter project name and location, and click Create.

After you’ve created the project, Unity adds it to Unity Hub. To open an existing Unity project, open Unity Hub, and click the project name.

Map Android Tools in Unity

If you’re using Unity version 2019.x and later, Unity automatically maps Android SDK and NDK. However, if you’re using Unity version 2018.x and prior, the first time you build an Android project in Unity, you need to locate the Android SDK folder.

To map or change the location of the Android SDK in Unity:

  1. Open Android Studio to verify the Android SDK location through Tools > SDK Manager.
  2. Open Unity project or create a new one.
  3. From the menu, go to Unity > Preferences > External Tools.
  4. Under Android, in SDK, paste the Android SDK path. Alternatively, click Browse to locate the Android SDK folder. For example, /Users/username/Library/Android/sdk/.
  5. In NDK, paste the NDK folder path. Usually, NDK tools are downloaded inside the SDK folder. For example, /Users/username/Library/Android/sdk/ndk/.