Deploy Unreal Engine builds to Quest

This tutorial shows you how to build and deploy a sample WVS project to your Meta Quest developer account all from the WVS Web Client. Once you complete this tutorial, you can see your deployed app on your Quest headset. The objectives of this tutorial are as follows:

flowchart LR; id1[Create a Quest app] --> id2[Fork a sample project on WVS]; id2 --> id3[Point your WVS project to your Quest app]; id3 --> id4[Build and deploy your project to your Quest app]; id4 --> id5[See your app on your Quest headset];

Prerequisites

You must have an Meta Quest developer account.

Create a Quest app

You can deploy your WVS project builds directly to your Quest apps. Each Quest app has a unique App ID and an App secret, which is a token that’s used by applications to make Quest API requests. You must configure your WVS project with the App ID and App secret of your Quest app to automate the deployment of builds to your Quest app.

Additionally, your build for this tutorial deploys to Quest as a pre-release Alpha. Only invited users can find pre-release versions of Quest apps, so you must invite any users, including yourself, that you want to use your app in order for them to see it on their Quest headsets.

Create a new app

  1. Sign in to Meta Quest Developer Center and click My apps.
  2. Click Create new app.
  3. In the popup window, enter a name for your app and select Quest (app lab).

  4. Click Create.

    Once your app is created, you are taken to the Overview page of your new app in the App manager.

Get your app’s App ID and App secret

  1. In the App manager navigation page, select API.
  2. Copy and save the App ID and App secret. We use these values in later steps to point your WVS project to your Quest app.

Invite users to use your app

  1. In the App manager navigation panel, select Distribution > Release channels.
  2. Click Alpha and select the Users tab.
  3. Click Add users and enter the Quest account emails of the users that you want to invite to use your app, including yourself.

Fork a sample project on WVS

For this tutorial, we fork the sample project Ue5VrStarterQuest, which you can build and deploy to your Quest app.

  1. Go to the Ue5VRStartQuest project home page.

  2. Click Fork and configure your project as follows:
    • Project name: Enter a name for your project or keep the original name.
    • Project URL: Select the namespace for your project. It could be your personal namespace or the namespace of any groups that you own. For the purposes of this tutorial, we recommend selecting your personal namespace.
    • Project slug: Enter a URL-friendly name for your project.
    • Visibility level: For the purposes of this tutorial, we recommend using private visibility.
  3. Click Fork project.

Now you have your own copy of the Ue5VrStarterQuest sample project.

Using your own Unreal Engine Project?

If you are using your own project instead of our sample, you will need to setup your project to prepare to deploy to any marketplace. Follow our Android Keystore for Unreal Engine documentation to learn more.

Point your WVS project to your Quest app

To enable your forked project to deploy builds to your Quest app, your project must have the App ID of your app and the credentials for making Quest API calls.

  1. In the WVS Web Client, open your forked copy of Ue5VrStarterQuest.

  2. In the navigation panel, select Project settings > CI/CD.

    Note: If you don’t see CI/CD, you need to select Show advanced developer tooling in your WVS profile preferences page.

  3. Expand the Variables section.
  4. Click Add variable and configure your Quest app’s App ID:
    • Key: WVSUSR_QUEST_APPID.
    • Value: Enter the App ID of your Quest app.
    • Type: Variable.
    • Environment Scope: All (default).
    • Protected variable: Unselect.
    • Masked variable: Select.
  5. Click Add variable.
  6. Click Add variable again and configure your Quest app’s App secret:
    • Key: WVSUSR_QUEST_APPSECRET.
    • Value: Enter the App secret of your Quest app.
    • Type: Variable.
    • Environment Scope: All (default).
    • Protected variable: Unselect.
    • Masked variable: Select.
  7. Click Add variable.

Builds Flows

Our example projects include flows to deploy your project to your Oculus, you don’t have to add anything. But if you’re setting up your own, flow our section on how to Add Flows to your project.

Learn more about WVS Build Flows.

Build and deploy your project to your Quest app

This project takes around 30 minutes to build.

  1. In the WVS Web Client, open your forked copy of Ue5VrStarterQuest.
  2. In the navigation panel, select Version control > Files.
  3. Click the Readme.md file and click Edit.
  4. Make any change to the file and click Commit changes.

  5. In the navigation panel, select Flows > Pipelines.

    You are taken to the pipeline details page where you can see the progress of each job.

Once all jobs successfully complete, you are ready to see your Quest app on your Quest headset.

Tip: You can see your builds in Output > Builds.

Add Flows to your project

If you’re setting up your own project, you will need to add the correct flows to get the project to build properly. If you’re using an example project, you can skip this step since flows are already included in the project.

We will use the WVS Command-Line tool to set this up. Keep in mind, while running any of these commands, if you would like additional information on any command, you can always append ` –help` at the end.

Learn more about the CLI tool in the Documentation for the CLI.

  1. Open up your command-prompt and navigate to your project directory. 

      cd c:\wvsProjects\my-cool-test-project

  2. Run the following to begin a changelist. You can add any name to your changelist in place of the example. 

      wvs changelist begin --name "Adding a flow"

  3. To see a list of available flows, run the following in your command prompt: 

      wvs flow registry

  4. The flows we will want to add are the following:

    Flow Name Description
    build_ue_game_quest Basic Game Build for Unreal Engine projects targeting the Oculus Quest.
    deploy_oculus Deploy a build to a channel in your Oculus developer account.

    Both flows are required to be able to successfully deploy. The first flow (build_ue_game_quest) builds an .apk which is the
    required build format that will work on an Oculus. The second flow (deploy_oculus) will take the .apk and help you deploy to your Oculus account.

  5. To add, run the following two commands (separately) in your command prompt: 

      wvs flow add build_ue_game_quest

    Hit Enter, an OK should be returned. 

      wvs flow add deploy_oculus

    Hit Enter - An OK should be returned.

  6. To check if they were added correctly, run: 

      wvs flow status

  7. Your output should display the following:

    Instance Name Registry Name Catgry Enabled
    build_ue_game_quest_1 build_ue_game_quest build true
    deploy_oculus_1 deploy_oculus deploy true

    The name of your flow is the Instance Name. If you need to make changes in the future, you would use the Instance Name of your flow.

  8. Now we have an Android build but we need this to send the information to your Oculus account. In order for the flows to communicate with each other, we will need to connect the two by running the following command. Here, you can see, we use the Instance Name to connect. 

      wvs flow connect build_ue_game_quest_1 to deploy_oculus_1

  9. To check that everything is valid, let’s run a check. 

      wvs flow validate

    An OK means, everything is working fine. If it was not setup correctly, you will get a message on what changes need to be made.

  10. Now we will submit our changelist. 

     wvs changelist finish

    Now you can return to your project on the WVS web app. From the left-hand side, locate Outputs > Builds to view your build progress.

See your app on your Quest headset

You can find your app in your app library with the App lab label. If you don’t see your app in your app library, try searching for it in the Store. Once you’ve located your app, you can install it and use it.

You can also make edits in your WVS project and build and deploy it again to Quest. In this case, the next time you open your app, you are prompted that a new version of the app is available and you can update to the newer version.

Troubleshooting

For additional support, please reach out to us on our Discord.

Was this helpful?

We would love to hear your feedback, Submit a ticket in our Issue Tracker.


Report a problem with this page.