Uploading Rift App Packages

You can upload Rift apps using the developer dashboard or with the command-line tool.

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.
    • 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
Important: App binaries packaged as zip files are referred to as builds in the web interface.


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 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.

  6. Click Upload.

Upload Your App with the Command Line Tool


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.