版本说明

版本 发布日期 备注
0.25.0-beta01 2026-03-24
0.24.0-beta03 2026-03-07
  • 修复了以下问题：在广告加载失败后，AdView.destroy() 未能停止广告加载重试。
  • 为 NativeAdMapper 和 UnifiedNativeAdMapper 添加了零参数构造函数，以提高与 Kotlin 的兼容性。
  • 向 IconAd 接口添加了 packageName 属性。
  • 添加了一个选项，用于强制 SDK 使用 Cronet 而不是 OkHttp 进行网络操作。为了解决使用 OkHttp 5 的项目中的运行时错误，我们建议强制使用 Cronet 进行网络操作。如需强制使用 Cronet，请在调用 MobileAds.initialize() 时，在 InitializationConfig.Builder 中将 force_use_cronet extra 设置为 true： 
    val config = InitializationConfig.Builder()
  .setExtras(bundleOf("force_use_cronet" to true))
  .build()
MobileAds.initialize(this, config)
  • 添加了对 Java 11 的支持。如需使用 Java 11，请将以下代码添加到 build.gradle 文件中的 android 代码块：
    android {
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_11
    targetCompatibility JavaVersion.VERSION_11
  }
  kotlinOptions {
    jvmTarget = '11'
  }
}
0.24.0-beta02 2026-03-03
  • 解决了影响服务器到服务器广告请求信号生成的第三方依赖项类加载问题。
0.24.0-beta01 2026-02-13
0.23.0-beta01 2026-01-26
0.22.0-beta04 2025-12-04
  • 修复了 SDK 版本 0.22.0-beta02 中的一个问题，即 Java 17 预览版 元数据被错误地包含在类文件中。
0.22.0-beta03 2025-11-25
0.22.0-beta02 2025-11-24
0.22.0-beta01 2025-11-20
  • 更新了横幅广告 API：
  • 修复了中介广告中的一个 bug，即 NativeAdRequest.Builder.setAdChoicesPlacement() 未被遵循，导致广告选择图标放置位置不正确。
  • 将所需的最低 Android Gradle 插件 (AGP) 版本从 8.2.0 降至 7.3.1。
  • 废弃了 AdPreloader.getConfigurations() 和 AdPreloader.getConfiguration(preloadId)。没有 替代方法。
0.21.0-beta01 2025-10-08
  • 添加了 InitializationConfig.Builder.disableMediationAdapterInitialization() 方法。请在初始化 GMA Next-Gen SDK 之前调用此方法，以停用中介适配器初始化。
  • 改进了 WebView 初始化使用情况，以减少 ANR。
  • 将 androidx.webkit 依赖项从 1.13.0 降级到 1.12.1。
  • 移除了 android.permission.RECEIVE_BOOT_COMPLETED 软件包使用的 androidx.work 权限。
  • 修复了 NativeAdMapper 类中命名错误的字段。
0.20.0-beta01 2025-09-19
  • 修复了以下 bug：某些原生视频广告素材不会自动播放。
0.19.0-beta01 2025-08-14
  • 降级了两个依赖项的版本。
    • androidx.work:work-runtime 从 2.10.0 降级到 2.7.0。
    • androidx.core:core and androidx.core:core-ktx 从 1.15.0 降级到 1.12.0。
  • 将 中的 loadedAdSourceResponse 属性重命名为 loadedAdSourceResponseInfo。ResponseInfo
  • 修复了以下 bug：用户可以使用返回按钮过早关闭某些全屏广告。
  • 有权使用该功能的发布商现在可以为所有广告格式提供广告位 ID 支持。
  • 为原生中介适配器向 NativeAdMapper 添加了 destroy() 回调。
0.18.0-beta01 2025-07-17
  • 修复了原生中介 bug，该 bug 导致引用 com.google.android.gms.ads.NativeAd.MediaView 的适配器无法投放广告。
  • 使用 @JvmStatic 注解了 MobileAds.registerCustomTabsSession()。
  • 修复了以下 bug：使用 AdMob 广告联盟瀑布流加载的横幅广告会停止刷新。
0.17.0-alpha02 2025-06-23
  • 修复了原生中介出价错误，该错误导致实现出价但不实现广告瀑布流（例如 Meta Audience Network）的适配器始终无法呈现原生广告。
  • 修复了中介适配器针对单个广告请求调用多个 MediationAdLoadCallback 方法时发生的崩溃。
0.17.0-alpha01 2025-06-18
  • 0.17.0-alpha01 版是意外发布的版本， 不包含预期的新功能。请改用 0.17.0-alpha02 版。
0.16.0-alpha01 2025-05-23
0.15.1-alpha01 2025-04-28
  • 现在需要启用 Java 8+ API 脱糖支持。
  • 对于使用 Kotlin 开发的应用，将所需的最低 Kotlin 版本从 2.1 降至 1.9。
