如需采用 Android 延迟和稳定性方面的改进,请使用 GMA Next-Gen SDK。本指南介绍了如何配置 Google Mobile Ads Flutter Plugin,以使用 GMA Next-Gen SDK(适用于 Android)。
前提条件
在继续之前,请确保满足以下条件:
- 安装 Google Mobile Ads Flutter Plugin 9.0.0 版或更高版本。
- 设置 Google Mobile Ads Flutter Plugin。
- 拥有一个 Flutter 项目。
配置 Android Gradle 设置
如需在 Android 上使用 GMA Next-Gen SDK,您必须更新 Gradle 配置:
- 设置最低 Android API 级别和编译 Android API 级别。
- 如果您使用中介,请按照迁移步骤
排除
com.google.android.gms模块 ,以避免出现重复类错误。
使用环境声明运行
如需在构建和运行 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 SDK 和
GMA Next-Gen SDK,您可以配置 android/app/build.gradle
文件,以根据环境声明有条件地定义依赖项。
Google Mobile Ads Flutter Plugin 在
示例应用 build.gradle 文件中提供了示例配置。