Per adottare i miglioramenti della latenza e della stabilità di Android, utilizza GMA Next-Gen SDK. Questa guida illustra come configurare Google Mobile Ads Flutter Plugin per l'utilizzo di GMA Next-Gen SDK per Android.
Prerequisiti
Prima di continuare, completa queste operazioni:
- Installa Google Mobile Ads Flutter Plugin versione 9.0.0 o successive.
- Configura Google Mobile Ads Flutter Plugin.
- Avere un progetto Flutter.
Configura le impostazioni di Android Gradle
Per utilizzare GMA Next-Gen SDK su Android, devi aggiornare le configurazioni Gradle:
- Imposta i livelli API Android minimi e di compilazione.
- Se utilizzi la mediazione, segui i passaggi di migrazione per escludere i moduli
com.google.android.gmsper evitare errori di classe duplicati.
Esegui con la dichiarazione dell'ambiente
Per utilizzare GMA Next-Gen SDK durante la creazione e l'esecuzione della tua app per Android, devi fornire la dichiarazione dell'ambiente USE_NEXT_GEN_SDK impostata sul valore true.
Ogni volta che crei o esegui la tua app, esegui questo comando:
flutter run --dart-define USE_NEXT_GEN_SDK=true
Esegui con la configurazione dell'IDE
Se esegui l'app utilizzando un ambiente di sviluppo integrato (IDE), puoi configurare le dichiarazioni dell'ambiente nella configurazione di lancio anziché passare il flag utilizzando la riga di comando.
Ad esempio, puoi definire queste variabili in un file JSON e aggiungerle alla configurazione dell'IDE. Per maggiori dettagli, consulta Specifica delle dichiarazioni di ambiente.
Aggiorna i modelli di annunci nativi
Se utilizzi i modelli di annunci nativi, apporta i seguenti aggiornamenti per supportare GMA Next-Gen SDK:
Aggiorna l'importazione del pacchetto NativeAdFactory
Per Android, aggiorna l'istruzione di importazione per la classe 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
Aggiorna le visualizzazioni XML del layout di visualizzazione degli annunci nativi
Nei file XML di layout per gli annunci nativi, aggiorna la classe di visualizzazione degli annunci nativi:
<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />
<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />
Configura le dipendenze per entrambe le configurazioni
Se il tuo progetto deve supportare sia Google Mobile Ads SDK (Legacy) che GMA Next-Gen SDK, puoi configurare il file android/app/build.gradle per definire in modo condizionale le dipendenze in base alla dichiarazione dell'ambiente.
Google Mobile Ads Flutter Plugin fornisce una configurazione di esempio nel file dell'app di esempio build.gradle.