Désactiver l'inspecteur d'annonces

Bien que vous puissiez utiliser l'inspecteur d'annonces pour inspecter le comportement des annonces pendant le développement, les tests et le dépannage, l'outil peut augmenter l'utilisation de la mémoire lorsqu'il est activé. Vous pouvez désactiver l'inspecteur d'annonces pendant le profilage des performances et la vérification de la mémoire. Cette fonctionnalité garantit qu'Inspecteur d'annonces ne s'exécute pas et n'interfère pas avec les mesures des 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 via des gestes, le menu de débogage ou des appels de méthode. Vous pouvez désactiver l'inspecteur d'annonces lorsque vous effectuez 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 la désactivation.

Prérequis

Avant de continuer, procédez comme suit :

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

Désactiver avec les types de compilation

Pour que l'inspecteur d'annonces reste disponible dans les versions de débogage tout en désactivant l'outil dans les versions 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 pour chaque type de build. 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 publication.

   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. Référencez la variable d'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, informant 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.