Wenn Sie die Verbesserungen der 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 die folgenden Schritte aus, bevor Sie fortfahren:
- Installieren Sie 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:
- Legen Sie das minimale und das kompilierte Android API-Level fest.
- Wenn Sie die Vermittlung verwenden, folgen Sie den Migrationsschritten, um
com.google.android.gms-Module auszuschließen und Fehler aufgrund doppelter Klassen zu vermeiden.
Mit Umgebungsdeklaration ausführen
Wenn Sie GMA Next-Gen SDK beim Erstellen und Ausführen Ihrer Android-App verwenden möchten, müssen Sie die Umgebungsdeklaration USE_NEXT_GEN_SDK mit dem Wert true angeben.
Führen Sie jedes Mal, wenn Sie Ihre Anwendung erstellen oder ausführen, Folgendes aus:
flutter run --dart-define USE_NEXT_GEN_SDK=true
Mit IDE-Konfiguration ausführen
Wenn Sie Ihre Anwendung mit einer integrierten Entwicklungsumgebung (IDE) ausführen, können Sie die Umgebungsdeklarationen in der Startkonfiguration konfigurieren, anstatt das Flag über die Befehlszeile zu übergeben.
Sie können diese Variablen beispielsweise in einer JSON-Datei definieren und Ihrer IDE-Einrichtung hinzufügen. Weitere Informationen finden Sie unter Umgebungsdeklarationen angeben.
Vorlagen für native Anzeigen aktualisieren
Wenn Sie Vorlagen für native Anzeigen verwenden, nehmen Sie die folgenden Aktualisierungen vor, um GMA Next-Gen SDK zu unterstützen:
Paketimport für NativeAdFactory 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 des Layouts für native Anzeigen aktualisieren
Aktualisieren Sie in den Layout-XML-Dateien für Ihre nativen Anzeigen die Klasse für die Ansicht nativer 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 Konfigurationen 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 bedingt anhand der Umgebungsdeklaration definiert werden.
Google Mobile Ads Flutter Plugin stellt eine Beispielkonfiguration in der Beispiel-App-Datei build.gradle bereit.