Support THEOplayer 10.2.0 and higher

README.md

@@ -24,8 +24,8 @@ For more details about importing THEOplayer Android SDK check the [documentation
 Notes:
 * The `+` will fetch the latest released version of THEOplayer Android SDK Connector.
 * Android Studio will recommend replacing the `+` with the exact version of THEOplayer Android SDK Connector.
-* The THEOplayer Android SDK and the THEOplayer Android SDK Connectors are stable when using the same version.
-  It's not recommended to use different versions for the Android SDK and the Connectors.
+* THEOplayer Android SDK Connectors are compatible with a THEOplayer SDK with the same major version number.
+  It's not recommended to use different major versions for the Android SDK and the Connectors.
 
 ## Installation
 

app/build.gradle.kts

@@ -25,6 +25,18 @@ android {
         }
     }
 
+    flavorDimensions += "player"
+    productFlavors {
+        create("latestPlayer") {
+            // Use the latest supported THEOplayer version
+            dimension = "player"
+        }
+        create("minPlayer") {
+            // Use the minimum supported THEOplayer version
+            dimension = "player"
+        }
+    }
+
     compileOptions {
         sourceCompatibility = JavaVersion.VERSION_1_8
         targetCompatibility = JavaVersion.VERSION_1_8
@@ -43,6 +55,9 @@ kotlin {
 }
 
 dependencies {
+    val latestPlayerImplementation = configurations.getByName("latestPlayerImplementation")
+    val minPlayerImplementation = configurations.getByName("minPlayerImplementation")
+
     implementation(libs.androidx.core.ktx)
     implementation(libs.androidx.appcompat)
     implementation(libs.kotlinx.coroutines.android)
@@ -57,9 +72,26 @@ dependencies {
     implementation(libs.androidx.compose.ui.tooling.preview)
     debugImplementation(libs.androidx.compose.ui.tooling)
 
-    implementation(libs.theoplayer)
-    implementation(libs.theoplayer.integration.ima)
-    implementation(libs.theoplayer.integration.dai)
+    latestPlayerImplementation(libs.theoplayer)
+    latestPlayerImplementation(libs.theoplayer.integration.ima)
+    latestPlayerImplementation(libs.theoplayer.integration.dai)
+
+    minPlayerImplementation(libs.theoplayer) {
+        version {
+            strictly(libs.versions.theoplayerMin.get())
+        }
+    }
+    minPlayerImplementation(libs.theoplayer.integration.ima) {
+        version {
+            strictly(libs.versions.theoplayerMin.get())
+        }
+    }
+    minPlayerImplementation(libs.theoplayer.integration.dai) {
+        version {
+            strictly(libs.versions.theoplayerMin.get())
+        }
+    }
+
     implementation(libs.theoplayer.android.ui)
 
     implementation(project(":connectors:analytics:conviva"))

build.gradle.kts

@@ -30,8 +30,8 @@ tasks.register("updateVersion") {
     ant.withGroovyBuilder {
         "replaceregexp"(
             "file" to versionCatalog,
-            "match" to """^theoplayer = ".+"$""",
-            "replace" to """theoplayer = "$sdkVersion"""",
+            "match" to """^theoplayer = \{(.*) prefer = ".+" (.*)\}$""",
+            "replace" to """theoplayer = {\1 prefer = "$sdkVersion" \2}""",
             "byline" to true
         )
         "replaceregexp"(

gradle/libs.versions.toml

@@ -14,7 +14,10 @@ androidxComposeBom = "2025.08.01"
 androidxLifecycle = "2.5.1"
 androidxMedia = "1.7.1"
 kotlinxCoroutines = "1.10.2"
-theoplayer = "10.12.1"
+theoplayer = { strictly = "[10.2.0, 11.0.0)", prefer = "10.12.1" }
+# Minimum supported THEOplayer version.
+# Must match the lower version bound of the "theoplayer" version above.
+theoplayerMin = "10.2.0"
 theoplayerAndroidUi = "1.13.0"
 junit = "4.13.2"
 kotlinTestJunit = "2.2.10"