Pour adopter les améliorations de latence et de stabilité d'Android, utilisez GMA Next-Gen SDK. Ce guide explique comment configurer Google Mobile Ads Flutter Plugin pour utiliser GMA Next-Gen SDK pour Android.
Prérequis
Avant de continuer, procédez comme suit :
- Installez Google Mobile Ads Flutter Plugin version 9.0.0 ou ultérieure.
- Configurez Google Mobile Ads Flutter Plugin.
- Disposer d'un projet Flutter.
Configurer les paramètres Android Gradle
Pour utiliser GMA Next-Gen SDK sur Android, vous devez mettre à jour vos configurations Gradle :
- Définissez les niveaux d'API Android minimal et de compilation.
- Si vous utilisez la médiation, suivez la procédure de migration pour exclure les modules
com.google.android.gmsafin d'éviter les erreurs de classe en double.
Exécuter avec une déclaration d'environnement
Pour utiliser GMA Next-Gen SDK lors de la compilation et de l'exécution de votre application Android, vous devez fournir la déclaration d'environnement USE_NEXT_GEN_SDK définie sur la valeur true.
Chaque fois que vous compilez ou exécutez votre application, exécutez la commande suivante :
flutter run --dart-define USE_NEXT_GEN_SDK=true
Exécuter avec la configuration de l'IDE
Si vous exécutez votre application à l'aide d'un environnement de développement intégré (IDE), vous pouvez configurer vos déclarations d'environnement dans votre configuration de lancement au lieu de transmettre l'option à l'aide de la ligne de commande.
Par exemple, vous pouvez définir ces variables dans un fichier JSON et les ajouter à la configuration de votre IDE. Pour en savoir plus, consultez Spécifier des déclarations d'environnement.
Mettre à jour les modèles d'annonces natives
Si vous utilisez des modèles d'annonces natives, effectuez les mises à jour suivantes pour prendre en charge GMA Next-Gen SDK :
Mettre à jour l'importation du package NativeAdFactory
Pour Android, mettez à jour l'instruction d'importation de 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
Mettre à jour les vues XML de la mise en page de l'annonce native
Dans les fichiers XML de mise en page de vos annonces natives, mettez à jour la classe de vue d'annonce native :
<!-- Replace this element: -->
<com.google.android.gms.ads.nativead.NativeAdView ... />
<!-- With this element: -->
<com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdView ... />
Configurer les dépendances pour les deux configurations
Si votre projet doit être compatible avec Google Mobile Ads SDK (Legacy) et GMA Next-Gen SDK, vous pouvez configurer votre fichier android/app/build.gradle pour définir des dépendances de manière conditionnelle en fonction de la déclaration d'environnement.
Google Mobile Ads Flutter Plugin fournit un exemple de configuration dans le fichier build.gradle de l'exemple d'application.