Device Setup
Updated: Jul 30, 2024
This topic shows how to set up a Meta Android device for running, debugging, and testing applications. The currently supported Meta devices that run Android are Meta Quest, Meta Quest 2, Meta Quest Pro, and Meta Quest 3.
Note: To set up an Oculus Rift for development, see the
Rift Native SDK documentation.
To begin development locally, you must enable developer mode for the Meta device in the companion app on your mobile phone. Before you can put your device in developer mode, you must belong to (or have created) a developer organization on the
Meta Quest Developer Dashboard. If developing on Windows, you will also need to install drivers to use Android Device Bridge (ADB).
Joining or Creating an Organization
To join an existing organization, follow these steps:
- You’ll need to request access to the existing organization from the admin.
- You’ll receive an email invite. Once accepted, you’ll be a member of the organization.
To create a new organization, follow these steps:
- Go to the Create New Organization page of the Meta Quest Developer Dashboard.
- Fill in the appropriate information.
- Go to the verification tab of the Meta Quest Developer Dashboard.
- If prompted, login with your Meta Developer account.
- Verify your account with one of the two following options:
- Confirm your mobile number to set up SMS two-factor verification, please visit FB Help Center to ensure that your country and phone carrier are supported for SMS.
- Add a payment method to your account (Paypal excluded).
Once you belong to a developer organization, follow these steps to put your device in developer mode:
- Open the Meta Horizon mobile app.
- Navigate to Menu > Devices and then select your device.
- Go to Headset Settings > Developer Mode and then enable Developer Mode.
- Use a USB-C cable to connect the headset to your computer, and then put on the headset.
- Go to Settings > Advanced > Developer, and then enable Enable custom settings and MTP Notification.
When asked to allow USB debugging, select Always allow from this computer.
Important
Developer Mode is intended for development tasks such as running, debugging and testing applications. Engaging in other activities may result account limitations, suspension, or termination. For more information, see Content Guidelines.Install the Oculus ADB Drivers (Windows only)
If you are going to be pushing builds from a Windows machine, you’ll need the Oculus ADB Drivers.
- Download the zip file containing the driver.
- Unzip the file.
- Right-click on the
.inf
file and select Install.
Once complete, you’ll be able to use Android Debug Bridge (
ADB) to push builds to your device.