Oculus Go Development

On 6/23/20 Oculus announced plans to sunset Oculus Go. Information about dates and alternatives can be found in the Oculus Go introduction.

Oculus Quest Development

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.

Upload Oculus Rift Apps to the Oculus Store

You can upload Rift apps using the developer dashboard, with the command-line tool, or with an integration of the command line tool in Unreal or Unity.

Prerequisites

Before you can upload your Rift app, you must:

  • Have an account with Oculus and set up a development organization. For more information, see Manage Your Organization and Users
  • Create a page for your app in the developer dashboard. For more information, see App Submission and Store Review.
  • Have your app packaged correctly.
    • For the web interface: All necessary files and folders must be packaged in a .zip file. Note that the launch executable file does not need to be at the root of the file structure. You will specify it’s location in the upload process. Note that the maximum size for apps uploaded via the web interface is about 200 MB. If your app is larger, use the command line tool.
    • For the command-line tool: All necessary files and subdirectories must be inside a single directory that you can specify to the command line tool. Your app package should not be larger than 1 GB.
    • For the Oculus Platform tool in the Unity or Unreal integration:: Your App ID, App Token, and optional asset and language pack directories. Since this tool is a wrapper on the command line tool, your app packages can be up to 1 GB in size.

Upload Your App with the Web Interface

  1. Log on to the Oculus Developer Dashboard at https://dashboard.oculus.com.
  2. Hover over your Rift app and then click Manage Build or if this is the first upload for this app, click the Upload Build at the bottom of the page. The following image shows an example of a first upload.

  3. Choose a release channel (typically ALPHA or BETA for the first upload) and click (...). For more information about channels, see Release Channels Select Upload New Binary to [Channel Name]. The following image shows an example:

  4. Scroll up the page, and under the Upload a new binary to the [Channel Name] channel section, click Choose file. Navigate to and and select the .zip file that contains the binary and other resources.
  5. A Build Dashboard appears. In this screen, you specify the options appropriate for your app such as the Launch File, Launch Parameters and the Redistributables required by your app. Note the following: * Any paths that you specify, such as the executable and parameter paths, should be relative to the root directory of your .zip file * If your app has separate 2D and 3D modes of operation, see additional instructions in the Rift Apps with Non-VR Desktop Modes topic.

The following image shows an example of the build dashboard.

  1. Click Upload.

Upload your app through the command line interface

You can also upload your app with the Oculus Platform Command Line Utility. The command line utility is a better choice if your app package is bigger than 200 MB, but less than 1 GB, or you have required assets or language packs associated with your app.

Upload your app from the Unity or Unreal editors

If you are using Unity with the Oculus Asset imported, or Unreal engine, you can access the Oculus Platform tool through UI in the editor. These tools accept app packages up to 1 GB in size and you can upload assets associated with the app as well.

Change to a Previous Build

If users experience a problem with a build, or you need to roll back a build for some reason, you can change the build associated with a release channel for Rift apps. Note that this functionality does not work with SOculus Quest or Go) apps.

  1. Log on to the Oculus Developer Dashboard at https://dashboard.oculus.com.
  2. Hover over your Rift app and then click Manage Build.
  3. On the Build Dashboard page, find the release channel for the build you want to modify, hover over the ellipses, and choose Select Build.
  4. Select the desired build in the drop-down and Submit to confirm the change.

Additional Info

If there are any packaging problems with your build, the upload validator lets you know what they are so that you can correct the issue and try again.

Also see Rift Apps with Non-VR Desktop Modes for details on how to support apps that can be launched in a non-VR desktop modes.