Gear VR apps have a stringent set of packaging requirements and any app you upload must be packaged accordingly. The upload validator rejects apps that do not meet these requirements.
Gear VR apps must be packaged as APK files and meet the following specifications:
You can supplement your APK file with an APK expansion file. If you are familiar with Google Play APK expansion files, be aware that Oculus APK expansion file sizes and naming patterns are different. Oculus APK expansion files must meet the following specifications:
The APK expansion file may be up to 4 GB in size.
There must be only one expansion file.
The filename of the APK expansion file should be main.versionCode.packageName.obb
Example:If you are uploading APK version 3 and your package name is com.oculus.example, your expansion file name should be main.3.com.oculus.example.obb
APK Expansion Files and APKs Must Be Updated Together
Expansion files must be updated together with an APK. This means that even if your update contains changes only to the APK or only to the .obb, you must increment the version code for each and upload new versions of them together.
The only exception is if you decide to stop using an expansion file and go back to distributing a single APK. In this particular scenario, you would upload a new APK but omit the --obb parameter.
You can upload builds through the Oculus Developer Dashboard web interface or using the Oculus Platform Command Line Utility. We recommend using the Oculus Platform Command Line Utility because it is faster. It uses delta-patching techniques to upload only the portions of your app that have changed.
If there are any packaging problems with your app, the upload validation routines inform you after uploading your build so that you can correct the issue and try again.
Some apps may not support all Gear VR devices, please see the Managing Supported Devices page for information about managing the devices your app supports. This can be configured anytime after you upload your app.
Before you can upload a Gear VR app, you must first create an app page for it in the Oculus Developer Dashboard. For more information, see App Submission and Store Review.
To upload your build through the web interface:
To upload your app through the command line interface:See our Oculus Platform Command Line Utility doc for information about using the utility.