Requiring Minimum OS Versions

• Implicitly, by using a feature available only in a newer Horizon OS version. For example, if your application supports Quest 3, it requires a minimum Horizon OS version of v56, the first version that supports Quest 3.
• Explicitly, by defining a minimum Horizon OS version in your app’s uses-horizonos-sdk manifest element. This is useful if your app has implicit dependencies on a specific Horizon OS version, such as attempting to launch a system package with an intent supported only in a newer Horizon OS version, or for multiplayer applications that want to ensure all players have the latest security updates.

1. Gracefully handle the error - Allow your app to run on older devices and handle the case when the API is not available
2. Require a minimum Horizon OS version - Prevent your app from being installed on devices that don’t support the APIs you need

import horizon.platform.iap.Iap
import horizon.platform.iap.IapException

private val iap = Iap()

suspend fun restorePurchases() {
    try {
        val purchases = iap.getViewerPurchasesDurableCache()
        // Use the purchases
    } catch (e: IapException) {
        if (e.code == 1003) {
            // API not available on this device - use fallback behavior
            Log.w(TAG, "API not supported on this Horizon OS version: ${e.message}")
        } else {
            // Handle other errors
            Log.e(TAG, "IAP error: ${e.message}")
        }
    }
}

• The API provides optional or enhanced functionality
• You want maximum device compatibility
• Your app can provide a reasonable fallback experience

• Your app’s core functionality depends on specific APIs
• You don’t want to maintain fallback code paths
• You’re targeting newer devices with specific capabilities

This API was added in Horizon OS v83.

1. Identify all the Platform SDK APIs your app uses
2. Find the highest version number among those APIs
3. Use that version as your minSdkVersion

PackageManager pm = context.getPackageManager();
try {
	return pm.getPackageInfo("com.oculus.systemdriver", PackageManager.GET_META_DATA).versionName;
} catch (Exception e) { return e.toString(); }

<horizonos:uses-horizonos-sdk horizonos:minSdkVersion="[version]" horizonos:targetSdkVersion="[version]" />

• In your app’s AndroidManifest.xml file, setting android:minSdkVersion on the uses-sdk element sets the minimum Android SDK API level that your app is compatible with. Your app cannot be distributed or installed onto devices running an Android SDK API level lower than this. See the android:minSdkVersion attribute⁠ in the Android documentation for details.
• Adding a device to com.oculus.supportedDevices sets the minimum Horizon OS version to the first version that supports that device.
• Using the Android Camera2 API⁠ for direct access to camera frames sets the minimum Horizon OS version to v74.

• Using multiple Platform SDK APIs that were introduced in different Horizon OS versions requires the highest version among them.

• The Meta Horizon Store will only show your app to users on compatible devices
• Users on older devices won’t be able to install or update to this version
• You can safely call the APIs without error handling for version compatibility

• Start with error handling: During development, handle errors gracefully to understand which APIs might not be available
• Test on multiple versions: If possible, test your app on devices running different Horizon OS versions
• Document your requirements: Clearly communicate to users what Horizon OS version your app requires
• Consider staged releases: If adding a minSdkVersion, consider how it affects your existing user base

• Get Started with Platform SDK — Set up your development environment