Désactiver l'inspecteur d'annonces

Bien que vous puissiez utiliser l'inspecteur d'annonces pour examiner le comportement des annonces lors du développement, des tests et du dépannage, cet outil peut augmenter l'utilisation de la mémoire lorsqu'il est activé. Vous pouvez désactiver l'inspecteur d'annonces lors du profilage des performances et de la vérification de la mémoire. Cette fonctionnalité permet de s'assurer que l'outil d'inspection d'annonces ne s'exécute pas et n'interfère pas avec les mesures de performances de votre application.

La désactivation de l'inspecteur d'annonces empêche l'outil d'augmenter l'utilisation de la mémoire ou de se lancer par le biais de gestes, du menu de débogage ou d'appels de méthode. Vous pouvez désactiver l'inspecteur d'annonces lors des tests de performances en mode test. En production, l'inspecteur d'annonces est toujours désactivé et n'a aucune incidence sur les performances de votre application.

Ce guide explique comment désactiver l'inspecteur d'annonces et vérifier que la désactivation a bien été effectuée.

Prérequis

Avant de continuer, procédez comme suit :

• Configurer GMA Next-Gen SDK
• Utilisez la version 1.3.0 ou ultérieure de GMA Next-Gen SDK.

Désactivation avec les types de compilation

Pour que l'inspecteur d'annonces reste disponible dans les builds de débogage tout en désactivant l'outil dans les builds de profilage, gérez le paramètre de configuration de compilation à l'aide des types de compilation Gradle et des espaces réservés du fichier manifeste. Procédez comme suit :

1. Définissez les propriétés manifestPlaceholders dans votre fichier de compilation Gradle.

2. Attribuez des valeurs à chaque type de compilation. L'exemple suivant définit la clé disableAdInspector et crée un type de compilation profile qui hérite du type de compilation release. Cet exemple définit également la valeur de la clé sur true pour les builds de profil et sur false pour les builds de débogage et de version.

   Kotlin

   android {
       buildTypes {
           getByName("debug") {
               manifestPlaceholders["disableAdInspector"] = "false"
           }
           getByName("release") {
               optimization {
                   enable = false
               }
               manifestPlaceholders["disableAdInspector"] = "false"
           }
           create("profile") {
               initWith(getByName("release"))
               manifestPlaceholders["disableAdInspector"] = "true"
           }
       }
   }

   Groovy

   android {
       buildTypes {
           release {
               manifestPlaceholders = [disableAdInspector: "false"]
           }
           debug {
               manifestPlaceholders = [disableAdInspector: "false"]
           }
           create("profile") {
               initWith(getByName("release"))
               manifestPlaceholders = [disableAdInspector: "true"]
           }
       }
   }

3. Faites référence à la variable de l'espace réservé dans le fichier manifeste de votre application. L'exemple suivant utilise l'espace réservé disableAdInspector que vous avez défini à l'étape précédente.

   <application>
   <!-- Dynamically enable or disable ad inspector based on build type -->
   <meta-data
       android:name=
       "com.google.android.libraries.ads.mobile.sdk.flag.DISABLE_AD_INSPECTOR"
       android:value="${disableAdInspector}" />
   </application>
   

Vérifier la désactivation

Lorsque vous essayez d'ouvrir l'inspecteur d'annonces alors qu'il est désactivé dans le fichier AndroidManifest.xml, le message suivant s'affiche dans Logcat :

Ad inspector is disabled in the AndroidManifest.xml.

L'appel de la méthode MobileAds.openAdInspector renvoie un objet AdInspectorError dans le rappel, ce qui indique à l'application que l'inspecteur d'annonces ne peut pas s'ouvrir :

Ad inspector cannot be opened because it is disabled in the AndroidManifest.xml.