Horizon OS Java Software Development Kit Integration Guide

• Android Studio 2025.2.* or newer
• Android Gradle Plugin 8.9.0 or higher
• Gradle 8.13 or higher
• A physical Meta Quest device running Horizon OS
  • Note: Each API requires a minimum version of Horizon OS. See API reference documentation for details.

• Option A: Gradle dependency (recommended): Configure your project to download the JSDK AAR from Maven Central.
• Option B: Manual integration: Download the JSDK AAR manually and add it to your project using Android Studio’s Project Structure tool or by directly modifying your project’s Gradle configuration files.

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()   // Required for JSDK
    }
}

[libraries]
horizonos-jdk = { group = "com.meta.horizonos", name = "horizon-os-jdk", version = "204" }

dependencies {
    compileOnly(libs.horizonos.jdk)
}

• Option 1: Use Android Studio’s Project Structure tool
• Option 2: Modify Gradle build configuration files manually

1. Open File > Project Structure.
2. Select the Dependencies tab.
3. Under Modules, select the module from which you want to invoke JSDK APIs (for example, app).
4. Click the + button in the Declared Dependencies section.
5. Select JAR/AAR Dependency.
6. In the dialog’s Step 1 field, enter the relative path to the JSDK AAR file. For example, if your module is named app and the AAR is under <project root>/app/lib, enter lib/horizon-os-jdk-v204.aar.
7. In the dialog’s Step 2 field, manually enter compileOnly. This option may not appear by default in the dropdown menu but can be selected from the autocomplete once you start typing.
8. Click OK to confirm.

compileOnly(files("lib/horizon-os-jdk-v204.aar"))

import horizonos.os.Build
...
val sdkVersion: Int = Build.HorizonOsSdk.getVersion()

• Statically, like the snippet above which references Build.HorizonOsSdk.getVersion().
• Manager classes, fetched via Context.getSystemService()⁠.