Develop
Develop
Select your platform

Meta Horizon Android Studio Plugin

Updated: Sep 15, 2025
The Meta Horizon Android Studio Plugin supports the development of Android apps for Quest devices by integrating Meta Horizon OS-specific functionality into the Android Studio IDE. For any Android app, it detects unsupported libraries and permissions. For Spatial SDK apps specifically, it also provides project templates, a Data Model Inspector, and component/system file templates.

Install the Meta Horizon Android Studio Plugin

You can install Meta Horizon Android Studio Plugin from the Jetbrains Marketplace, or through Android Studio directly. The plugin appears as the Meta logo on the right toolbar of Android Studio.

Install from the Jetbrains Marketplace

To install from the Jetbrains Marketplace, follow these steps:
  1. Open Android Studio.
    With Android Studio open, the Jetbrains Marketplace page will detect your version and provide a quick install button.
  2. Go to the plugin’s Jetbrains Marketplace page.
  3. Select the Install to Android Studio YOUR_VERSION button.
  4. Go to Android Studio and click OK on the plugin installation prompt.
  5. If prompted, restart Android Studio.

Install through Android Studio

To install through Android Studio, follow these steps:
  1. In Android Studio, click File > Settings > Plugins.
  2. In the Plugins window, click Marketplace.
  3. In the search bar, type Meta Horizon and select the Meta Horizon plugin.
  4. If prompted, restart Android Studio.
A screenshot of the Android Studio's plugins screen, showing the Meta Horizon Android Studio plugin store page.

Confirm installation

After restarting Android Studio, you’ll see a welcome dialog.
A screenshot of the welcome dialog for the Meta Horizon Android studio plugin.
You will also notice a new tool window for Meta Horizon on the right-hand side.
Showing the Meta Horizon Android Studio tool window

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.
A screenshot of Android Studio's plugins menu, in the Installed tab. The Meta Horizon Android Studio plugin is in the Downloaded tab and has a Disable button.

Enable source code inspection

The Android Studio plugin tries to limit source code inspection to modules that Quest uses. Include the following tag in your AndroidManifest.xml to have the plugin detect libraries and permissions that Quest doesn’t support.
<meta-data android:name="com.oculus.supportedDevices" android:value="quest2|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 tag 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 for each unsupported library appear inline in import list or in the Problems window. You can mouse over the problem and click “Learn More” to see how to replace this.
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.

Next steps

Did you find this page helpful?
Thumbs up icon
Thumbs down icon