Edit

Quickstart: Deploy Unity sample to Quest 2 or Quest Pro

  • Article

This quickstart covers how to deploy and run the quickstart sample app for Unity to a Meta Quest 2 or Quest Pro device.

Important

Support for Quest 2 and Quest Pro is currently in Public Preview.

This functionality is provided without a service level agreement, and is not recommended for production workloads. Certain features might not be supported or might have limited capabilities.

For more information, see Supplemental Terms of Use for Microsoft Azure Previews.

In this quickstart, you learn how to:

  • Build the quickstart sample app for Android
  • Deploy the sample to the device
  • Run the sample on the device

Prerequisites

In this quickstart, we deploy the sample project from Quickstart: Render a model with Unity. Make sure your credentials are saved properly with the scene and you can connect to a session from within the Unity editor.

In Unity, you need to have Android Build Support installed.

Your Quest 2 / Quest Pro device must be set up for Developer Mode.

You need to have the Android SDK installed, so that tools like the Android Debug Bridge (ADB) are available. You should also make sure the path to these binaries are in your PATH environment variable.

Make sure your Quest device is connected to the PC and side-loading Android Packages (APKs) via adb works.

Build the sample project

  1. Open File > Build Settings.
  2. Change Platform to Android.
  3. If you want to be able to debug the APK, enable Development Build.
  4. Select Switch Platform. A screenshot showing the Build Menu with the settings set for an Android build.
  5. When pressing Build (or 'Build And Run'), you're asked to select a folder where the APK should be stored.
  6. Once the APK file is finished, it needs to be deployed to your device using adb.
  7. Open a command prompt, navigate to the APK file, and run adb install <YourFileName.apk>.

Launch the sample project

Once your APK is installed on the device, you should be able to find and launch it from the Quest's app menu. To find side-loaded apps quickly, set the menu's filter to Unknown Sources.

Next steps

In the next quickstart, we'll take a look at converting a custom model.

Quickstart: Convert a model for rendering