Meta Developers

Development machine running Windows 10+ (64-bit) or macOS Sierra 10.10+ (x86)
Unity ID
Unity Editor 2022.3.15f1 or higher (Unity 6+ is recommended) with the following modules installed:
- Android Build Support
- OpenJDK
- Android SDK & NDK Tools

Create a new Unity Project

Unity configuration settings are project-specific. To configure a project, you must first open the project in Unity.

If you have not yet created a Unity project, follow the steps below:

Open Unity Hub.
On the Projects tab, select New Project.
Select the Unity version you want to use to create the project.
Choose the Universal 3D template, a blank Unity project template built on the Universal Render Pipeline.
Enter your project name, a save location, and a Unity organization (you can use the default organization that Unity creates for you).
If applicable, select Connect to Unity Cloud and Use Unity Version Control.
Select Create Project.

Set the build platform

The target platform for Meta Quest headsets is Android, and the final build output is an .apk file (Android executable).

To set the Unity build platform for your project to Android:

Open the Build Profiles window in the Unity Editor, by navigating to File > Build Profiles (before Unity 6 known as Build Settings).
Under Platform, select Android, and then select Switch Platform.

For more information about Unity build settings, see Build Settings Overview.

Install an XR provider plugin

XR provider plugins provide the base functionality for running XR applications on headsets.

The following provider plugins support Meta Quest devices:

Unity OpenXR Plugin (Unity 6+, SDKs v74+)
- Recommended Version: 1.14.2
Oculus XR Plugin (Unity 2022-2023, SDKs < v74)
- Recommended Version: 4.5.1

For more information about XR vendor plugins, see XR Plugin Management for Meta Quest.

Install the Unity OpenXR Plugin

For projects built on Unity 6+ that use Meta XR SDKs v74+, install the Unity OpenXR Plugin.

To install the OpenXR provider plugin:

Open any 3D project in the Unity Editor (2022.3.15f1 or higher; Unity 6+ is recommended).
From the top menu of the Unity Editor, navigate to Edit > Project Settings to open the Project Settings window.
Select XR Plug-in Management in the Project Settings window.
If XR Plugin Management is not installed, select Install XR Plugin Management.
In the Windows, Mac, Linux settings tab, select OpenXR.
In the Android settings tab, select OpenXR.
Close the Project Settings window.
From the top menu of the Unity Editor, navigate to Windows > Package Manager to open the Unity Package Manager window.
At the top left of the window, select Packages: and change the selection to Packages: In Project.
In the list of packages in the left menu, verify that there is a check mark beside the Unity OpenXR Plugin, indicating that the package is installed.

Note: Installing an XR plugin does not download and import the Meta XR SDKs in to your project. Make sure you download the Meta XR SDKs you need from the Unity Asset Store.

Install the Oculus XR Plugin

Note: New platform features will not be added to the Oculus XR Plugin, and features released in Meta XR SDK versions v74+ might not be compatible with the Oculus XR Plugin. The Unity OpenXR Plugin is the recommended provider plugin going forward. If you are developing with SDKs on v74+, use Unity 6+ with the Unity OpenXR Plugin instead.

For projects built on Unity versions < 6 that use Meta XR SDKs < v74, install the Oculus XR Plugin.

To install the Oculus XR provider plugin:

Open any 3D project in the Unity Editor (2022.3.15f1 or higher; Unity 6+ is recommended).
From the top menu of the Unity Editor, navigate to Edit > Project Settings to open the Project Settings window.
Select XR Plug-in Management in the Project Settings window.
If XR Plugin Management is not installed, select Install XR Plugin Management.
In the Windows, Mac, Linux settings tab, select Oculus.
In the Android settings tab, select Oculus.
Close the Project Settings window.
From the top menu of the Unity Editor, navigate to Windows > Package Manager to open the Unity Package Manager window.
At the top left of the window, select Packages: and change the selection to Packages: In Project.
In the list of packages in the left menu, verify that there is a check mark beside the Oculus plugin, indicating that the package is installed.

Note: Installing an XR plugin does not download and import the Meta XR SDKs in to your project. Make sure you download the Meta XR SDKs you need from the Unity Asset Store.

Import the Meta XR Core SDK

Meta develops and maintains a number of Unity SDKs for extended reality (XR) application development. If you are just getting started developing for Horizon OS, download the Meta XR Core SDK. This SDK includes the most essential components and assets for developing Horizon OS apps in Unity.

To download and import the Meta XR Core SDK:

Go to the Unity Asset Store, and sign in using your Unity credentials.
Navigate to the Meta XR Core SDK page.
Select Add to My Assets to add the package to your Unity account’s assets.
Select Open in Unity to open the Package Manager window in the Unity Editor.
Enter Unity credentials if prompted.
In the Package Manager window, in the upper-right side of the window, select Install to install the Core SDK.

For more details about Meta XR packages, see Meta XR Packages reference page.

Configure your project with the Project Setup Tool

The Project Setup Tool is a Unity Editor extension that is designed to quickly configure Unity projects for Meta XR development.

Use the Project Setup Tool to configure your project for Android:

Open the Project Setup Tool in the Unity Editor, by navigating to Meta > Tools > Project Setup Tool.
Note: You can also open the Project Setup Tool by clicking on the Meta icon in the bottom right corner of the Unity Editor, and then selecting Project Setup Tool from the pop-up menu.
To resolve all outstanding issues for the Android platform, select Fix All.
To apply all recommended settings for the Android platform, select Apply All.

For more details about the Project Setup Tool, see the Project Setup Tool reference page.

For more information about configuring Unity projects manually, see Project Configuration Overview.

Learn more

To learn more about project setup, see the following resources: