Documentation

Application Manifests for Release Builds

The application manifest of your Gear VR app must conform to our specifications if you want to upload it to the Oculus Store. The upload verifier in the Developer Dashboard rejects applications that do not conform to the specifications.

Unity Application Manifests

To create a Gear VR application in Unity that meets our manifest specification, you must create an AndroidManifest.xml file as specified below, and then copy the file to your Unity project's Assets/Plugins/Android/ folder. Unity will modify this file at build time to change the package name, version code, and other variables before packaging your application.

Application Manifest Specification

Your AndroidManifest.xml file must

  • Have the correct attributes and values in the <manifest> element:
    • Set a unique package name for the application in the package attribute.
      package="YOURNAME"
    • Set android:installLocation="internalOnly"
    • Set the versionName. It is shown in the store.
      android:versionName="1.0"
    • Set the versionCode. It is used to deliver updates to users. This value must be an integer greater than 0, and must increment with subsequent revisions.
      android:versionCode="1"
    • Set the SDK versions to 19.
      <uses-sdk android:minSdkVersion="19" android:targetSdkVersion="19" />
    • Set the OpenGL ES version accordingly.

      OpenGL ES 2

      <uses-feature android:glEsVersion="0x00020000" android:required="true" />

      OpenGL ES

      <uses-feature android:glEsVersion="0x00030000" android:required="true" />

      OpenGL ES 3.1:

      <uses-feature android:glEsVersion="0x00030001" android:required="true" />
  • Include the following metadata attribute in the <application> element:
    <meta-data
          android:name="com.samsung.android.vr.application.mode"
          android:value="vr_only"/>
  • Structure the <activity> element as shown:
    <activity
          android:name="YOUR ACTIVITY"
          android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen"
          android:label="@string/app_name"
          android:launchMode="singleTask"
          android:screenOrientation="landscape"
          android:configChanges="screenSize|orientation|keyboardHidden|keyboard"
          android:excludeFromRecents="true">
          <intent-filter>
           <action android:name="android.intent.action.MAIN" />
           <category android:name="android.intent.category.INFO" />
          </intent-filter>
         </activity>
         
  • Remove any unnecessary permissions from your AndroidManifest.xml file. Only include permissions that are absolutely necessary for your app to function.
Loading…