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 introduces the Android Studio IDE and reviews some basic features, including how to build and run sample projects.
Before using this guide, follow all of the instructions in Device Setup - Oculus Quest and Oculus Go and Android Development Software Setup. The native samples referenced in this topic can be found at
\ovr_sdk_mobile\VrSamples in the Mobile SDK.
build.gradleproject file from the Mobile SDK VrSamples folders. For example,
Here are some possible solutions if Android Studio reports a Gradle sync or configuration error:
local.propertiesfile from your project folder up to the root of your Oculus Mobile SDK folder.
Android Studio displays project files in the Android view by default. We recommend changing it to the Project view, which provides a good overview of the entire directory structure and highlights imported project directories in bold.
Make sure you have followed the configuration steps in Device Setup - Oculus Android and Android Development Software Setup to ensure your device and development environment are configured appropriately.
Before building, select the target configuration you wish to build by selecting Edit Configurations in the project menu in the Android Studio toolbar.
To build and run your app:
Click Run in the toolbar.
Select a device listed under Connected Device instead.
Troubleshooting: If USB debugging does not seem to be working:
Troubleshooting: If stepping into certain functions results in an illegal instruction exception (SIGILL)/crash while debugging:
process handle --pass true --stop false --notify true SIGILL
If you edit a
*.gradle file or install an update to the Oculus Mobile SDK which includes updated Gradle projects, click Sync Project with Gradle Files to update your Android Studio project files.