One of the core time sinks of iteration speed is the time it takes to build and deploy changes to the Meta Quest headset for testing. To reduce the time spent doing this, we have highlighted some best practices. Some of these practices might require some modifications to your project.

Link is a useful and fast way to iterate on a project. With a headset connected to your computer, you can play in Unreal Editor and get the results directly in the headset as well as take in the inputs from the device. This is useful in cases where the changes are device-independent, such as logical code changes, asset positioning, and asset updates. The situations where it might not be beneficial are when iterating on elements that are device dependent, like shaders and rendering, or logic that is specific to the device.

For more information, see Set up Link.

The Meta XR Simulator simulates the Meta Quest headset and features directly on your development computer. It lets you iterate quickly on your project without the need to put on a headset. For mixed reality, it provides synthetic environments that make it very easy to test different sizes and layouts of rooms. This enables you to test changes that are device agnostic, as well as verify app logic, repetitive movement/functionality, and mixed reality rooms.

For more information, see Meta XR Simulator.

Sometimes, it is necessary to deploy and test the project on the device. For example, platform-specific features, game performance, and graphics all benefit from on-device testing.

Unreal Engine provides multiple entry points to launch the project on device, such as Package APK, Quick Launch, Project Launcher, and Unreal Automation Tool. For more information, see “Build Operations” in the Unreal Engine documentation.

There are several options that can improve the iteration speed for deploying to the device.

When iterating on code, we can speed up the deploy time by skipping the Gradle packaging step, reuse the previously made APK, and push the compiled libUnreal.so directly to the device (Read more here).

This option can drastically reduce the deploy time to seconds.

To enable it, do any of the below:

When iterating on assets, choose only to deploy the files/packages that have been modified.

This option can drastically reduce the deploy time to seconds.

To enable, do any of the following:

Note: In the UE 5.3.2 Oculus-VR fork release, the ability to incorporate iterative deploy with Cook-on-the-Fly (CotF) was enabled. This reduces iterative cook time with CotF by up to ~70% in our tests (See the “Benchmarking” section below).

When cooking the assets, only cook the modified ones. This means that the on-device cooked assets are reused, removing unnecessary work from the cooker and device deploy.

To enable, do any of the following:

Unreal Engine provides two cooking methods:

There are pros and cons, as well as different situations for both methods. In general:

For more information, see “Build Operations” in the Unreal Engine documentation.

We tested the above options on:

Observations:

Additionally, when performing clean builds, Cook-on-the-Fly shortens the project launch time significantly, as it defers cooking to run time.

Here are some other promising features potentially worth trying: