Deploy Build on Headset

When developing apps for Oculus Quest, it becomes a norm to build and test your work-in-progress on the headset. It’s important that you always test your build on a real headset before you submit it to the Oculus store. Instead of using command line tools, ODH makes it very easy to deploy APK files to Oculus headset so that you can test your code with minimum iteration.

Before you can distribute your app, you need to create or join an organization on the Oculus dashboard. An organization represents the company or individual associated with your app. ODH lists all the organizations you’ve created or joined, and the app details such as release notes, rating, and channel information on the home page.

Deploy Build on Headset

To test your build on headset, you can drag and drop the APK file from your computer into ODH. ODH will then automatically deploy the build on the connected headset.

  1. Build your Unity project.
  2. Locate the APK file on the computer.
  3. On My Device, under Apps, drag and drop the APK file in the Add an APK section or click Upload to locate the APK on your computer.

    ODH APK Install

  4. Wear your Oculus headset, press the Oculus button on the controller to open the menu, click the Apps icon, and from the top-right list, select Unknown Sources.
  5. Open the app from the list.

Upload APK to Release Channel

Build deployment to release channels are essential to improving a Quest app in the iteration stage. When you’re ready to publish your app, you can use release channels such as Alpha, Beta, and Release Candidate to distribute the early version of the app for testing to closed audience. For more information about release channels, see the Release Channels guide.

  1. From the top-left list, select the organization for which you want to view the apps.
  2. On the App Distribution tab, click the app card to open the release channels list.
  3. Click Upload to open the Upload Build wizard and follow the instructions. As you navigate through the wizard, ODH lets you enter release notes and define build-specific settings such as provide expansion file, language packs, debug symbols, and asset files. It also prompts for any virtual reality check failures. For more information about learning build-specific settings, see the OVR Platform Tool guide for Unity and Unreal.

ODH App Details