Aby zastosować ulepszenia dotyczące opóźnień i stabilności Androida, użyj GMA Next-Gen SDK. Z tego przewodnika dowiesz się, jak skonfigurować Google Mobile Ads Flutter Plugin do używania GMA Next-Gen SDK na Androidzie.
Wymagania wstępne
Zanim przejdziesz dalej:
- Zainstaluj Google Mobile Ads Flutter Plugin w wersji 9.0.0 lub nowszej.
- Skonfiguruj Google Mobile Ads Flutter Plugin.
- mieć projekt we Flutterze;
Konfigurowanie ustawień Gradle w Androidzie
Aby korzystać z GMA Next-Gen SDK na Androidzie, musisz zaktualizować konfiguracje Gradle:
- Ustaw minimalny i kompilowany poziom interfejsu API Androida.
- Jeśli korzystasz z mediacji, wykonaj czynności związane z migracją, aby wykluczyć moduły
com.google.android.gmsi uniknąć błędów związanych ze zduplikowanymi klasami.
Uruchamianie z deklaracją środowiska
Aby używać GMA Next-Gen SDK podczas tworzenia i uruchamiania aplikacji na Androida, musisz podać deklarację środowiska USE_NEXT_GEN_SDK ustawioną na wartość true.
Za każdym razem, gdy kompilujesz lub uruchamiasz aplikację, wykonaj te czynności:
flutter run --dart-define USE_NEXT_GEN_SDK=true
Uruchamianie z konfiguracją IDE
Jeśli uruchamiasz aplikację w zintegrowanym środowisku programistycznym (IDE), możesz skonfigurować deklaracje środowiska w konfiguracji uruchamiania zamiast przekazywać flagę w wierszu poleceń.
Możesz na przykład zdefiniować te zmienne w pliku JSON i dodać je do konfiguracji IDE. Więcej informacji znajdziesz w artykule Określanie deklaracji środowiska.
Aktualizowanie szablonów reklam natywnych
Jeśli używasz szablonów reklam natywnych, wprowadź te zmiany, aby obsługiwać GMA Next-Gen SDK:
Aktualizowanie importu pakietu NativeAdFactory
W przypadku Androida zaktualizuj instrukcję importu dla klasy 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
Aktualizowanie widoków XML układu widoku reklamy natywnej
W plikach XML układu reklam natywnych zaktualizuj klasę widoku reklamy natywnej:
<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />
<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />
Konfigurowanie zależności w obu konfiguracjach
Jeśli projekt musi obsługiwać zarówno Google Mobile Ads SDK (Legacy), jak i GMA Next-Gen SDK, możesz skonfigurować plik android/app/build.gradle, aby warunkowo definiować zależności na podstawie deklaracji środowiska.
Google Mobile Ads Flutter Plugin zawiera przykładową konfigurację w pliku build.gradle przykładowej aplikacji.