Aby korzystać z ulepszeń Androida dotyczących czasu oczekiwania i stabilności, używaj GMA Next-Gen SDK. W tym przewodniku opisano konfigurowanie Google Mobile Ads Flutter Plugin do korzystania z GMA Next-Gen SDK na Androidzie.
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 Flutter,
Konfigurowanie ustawień Gradle na Androidzie
Aby używać GMA Next-Gen SDK na Androidzie, musisz zaktualizować konfiguracje Gradle:
- Ustaw minimalny i skompilowany 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
Uruchom 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 artykule o określaniu 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 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 dla obu konfiguracji
Jeśli Twój 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 przykładowej aplikacji build.gradle.