0.15.0-alpha01 2025-04-24
  • 原生广告：添加了对加载多个原生广告的支持。
    • 添加了 NativeAdLoader.load(NativeAdRequest, numberOfAds, NativeAdLoaderCallback) 方法，用于一次请求多个广告。
    • 添加了 NativeAdLoaderCallback.onAdLoadingCompleted() 回调，该回调会在所有原生广告加载完毕后触发。
    • 为了支持 Kotlin 异步加载，添加了 NativeAdLoader.load(NativeAdRequest, numberOfAds) 方法 ，该方法会返回 Flow<NativeAdLoadResult>。
  • 将 kotlinx-coroutines-android 依赖项从 1.7.3 版更新为 1.9.0 版。
0.14.0-alpha01 2025-03-20
  • 如果您使用无效的应用 ID 初始化 SDK，广告请求将会失败。
  • The AdPreloader.start() 方法不再需要 PreloadCallback 回调。
  • 通过 PreloadConfiguration 数据类创建对象时，bufferSize 属性是可选的。如需让 Google 优化缓冲区空间大小，请勿设置 bufferSize 属性。
  • 移除了 maxAdsPerSession 属性在 PreloadConfiguration 数据类中。
  • 向 NativeAdOptions 类添加了 shouldRequestMultipleImages 和 shouldReturnUrlsForImageAssets 属性。
0.13.0-alpha01 2025-02-26
  • 添加了 MediationRewardedAdCallback.onUserEarnedReward() 并废弃了 MediationRewardedAdCallback.onUserEarnedReward(RewardItem)。
  • 添加了广告预加载 API。
0.12.0-alpha01 2025-01-22
  • 修复了以下 bug：AdRequest、 AdRequest.Builder、SignalRequest 和 SignalRequest.Builder 中的某些方法被混淆。
  • 对于没有 Ad Manager 应用 ID 的适用于广告的 WebView API 用户，添加了可在 SDK 初始化期间传递的 InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID。
  • 添加了对在 Ad Manager 广告 请求中组合使用原生广告和横幅广告的支持。
0.11.0-alpha01 2024-12-12
  • 将 User Messaging Platform SDK 的依赖项更新为 3.1.0 版。
  • 添加了对原生广告中自定义点击手势的支持。
  • 添加了对 Ad Manager 预订中横幅广告展示次数手动统计的支持。
0.10.0-alpha01 2024-11-08
  • 为 VideoOptions 和 RequestConfiguration 添加了 DSL 函数，以更好地支持 Kotlin。
  • 添加了对 Publisher Privacy Treatment API 的支持，并使用了 RequestConfiguration.setPublisherPrivacyPersonalizationState()。
  • 添加了用于加载广告和生成信号的 Kotlin 挂起 API。
  • 移除了 IconAd.LoadAdResult 并将其替换为 AdLoadResult。
  • 修复了以下问题：OMID 会话未针对原生视频广告素材启动。
0.9.0-alpha01 2024-10-02
  • 从 0.6.0-alpha01 版开始，移除了对 通过脱糖获得的 Java 8+ API 的依赖项。使用 minSdkVersion 低于 26 的应用不再需要启用 Java 8+ API 脱糖支持。
  • 添加了对广告检查器的支持。
  • 添加了对自定义原生广告格式的视频支持。
  • 正式发布了信号收集和呈现 API。
0.8.0-alpha01 2024-08-22
  • 将 User Messaging Platform SDK 的依赖项更新为 3.0.0 版。
  • 原生广告：
    • 原生广告格式的正式发布版本。
    • 添加了对在 MediaContent 资源中投放视频的支持。
    • 添加了视频生命周期回调。
    • 添加了视频播放自定义控件。
    • 为原生广告和自定义原生广告启用了开放式衡量。
  • signalType 构建 SignalRequest 时，现在是必填字段。
0.6.0-alpha01 2024-06-20
  • 添加了使用 通过脱糖获得的 Java 8+ API 的代码。使用 minSdkVersion 低于 26 的应用必须启用 Java 8+ API 脱糖支持。
  • 添加了对不包含视频资源的原生广告和自定义原生广告格式的支持。
  • 添加了对 MRAID v3 的支持。
  • 添加了对 User Messaging Platform SDK 2.2.0 版的依赖项。
  • 将 Google 错误的错误网域从 com.google.android.gms.ads 更新为 com.google.android.libraries.ads.mobile.sdk.
  • 添加了 MobileAds.isInitialized() 方法，用于检查 SDK 是否已初始化。
  • 添加了 BannerAd.isCollapsible()，用于检查返回的横幅广告是否可折叠。
  • 添加了 MobileAds.registerCustomTabsSession()，用于提高自定义标签页中广告的创收能力。
  • 将 OnInitializationCompleteListener 重命名为 OnAdapterInitializationCompleteListener。
  • 将 AdapterResponseInfo 重命名为 AdSourceResponseInfo.
  • 将 AdRequest.Builder.putAdNetworkExtrasBundle() 重命名为 AdRequest.Builder.putAdSourceExtrasBundle().
  • 修复了以下 bug：出价适配器类未正确实例化 。
0.3.0-alpha01 2024-03-20
  • GMA Next-Gen SDK 的初始版本。
  • 支持横幅广告、插页式广告、激励广告、插页式激励广告和开屏广告。
  • 支持所有广告格式的中介。为当前的移动广告 SDK 编写的适配器与 GMA Next-Gen SDK 向前兼容。
  • 添加了对 Open Measurement SDK 1.4.10 版的依赖项。