Horizon OS SDK versioning

• How Horizon OS and Horizon OS SDK are versioned
• How your application can integrate the uses-horizonos-sdk manifest element
• How to support multiple Horizon OS versions by adjusting your application’s behavior at runtime

1. Within the root <manifest> element, add the following XML namespace attribute: xmlns:horizonos="http://schemas.horizonos/sdk".
2. Within the <manifest> element, add the <uses-horizonos-sdk> element and specify values for the minSdkVersion and targetSdkVersion attributes.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:tools="http://schemas.android.com/tools"
   xmlns:horizonos="http://schemas.horizonos/sdk">

   <horizonos:uses-horizonos-sdk
       horizonos:minSdkVersion="123"
       horizonos:targetSdkVersion="456" />
...

• Unity
• Spatial SDK

• What is the first Horizon OS SDK version that contains all APIs your application depends on?
• Does your application depend on components, such as libraries, that have their own minSdkVersion requirements?
• Across what range of Horizon OS versions do you intend to support your users?

• Set minSdkVersion to the Horizon OS SDK version used in development, both in your project and on your device. This ensures your application will not run on older Horizon OS versions.
• Set minSdkVersion to the first Horizon OS SDK version containing all APIs used directly by your application. This enables targeting a wider range of Horizon OS versions while ensuring your application does not invoke APIs that do not exist on the running OS version.
• Set minSdkVersion to the lowest Horizon OS SDK version you can support, even though older versions lack some APIs your application references. At runtime, invoke only APIs available in the Horizon OS SDK version reported by the version query APIs. This approach maximizes compatibility with older Horizon OS versions.

int first_sdk_version_with_new_api = ...

if get_horizon_os_sdk_version() < first_sdk_version_with_new_api
then call_deprecated_api()
else call_new_api()

dependencies {
  implementation 'com.meta.horizonosx:core:0.1.0'
}

import horizonosx.os.HorizonOsSdkVersion

if (HorizonOsSdkVersion.isAtOrAbove(200)) {
  // execute code that only works on Horizon OS version 200 or later
} else {
  // fall back to default behavior if APIs are not available
}