Aby korzystać z ulepszeń dotyczących opóźnienia i stabilności Androida, użyj GMA Next-Gen SDK. Z tego przewodnika dowiesz się, jak skonfigurować Google Mobile Ads Flutter Plugin, aby używać 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.
- Przygotuj projekt Flutter.
Konfigurowanie ustawień Gradle na Androidzie
Aby używać GMA Next-Gen SDK na Androidzie, musisz zaktualizować konfiguracje Gradle:
- Ustaw minimalny i docelowy poziom interfejsu API Androida.
- Jeśli używasz mediacji, wykonaj czynności migracji, aby
wykluczyć moduły
i uniknąć błędów związanych z duplikowaniem klas.
com.google.android.gms
Uruchamianie z deklaracją środowiska
Aby używać GMA Next-Gen SDK podczas kompilowania i uruchamiania aplikacji na Androida,
musisz podać deklarację środowiska USE_NEXT_GEN_SDK ustawioną na
true wartość.
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ę 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 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 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 ... />
Konfigurowanie zależności w obu konfiguracjach
Jeśli Twój projekt musi obsługiwać zarówno Google Mobile Ads SDK 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 aplikacji przykładowej.