[interactive_media_ads] Updates README with information about enabling desugaring on Android (#9790)

Get started for IMA on Android includes enabling desugaring: https://developers.google.com/interactive-media-ads/docs/sdks/android/client-side/get-started#2.-add-the-ima-sdk-to-your-project

This updates the README for the plugin with the same information.

## Pre-Review Checklist

**Note**: The Flutter team is currently trialing the use of [Gemini Code Assist for GitHub](https://developers.google.com/gemini-code-assist/docs/review-github-code). Comments from the `gemini-code-assist` bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed.

[^1]: Regular contributors who have demonstrated familiarity with the repository guidelines only need to comment if the PR is not auto-exempted by repo tooling.

Author: bparrishMines

packages/interactive_media_ads/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.2.6+3
+
+* Updates `README` with information about enabling desugaring on Android.
+
 ## 0.2.6+2
 
 * Updates kotlin version to 2.2.0 to enable gradle 8.11 support.

packages/interactive_media_ads/README.md

@@ -14,8 +14,7 @@ a separate video player positioned on top of the app's content video player.
 | **Support** | SDK 21+ | 12.0+ |
 
 **NOTE:**
-* Companion ads, Background Audio ads and Google Dynamic Ad Insertion methods are currently not
-  supported.
+* Background Audio ads and Google Dynamic Ad Insertion methods are currently not supported.
 
 ## IMA client-side overview
 
@@ -37,9 +36,13 @@ initialization and playback.
 This guide demonstrates how to integrate the IMA SDK into a new `Widget` using the [video_player][7]
 plugin to display content.
 
-### 1. Add Android Required Permissions
+### 1. Update Android App
 
-If building on Android, add the user permissions required by the IMA SDK for requesting ads in
+If not building for Android, skip this step.
+
+#### Update Android Manifest
+
+Add the user permissions required by the IMA SDK for requesting ads in
 `android/app/src/main/AndroidManifest.xml`.
 
 <?code-excerpt "example/android/app/src/main/AndroidManifest.xml (android_manifest)"?>
@@ -50,6 +53,32 @@ If building on Android, add the user permissions required by the IMA SDK for req
     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
 ```
 
+#### Update Android App-level Gradle
+
+The IMA SDK requires library desugaring enabled, which you must do by setting
+`coreLibraryDesugaringEnabled true` and adding
+`coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.1.5'` as a dependency in the
+`android/app/build.gradle` file. For more details, see
+[Java 11+ APIs available through desugaring with the nio specification](https://developer.android.com/studio/write/java11-nio-support-table).
+
+<?code-excerpt "example/android/app/build.gradle (android_desugaring)"?>
+```groovy
+android {
+// ···
+    compileOptions {
+        coreLibraryDesugaringEnabled true
+        sourceCompatibility JavaVersion.VERSION_11
+        targetCompatibility JavaVersion.VERSION_11
+    }
+    // ···
+}
+// ···
+dependencies {
+    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.1.5'
+    // ···
+}
+```
+
 ### 2. Add Imports
 
 Add the import statements for the `interactive_media_ads` and [video_player][7]. Both plugins should

packages/interactive_media_ads/android/src/main/kotlin/dev/flutter/packages/interactive_media_ads/AdsRequestProxyApi.kt

@@ -21,7 +21,7 @@ class AdsRequestProxyApi(override val pigeonRegistrar: ProxyApiRegistrar) :
      *
      * This must match the version in pubspec.yaml.
      */
-    const val pluginVersion = "0.2.6+2"
+    const val pluginVersion = "0.2.6+3"
   }
 
   override fun setAdTagUrl(pigeon_instance: AdsRequest, adTagUrl: String) {

packages/interactive_media_ads/example/android/app/build.gradle

@@ -22,15 +22,20 @@ if (flutterVersionName == null) {
     flutterVersionName = '1.0'
 }
 
+// #docregion android_desugaring
 android {
+// #enddocregion android_desugaring
     namespace "dev.flutter.packages.interactive_media_ads_example"
     compileSdk = flutter.compileSdkVersion
     ndkVersion = flutter.ndkVersion
 
+    // #docregion android_desugaring
     compileOptions {
+        coreLibraryDesugaringEnabled true
         sourceCompatibility JavaVersion.VERSION_11
         targetCompatibility JavaVersion.VERSION_11
     }
+    // #enddocregion android_desugaring
 
     kotlinOptions {
         jvmTarget = '11'
@@ -54,15 +59,22 @@ android {
             signingConfig signingConfigs.debug
         }
     }
+// #docregion android_desugaring
 }
+// #enddocregion android_desugaring
 
 flutter {
     source '../..'
 }
 
+// #docregion android_desugaring
 dependencies {
+    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:2.1.5'
+    // #enddocregion android_desugaring
     testImplementation 'junit:junit:4.13.2'
     androidTestImplementation 'androidx.test:runner:1.2.0'
     androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
     api 'androidx.test:core:1.4.0'
+// #docregion android_desugaring
 }
+// #enddocregion android_desugaring

packages/interactive_media_ads/ios/interactive_media_ads/Sources/interactive_media_ads/AdsRequestProxyAPIDelegate.swift

@@ -13,7 +13,7 @@ class AdsRequestProxyAPIDelegate: PigeonApiDelegateIMAAdsRequest {
   /// The current version of the `interactive_media_ads` plugin.
   ///
   /// This must match the version in pubspec.yaml.
-  static let pluginVersion = "0.2.6+2"
+  static let pluginVersion = "0.2.6+3"
 
   func pigeonDefaultConstructor(
     pigeonApi: PigeonApiIMAAdsRequest, adTagUrl: String, adDisplayContainer: IMAAdDisplayContainer,

packages/interactive_media_ads/pubspec.yaml

@@ -2,7 +2,7 @@ name: interactive_media_ads
 description: A Flutter plugin for using the Interactive Media Ads SDKs on Android and iOS.
 repository: https://github.com/flutter/packages/tree/main/packages/interactive_media_ads
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+interactive_media_ads%22
-version: 0.2.6+2 # This must match the version in
+version: 0.2.6+3 # This must match the version in
   # `android/src/main/kotlin/dev/flutter/packages/interactive_media_ads/AdsRequestProxyApi.kt` and
   # `ios/interactive_media_ads/Sources/interactive_media_ads/AdsRequestProxyAPIDelegate.swift`