Upload Apps to Oculus Store

The Oculus Integration package provides a mechanism to directly upload the app from Unity to Oculus Developer Dashboard. Using the tool, you can upload development builds to release channels as needed.

Understand App Components

An app contains build and metadata. Oculus supports two types of apps: Quest and Rift. A Quest build contains an APK file and optional OBB and asset files. A Rift build folder contains an executable file and optional asset files. Asset files, which are generic infrastructure, are used for adding content, DLC, extra content, and access to the optional asset files. Metadata includes information such as app name, screenshots, description, and content rating. Most changes to established metadata require Oculus review.

Upload Build

You can upload builds in several ways such as through the Oculus developer dashboard, command line interface, or directly from Unity using the OVR Platform tool. The following instructions describe the process of uploading the build from Unity:

  1. On the menu, go to File > Build Settings > Build to compile the build.
  2. After the build is compiled, on the menu, go to Oculus > Tools > Oculus Platform Tool.
  3. Depending on the target build you’ve set from the Build Settings window, the Target Oculus Platform automatically sets the target device to Quest or to Rift.
  4. In Oculus Application ID and Oculus App Token, enter the ID and token that are available on the Oculus Developer Dashboard. To retrieve the app ID and token, log in to the dashboard, find the app from the list of apps under your organization, go to the Getting Started API page, and copy the app ID and token. You must use an admin account to view the app secret. In case you’re not an admin, go to Settings and verify the admin accounts on the Members page.
  5. In Release Channel List, enter the release channel name. See Oculus Platform Command Line Utility for valid release channel names.
  6. In Release Note, enter the release notes for the version.
  7. In Build APK File Path, select the .APK file.
  8. In Debug Symbols Directory, select the debug symbol directory path to symbolicate the Android crash and analyze the crash logs on the Crash Analytics dashboard. The tool defaults to the directory path of the libil2cpp.sym.so file, which is the default symbol file for projects built using the IL2CPP scripting backend. If you’re using IL2CPP scripting backend to build your project, you don’t need to take any action unless you want to use a different symbol file or choose not to upload the file. For projects built using the Mono scripting backend, select the C:\Program Files\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Variations\mono\Release\Symbols\armeabi-v7\ directory path to upload the libunity.sym.so symbol file. Should you choose not to upload the symbol file, click the X icon to clear the file path.
  9. Expand Optional Commands > Expansion Files to add additional files such as OBB and asset files. Do the following:
    • Click Choose to select the OBB file. The OBB file plays a role of extending the overall size of your app. Oculus supports up to 4 GB OBB file.
    • Click Choose to locate the folder containing the asset files. Oculus supports up to 2 GB asset files that can be used as DLC.
  10. Click Upload.
  1. On the menu, go to File > Build Settings > Build to compile the build.
  2. After the build is compiled, on the menu, go to Oculus > Tools > Oculus Platform Tool.
  3. Depending on the target build you’ve set from the Build Settings window, the Target Oculus Platform automatically sets the target device to Quest or to Rift.
  4. In Oculus Application ID and Oculus App Token, enter the ID and token that are available on the Oculus Developer Dashboard. To retrieve the app ID and token, log in to the dashboard, find the app from the list of apps under your organization, go to the Getting Started API page, and copy the app ID and token. You must use an admin account to view the app secret. In case you’re not an admin, go to Settings and verify the admin accounts on the Members page.
  5. In Release Channel List, enter the release channel name. See Oculus Platform Command Line Utility for valid release channel names.
  6. In Release Note, enter the release notes for the version.
  7. In Rift Build Directory, select the directory containing the Rift build files.
  8. In Version Number, enter the build version number.
  9. In Launch File Path, select the .EXE file.
  10. Expand Optional Commands and do the following:
    • In Launch Parameters, enter any arguments passed to the launcher file.
    • Select Firewall Exception to enable Windows firewall exception.
    • In the Gamepad Emulation list, select the type of gamepad emulation used by the Oculus Touch controllers.
    • Under 2D, in 2D Launch File, select the .EXE file to launch the app in 2D mode, and in 2D Launch Parameters, enter any arguments passed to the launcher file.
    • Under Expansion Files, in Language Pack Directory, select the directory containing the language pack, and in Assets Directory, select the directory containing the DLCs.
  11. Click Upload.