Installa l'SDK GMA di nuova generazione

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 utilizzare GMA Next-Gen SDK per Android.

Prerequisiti

Prima di continuare, completa queste operazioni:

Configurare le impostazioni di Gradle per Android

Per utilizzare GMA Next-Gen SDK su Android, devi aggiornare le configurazioni di Gradle:

Eseguire con la dichiarazione dell'ambiente

Per utilizzare GMA Next-Gen SDK durante la creazione e l'esecuzione dell'app per Android, devi fornire la dichiarazione dell'ambiente USE_NEXT_GEN_SDK impostata sul true valore.

Ogni volta che crei o esegui l'app, esegui quanto segue:

flutter run --dart-define USE_NEXT_GEN_SDK=true

Eseguire 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 avvio 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 la sezione relativa alla specifica delle dichiarazioni dell'ambiente.

Aggiornare i modelli di annunci nativi

Se utilizzi i modelli di annunci nativi, apporta i seguenti aggiornamenti per supportare GMA Next-Gen SDK:

Aggiornare 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

Aggiornare le visualizzazioni XML del layout della visualizzazione di annuncio nativo

Nei file XML di layout per gli annunci nativi, aggiorna la classe della visualizzazione di annuncio nativo:

<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />

<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />

Configurare le dipendenze per entrambe le configurazioni

Se il tuo progetto deve supportare sia Google Mobile Ads SDK sia 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 build.gradle dell'app di esempio.