Build and Upload Android Applications
在此專頁上
Important
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.
We're no longer accepting submission of 32-bit Oculus Quest apps. Any new or updated Oculus Quest application needs to be 64-bit. Please contact Oculus if you are unable to comply with this policy. Oculus Go and Gear VR apps will not be affected by this change.
This section describes the steps necessary for building Unity applications for developed on the Android platform.
Android Manifest
During the build process, Unity projects with VR support enabled are packaged with an automatically-generated manifest which is configured to meet our requirements (landscape orientation, vr_only, et cetera). All other values, such as Entitlement Check settings, are not modified. Do not add the noHistory attribute to your manifest.
To build an application for submission to the Oculus Store, you must build a custom manifest using the Oculus Integration.
Build Settings
From the File menu, select Build Settings…. Select Android as the platform. Set Texture Compression to ASTC.
We recommend unchecking Development Build for your final build, as it may impact performance.
Player Settings
- Click the Player Settings… button and select the Android tab.
- Set a Bundle Identifier under Identification in Other Settings.
- Select Virtual Reality Supported under Rendering in Other Settings.
All required settings are enforced automatically, but you may wish to make additional settings as appropriate. For example, it is recommended to select “Single Pass” for the Stereo Rendering Method which significantly reduces the number of draw calls required to draw a stereoscopic image.
Quality Settings
Navigate to Edit > Project Settings > Quality. We recommend the following settings:
| Value | Setting |
|---|---|
| Pixel Light Count | 1 |
| Texture Quality | Full Res |
| Anisotropic Textures | Per Texture |
| Anti Aliasing | 2x or 4x Multi Sampling |
| Soft Particles | Deselect |
| Realtime Reflections Probes | Select |
| Billboards Face Camera | Select |
The Anti-aliasing setting is particularly important. It must be increased to compensate for stereo rendering, which reduces the effective horizontal resolution by 50%. An anti-aliasing value of 2X is ideal, 4x may be used if you have performance to spare. We do not recommend 8x.
For more information on our recommended settings, see Best Practices.
Sideloading Unity Applications
You may build an APK locally and sideload it to your phone. For information on getting development builds on your device, please review the Device Setup - Oculus Quest page in the Mobile SDK guide.
Upload your Android Application
The Oculus Unity Integration provides the OVRPlatform Tool that you can use to upload your app to Oculus. You can upload development builds to a pre-production release channel, or your final build for Store Review. The OVRPlatform Tool uses the Oculus Platform Command Line Utility.
For information about uploading your apps to a Release Channel or Store using the Oculus Dashboard, please see the Uploading Gear VR and Go Apps page.
To use the OVRPlatform Tool, open the diaglog by selecting Oculus / Tools / Oculus Platform Tool.
Review Oculus Platform Command Line Utility for information about the parameters in the OVRPlatform Tool dialog.