安装 GMA 新一代 SDK

如需采用 Android 延迟和稳定性方面的改进,请使用 GMA Next-Gen SDK。本指南介绍了如何配置 Google Mobile Ads Flutter Plugin,以使用 GMA Next-Gen SDK(适用于 Android)。

前提条件

在继续之前,请确保满足以下条件:

配置 Android Gradle 设置

如需在 Android 上使用 GMA Next-Gen SDK,您必须更新 Gradle 配置:

使用环境声明运行

如需在构建和运行 Android 应用时使用 GMA Next-Gen SDK, 您必须提供设置为 true 值的 USE_NEXT_GEN_SDK 环境声明。

每次构建或运行应用时,请运行以下命令:

flutter run --dart-define USE_NEXT_GEN_SDK=true

使用 IDE 配置运行

如果您使用集成开发环境 (IDE) 运行应用,则可以在启动配置中配置环境声明,而无需使用命令行传递标志。

例如,您可以在 JSON 文件中定义这些变量,并将其添加到 IDE 设置中。如需了解详情,请参阅 指定环境声明

更新原生广告模板

如果您使用原生广告模板,请进行以下更新以支持 GMA Next-Gen SDK

更新 NativeAdFactory 软件包导入

对于 Android,请更新 NativeAdFactory 类的导入语句:

Java

// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory;

// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory;

Kotlin

// Replace this import:
import io.flutter.plugins.googlemobileads.GoogleMobileAdsPlugin.NativeAdFactory

// With this import:
import io.flutter.plugins.googlemobileads.NativeAdFactory

更新原生广告视图布局 XML 视图

在原生广告的布局 XML 文件中,更新原生广告视图类:

<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />

<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />

为两种设置配置依赖项

如果您的项目必须同时支持 Google Mobile Ads SDKGMA Next-Gen SDK,您可以配置 android/app/build.gradle 文件,以根据环境声明有条件地定义依赖项。

Google Mobile Ads Flutter Plugin示例应用 build.gradle 文件中提供了示例配置。