如要採用 Android 延遲和穩定性改良項目,請使用 GMA Next-Gen SDK。本指南說明如何設定 Google Mobile Ads Flutter Plugin,以使用 Android 適用的 GMA Next-Gen SDK。
必要條件
繼續操作前,請先執行下列工作:
- 安裝 Google Mobile Ads Flutter Plugin 9.0.0 以上版本。
- 設定 Google Mobile Ads Flutter Plugin。
- 擁有 Flutter 專案。
設定 Android Gradle
如要在 Android 上使用 GMA Next-Gen SDK,請更新 Gradle 設定:
- 設定最低和編譯 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 檔案中提供設定範例。