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.
Oculus Device:
Minimum System Requirements:
The following requirements are applicable to both, Oculus Rift and Oculus Rift S, unless otherwise stated:
For more information about detailed specifications, go to Oculus Rift and Oculus Rift S minimum requirements support page.
Operating System (any one):
Development Software:
For detailed setup instructions and troubleshooting, go to Getting started with your Oculus Quest support page.
You need to connect Oculus Rift and Oculus Rift S to your computer over USB and display interfaces. For detailed setup instructions and troubleshooting, go to Getting started with your Oculus Rift and Getting started with Oculus Rift S support pages.
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 2018.4.x. We recommend using one of the following versions: 2019.4 LTS or 2020.1.
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.
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.
Note: This option is only available for Unity 2019.x versions and if you’ve installed Unity through Unity Hub. Alternatively, you can install Android tools manually as described in the following section.
If you’re using Unity 2018.x or prior, you need to install Android tools manually through Android Studio.
Select Android SDK Tools from the list and click OK.
Note: Android Studio 3.6 or later considers Android SDK Tools as obsolete. If you’re using either of these versions, first clear Hide Obsolete Packages from the bottom of the tab to show the Android SDK Tools option in the list.
In the expanded NDK (Side by side) list, select 16.1.4479499 version, clear any other versions selected, and click OK.
Note: Unity supports Android NDK, Revision 16b only.
After you’ve installed Unity, create a fresh project to get started with the rest of the settings and app development.
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.
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:
/Users/username/Library/Android/sdk/
./Users/username/Library/Android/sdk/ndk/
.