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 urządzeniach z Androidem.
Wymagania wstępne
Zanim przejdziesz dalej, wykonaj te czynności:
- 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 Android API.
- 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 z duplikatami klas.
Uruchamianie z deklaracją środowiska
Aby podczas tworzenia i uruchamiania aplikacji na Androida używać GMA Next-Gen SDK, musisz podać deklarację środowiska USE_NEXT_GEN_SDK ustawioną na wartość true.
Za każdym razem, gdy tworzysz lub uruchamiasz aplikację, wykonaj te czynności:
flutter run --dart-define USE_NEXT_GEN_SDK=true
Uruchamianie z konfiguracją IDE
Jeśli uruchamiasz aplikację za pomocą zintegrowanego środowiska programistycznego (IDE), możesz skonfigurować deklaracje środowiska w konfiguracji uruchamiania zamiast przekazywać flagę za pomocą wiersza poleceń.
Możesz na przykład zdefiniować te zmienne w pliku JSON i dodać je do konfiguracji IDE. Więcej informacji znajdziesz w sekcji 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 wyświetlenia 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 ... />
Skonfiguruj zależności dla obu konfiguracji
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 udostępnia przykładową konfigurację w pliku build.gradle przykładowej aplikacji.