Mar 27, 2017

Gear VR Uploads with CLI

Boone Calhoun Blog Hero Image

We’re happy to announce the addition of Gear VR uploads to the Oculus Platform Command Line Utility (CLI). The CLI allows for smaller, faster uploads and can be integrated directly into your build system.

When uploading an Android APK on the Oculus Developer Dashboard, the entire file must be uploaded every time. With the CLI, only the bytes that differ from your previous APK will be uploaded. This can greatly reduce the amount of data that must be uploaded, leading to faster uploads.

CLI uploads for Rift have been available for several months, and developers have been making great use of them. Several developers have integrated the utility into their continuous integration pipelines, so they never have to upload a build by hand. The median upload size for the CLI is just 10% of the full build size, and the median upload time is just 33 seconds.

Here's how you upload an APK using the CLI:

Download the CLI from the Tools page⁠

Grab the App ID and App Secret from the API tab⁠ in the Dashboard

Run the upload-gear-build command to upload an APK to your Alpha release channel:


ovr-platform-util.exe upload-gear-build --app_id [ID] --app_secret [SECRET] 
  --apk C:\BestAppEver.apk --channel alpha --notes "Just testing out the CLI"

You can learn more about the command line utility by visiting the Tools page⁠.

We'd love to hear your feedback on how we can make this tool even better. Send us a note by submitting a feature request in the Dashboard⁠ by using the “Give Feedback” button⁠.

Rift

Did you find this page helpful?

Explore more

Mar 19, 2024Everything (and we mean everything!) We Covered at GDC’s Developer Summit

Hear about everything we covered at our first ever Developer Summit at GDC.

Design, GDC, Games, OpenXR, Presence platform, Quest, Rift, Unity, Unreal

Read article

Feb 28, 2024Overcoming Graphics and Design Challenges in Across the Valley

We are FusionPlay, a small Indie studio, based in Germany, that has been developing VR games since 2016. We released our first title, “Konrad the Kitten”, for Oculus Rift in 2018, followed closely by the “Konrad’s Kittens” update in 2019. Lately, we’ve been working on our newest title for Meta Quest, “Across the Valley.”

Design, Locomotion, Quest, Rift

Read article

Nov 21, 2023How Developer Teams Are Using App Lab to Meet Their Goals

Learn how you can use App Lab to build a sustainable developer business with Meta Quest, and get inspired with real examples of apps and developers who have used App Lab to meet their goals and grow an audience.

Apps, Games, Oculus Start, Quest, Rift

Read article