Wenn Sie die Verbesserungen bei Latenz und Stabilität von Android nutzen möchten, verwenden Sie GMA Next-Gen SDK. In diesem Leitfaden wird beschrieben, wie Sie Google Mobile Ads Flutter Plugin für die Verwendung von GMA Next-Gen SDK für Android konfigurieren.
Vorbereitung
Führen Sie zuerst folgende Schritte aus:
- Installieren Sie die Google Mobile Ads Flutter Plugin-Version 9.0.0 oder höher.
- Richten Sie Google Mobile Ads Flutter Plugin ein.
- Sie haben ein Flutter-Projekt.
Android-Gradle-Einstellungen konfigurieren
Wenn Sie GMA Next-Gen SDK unter Android verwenden möchten, müssen Sie Ihre Gradle-Konfigurationen aktualisieren:
- Mindest- und Compile-Android-API-Levels festlegen
- Wenn Sie Vermittlung verwenden, folgen Sie der Migrationsanleitung, um
com.google.android.gms-Module auszuschließen und Fehler durch doppelte Klassen zu vermeiden.
Mit Umgebungserklärung ausführen
Wenn Sie GMA Next-Gen SDK beim Erstellen und Ausführen Ihrer Android-App verwenden möchten, müssen Sie die USE_NEXT_GEN_SDK-Umgebungsdeklaration auf den Wert true festlegen.
Führen Sie bei jedem Erstellen oder Ausführen Ihrer App Folgendes aus:
flutter run --dart-define USE_NEXT_GEN_SDK=true
Mit IDE-Konfiguration ausführen
Wenn Sie Ihre App mit einer integrierten Entwicklungsumgebung (IDE) ausführen, können Sie Ihre Umgebungsdeklarationen in Ihrer Startkonfiguration konfigurieren, anstatt das Flag über die Befehlszeile zu übergeben.
Sie können diese Variablen beispielsweise in einer JSON-Datei definieren und sie Ihrer IDE-Einrichtung hinzufügen. Weitere Informationen finden Sie unter Umgebungsdeklarationen angeben.
Native Anzeigenvorlagen aktualisieren
Wenn Sie Vorlagen für native Anzeigen verwenden, nehmen Sie die folgenden Änderungen vor, um GMA Next-Gen SDK zu unterstützen:
NativeAdFactory-Paketimport aktualisieren
Aktualisieren Sie für Android die Importanweisung für die Klasse 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-Ansichten für das Layout von nativen Anzeigen aktualisieren
Aktualisieren Sie in den Layout-XML-Dateien für Ihre nativen Anzeigen die Ansichtsklasse für native Anzeigen:
<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />
<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />
Abhängigkeiten für beide Setups konfigurieren
Wenn Ihr Projekt sowohl Google Mobile Ads SDK (Legacy) als auch GMA Next-Gen SDK unterstützen muss, können Sie die Datei android/app/build.gradle so konfigurieren, dass Abhängigkeiten basierend auf der Umgebungsdeklaration bedingt definiert werden.
Google Mobile Ads Flutter Plugin enthält eine Beispielkonfiguration in der Beispiel-App-Datei build.gradle.