The site has a new content architecture. We've added the ability to select your development device to show device-specific content. Please read our blog post Oculus Developer Center Update: Device-centric Documentation Architecture for more information.
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.
This guide describes how to install the Android Studio Development Bundle that you’ll use to build Oculus Android VR apps.
The Android Studio Development Bundle includes all the necessary tools you need to begin developing Android Applications:
If you’re planning to use a Mac for development, first install Xcode - https://developer.apple.com/xcode/download/. If you’re using another platform you can skip this installation.
Once Android Studio has been installed, you can then install the following packages:
These packages are installed through the Android SDK Manager. To access the manager, either navigate to Tools > SDK Manager or click the SDK Manager icon in the toolbar ( ). If you do not have a project loaded you may navigate to Configure > SDK Manager.
Verify that the correct packages and versions have been installed
In the Android SDK Manager, select the SDK Platforms tab. Verify the following Android platform is installed, as it is the minimum version required by the SDK:
Then select the SDK Tools tab. Verify that the NDK and LLDB components are installed, and that the Android SDK Build Tools 28.0.3 (or later) are installed.
Please refer to the following pages for information about Android NDK (https://developer.android.com/studio/projects/add-native-code.html#download-ndk) and OpenJDK (https://developer.android.com/studio/intro/studio-config.html#jdk).
Once you’ve finished installing the required packages, you can configure your development environment.
Android Studio Project Structure
To verify your settings in Android Studio, navigate to File > Project Structure > SDK Location. If you do not have a project loaded, navigate to Configure > Project Defaults > Project Structure > SDK Location.
Verify that Use embedded JDK is checked and that the following properties are set to appropriate values:
Make note of these locations, you’ll use them to set your environmental variables in the next section.
Environment Variables and Path
With the locations recorded in the previous step, set the following environment variables:
C:\Program Files\Android\Android Studio\jre.
C:\Program Files\Android\Android Studio\jre\bin.
You must set up your system to detect your Android device over USB in order to run, debug, and test your application on an Android device.
If you are developing on Windows, you may need to install a USB driver for ADB after installing the Android SDK. For an installation guide and links to OEM drivers, see the Android OEM USB Drivers document.
Windows may automatically detect the correct device and install the appropriate driver when you connect your device to a USB port on your computer.
Access the Device Manager through the Windows Control Panel. If the device was automatically detected, it will show up under Portable Devices in the Device Manager. Otherwise, look under Other Devices in the Device Manager and select the device to manually update the driver.
To see the list of detected attached devices, enter the following at a command prompt:
Note: You will need to successfully set up your Android development environment in order to use this command.
If the device does not show up, verify that the device is turned on with enough battery power and that the driver is installed properly.