Develop

Android Studio plugin for Meta Quest

Updated: Aug 31, 2026

The Meta Horizon Android Studio Plugin is the primary IDE entrypoint for Android development on Meta Quest. It adds Horizon OS and Spatial SDK project templates, product-flavor generation, and Meta Spatial Simulator. It also detects libraries and permissions that are not compatible with Meta Quest. For Spatial SDK apps, it provides a Data Model Inspector and component and system file templates.

Meta VR CLI comes bundled with the Meta Horizon Android Studio Plugin . Use it from Android Studio, or install Meta VR CLI independently for use in terminals, continuous integration, and AI coding tools.

The plugin runs in Android Studio⁠, Google’s free IDE for Android development. While the plugin is distributed via JetBrains, you don’t need to sign up for IntelliJ or use any of their paid products.

Supported Android Studio versions

The plugin supports recent stable releases of Android Studio. When you open the plugin’s JetBrains Marketplace page⁠ with Android Studio installed, the page detects your Android Studio version and offers a compatible plugin build. If no compatible build is offered, your Android Studio version isn’t supported yet—update to a recent stable release (or install a supported version from the Android Studio archive⁠) and try again.

Install the Android Studio plugin

The Meta Horizon Android Studio Plugin is available from the JetBrains Marketplace and through Android Studio.

Install from the JetBrains Marketplace

To install from the JetBrains Marketplace, follow these steps:

Open Android Studio.
Go to the plugin’s JetBrains Marketplace page⁠.
With Android Studio open, the Marketplace page detects your version and provides a quick install button.
Select the Install to Android Studio YOUR_VERSION button.
Go to Android Studio and click OK on the plugin installation prompt.
If prompted, restart Android Studio.

Install through Android Studio

To install through Android Studio, follow these steps:

Open Android Studio settings and go to Plugins.
On Windows and Linux, go to File > Settings > Plugins. On macOS, go to Android Studio > Settings > Plugins.
In the Plugins window, click Marketplace.
In the search bar, type Meta and select the Meta Horizon Android Studio Plugin .
If prompted, restart Android Studio.

The Android Studio plugin page in the JetBrains Marketplace.

Confirm installation

After restarting Android Studio, you’ll see a welcome dialog.

The Android Studio plugin welcome dialog.

You will also notice a new tool window for Meta Horizon on the right-hand side.

The Android Studio tool window for Meta Horizon development.

Enabling and disabling the plugin

After you’ve installed Android Studio, you can disable or enable it in the Plugins menu where you installed the plugin.

Android Studio's Installed plugins tab showing the plugin's Disable button.

Enable source code inspection

The Android Studio plugin tries to limit source code inspection to modules that Quest uses. Add com.oculus.supportedDevices to each applicable AndroidManifest.xml file so the plugin can detect libraries and permissions that Quest doesn’t support.

The canonical com.oculus.supportedDevices identifiers are:

Meta Quest device	`supportedDevices` identifier
Meta Quest 2	`quest2`
Meta Quest Pro	`questpro`
Meta Quest 3	`quest3`
Meta Quest 3S	`quest3s`

Separate multiple identifiers with a pipe (|).

To declare support for all current Meta Quest devices, add this element to the application node in AndroidManifest.xml:

<meta-data
    android:name="com.oculus.supportedDevices"
    android:value="quest2|questpro|quest3|quest3s" />

The plugin looks for the manifest file closest to a given source file. If your project has multiple AndroidManifest.xml files, you may need to add the element to all of them.

Detect unsupported libraries

The plugin checks your code for Google Mobile Services (GMS) and other libraries that Quest doesn’t support. Warnings appear inline in the import list and in the Problems window. When guidance is available, point to the problem and click Learn More for details.

A screenshot of a list of imports in a Kotlin file. The imports not supported on Quest are marked with a yellow squiggly underline.

A screenshot of Android Studio's Problems tab showing a list of unsupported dependencies.

Detect unsupported permissions

The plugin marks unsupported permissions within the project’s AndroidManifest.xml files.

A screenshot of an Android manifest XML file. Permissions not supported by Quest have a squiggly yellow underline. One of the permissions has a tooltip under it saying "This permission is not supported by Meta Horizon OS", and an action saying "Learn More".

A screenshot of Android Studio's problems window with a list of unsupported permissions.

Spatial SDK features

Project templates

Using project templates, you can create a new Spatial SDK project. To use project templates in Android Studio, follow these steps.

In Android Studio, click File > New > New Spatial SDK Project.
The New Project window appears.
Fill out the fields, and then click Create.
Your new Spatial SDK project opens. It may take a few minutes to sync Gradle.

Data Model Inspector (DMI)

Debug your scene with the Data Model Inspector. This tool allows you to inspect and modify component data in real-time while your application is running, making it easier to understand scene hierarchy and troubleshoot issues.

Component and system file templates

Component and system file templates help you create new components and systems. To use the file templates in Android Studio, see Write a new component or Write a new system.

Open scenes in Meta Spatial Editor

For Spatial SDK projects, the plugin can open your scene files directly in Meta Spatial Editor. There are three ways to open a scene:

Meta Horizon tool window — In the Meta Horizon tool window, click Open Scene in Meta Spatial Editor. The plugin automatically finds the .metaspatial scene file and launches Meta Spatial Editor. This button is only visible for Spatial SDK projects (those with an app/scenes/ directory).
Context menu — Right-click on the scenes folder and select Open Scene in Meta Spatial Editor.
Tools menu — Go to Tools > Meta Horizon > Open Scene in Meta Spatial Editor.

Note: Meta Spatial Editor must be installed on your machine. If it is not installed, the plugin shows a notification with a download link. This feature is supported on macOS and Windows only.