Preparing for Android Development

Important

All Oculus Quest developers MUST PASS the concept review prior to gaining publishing access to the Quest Store and additional resources. Submit a concept document for review as early in your Quest application development cycle as possible. For additional information and context, please see Submitting Your App to the Oculus Quest Store.


We're no longer accepting submission of 32-bit Oculus Quest apps. Any new or updated Oculus Quest application needs to be 64-bit. Please contact Oculus if you are unable to comply with this policy. Oculus Go and Gear VR apps will not be affected by this change.

To prepare for Unity development for Android platforms, like the Oculus Quest, you must set up the Unity Editor for Android development and install the Android SDK.

We recommend reviewing Unity’s Getting started with Android development for general information on Android development, but the essential setup steps are described below.

Once you have set up the Unity Editor for Android development, VR support is enabled by checking the Virtual Reality Supported checkbox in Player Settings.

Unity automatically applies orientation tracking, stereoscopic rendering, and distortion correction to your main camera when VR support is enabled. For more details, see Unity VR Support.

If you are already prepared for Unity Android development, you’re almost ready to begin development.

Device Setup

Follow the instructions in the Oculus Quest Device Setup sections of our Mobile SDK Developer Guide to prepare to run, debug, and test your mobile applications.

Select a Device to Target

When configuring the Unity Editor for your project, you must select the device(s) that you’re going to target.

Android SDK

The Android SDK is required for Android development with Unity. For setup instructions, Android Development Software Setup in our Mobile SDK Developer Guide. Most Unity developers do not need to install Android Studio or NDK.

Once you have installed the Standalone Android SDK tools, you may continue with this guide.

Once you have installed the Android SDK, you may wish to familiarize yourself with adb (Android Debug Bridge), a useful tool used for communicating with your Android phone. For more information, see Adb in our Mobile Developer Guide.

Add the Application ID

The Application ID is your app’s unique identifier. Add this ID to your Unity project by navigating to Oculus / Platform / Edit Settings and populating the ID in the inspector.

You can retrieve your Application ID from the API page on the Oculus Dashboard.

Getting Started with Android Development

Android applications are subject to more stringent limitations and requirements and computational limitations than Rift applications.

We strongly recommend carefully reviewing Android Development and Best Practices in our Developer Guide to be sure you understand our performance targets and recommendations for mobile development. These sections contain important information that can help you avoid mistakes that we see frequently.

Additional Sources of Information

For information on Oculus tools to assist with development, such as our Sample Framework or the Oculus Remote Monitor for performance debugging, please see Other Oculus Resources for Unity Developers.

For information on core VR development concepts, see the VR Development Best Practices.

Most Unity developers do not need to install the Oculus Mobile SDK. However, advanced developers may find it useful to review our Mobile SDK Developer Guide for insight into the underlying logic. Developers interested in the Android lifecycle and rendering path of Oculus Android applications should review our documentation on VrApi. Mobile Best Practices and General Recommendations may also be of interest.

If you are interested in submitting an application to the Oculus Store, please see our Distribute Guide. We recommend doing so before beginning development in earnest so you have a realistic sense of our guidelines and requirements.