In the Platform list, select Android, and then select Switch Platform. If the target platform is already set to Android, skip to the next step.
In the Run Device list, select the Meta headset. If you don’t see the Meta headset in the list, select Refresh.
Select Build And Run, specify a name and location for the .apk (Android executable) file to output, and select Save to build the app and run it on your headset.
If the app runs successfully on the headset, you have properly connected your device.
After verifying that your device is connected, set up the following tools to assist with connecting, testing, and debugging your device:
Android Debug Bridge (ADB) is a command-line tool included with the Android SDK that you installed with the Unity Editor. You can use ADB to install apps and issue other useful commands from the computer.
Link is a development tool that enables you to stream applications from your development machine to a Meta Quest headset. With Link, you can significantly decrease XR application development time by launching your app on your headset directly from the Scene view of the Unity Editor, without the need to build and deploy the app for an Android platform.
Note: Link is currently only supported on Windows. If you are developing on macOS, or developing without access to a headset, use Meta XR Simulator.
Enable Android Debug Bridge
Android Debug Bridge (ADB) is a command-line utility that enables you to perform a number of useful actions during XR development, including:
Installing apps to your headset
Debugging apps on your headset
Copying files to your headset
ADB is included with Unity’s Android SDK tools installation and located inside the /Android/SDK/platform-tools/ folder.
Windows: Download the OEM USB driver, extract the oculus-adb-driver-2.0 ZIP file, go to the /oculus-go-adb-driver-2.0/usb_driver/ folder, right-click the android_winusb.inf file, and select Install.
macOS: Skip to step 3, as you don’t need any additional USB drivers.
Add the installation directory to your system path.
Windows: If you are using the Android SDK installed with Unity, the installation path should look similar to the following:
Open the command line on your development machine and run the following command to check the connected device:
adb devices
You should see output similar to the following:
List of devices attached
1PASH9BB939351 device
For additional documentation on using ADB with Meta Quest devices, including manual app installation, additional commands, and troubleshooting, see Android Debug Bridge for Meta Quest.
For more detailed information about using ADB, see Android Debug Bridge in the official Android documentation.
Set up Link
Note: Link is currently only supported on Windows. If you are developing on macOS, or developing without access to a headset, use Meta XR Simulator.
Meta Quest Developer Hub (MQDH) is an application for Windows and MacOS that allows developers to manage their devices, debug their apps, and submit their apps to the Store.
Download and install the Meta Quest Developer Hub application for macOS or Windows.
Open the application and log in using your Meta Developer credentials.
In the left navigation pane, choose Device Manager. All the devices you have set up are displayed in the main pane. Each device is shown with its status, which includes the device ID and connection status. The active device shows a green Active designator.