Meta VR OS SDK versioning

1. Within the root <manifest> element, add the following XML namespace attribute: xmlns:metavr="http://schemas.meta.com/metavr-sdk".
2. Within the <manifest> element, add the <uses-metavr-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:metavr="http://schemas.meta.com/metavr-sdk">

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

• Unity
• Spatial SDK
• Meta VR OS JSDK
• Meta VR OS NSDK

• What is the first Meta VR 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 Meta VR 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 (which you did not develop on).
• Set minSdkVersion to the first Meta VR 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 Meta VR OS SDK version you can support, even though older versions lack some APIs your application references. At runtime, invoke only APIs available in the Meta VR 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_metavr_os_sdk_version() < first_sdk_version_with_new_api
then call_deprecated_api()
else call_new_api()

dependencies {
  implementation("com.meta.metavrx.util:util:1.0.0")
}

import metavrx.os.MetaVrOsSdkVersion

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