停用广告检查器

虽然您可以在开发、测试和问题排查期间使用广告检查器检查广告行为，但启用该工具可能会增加内存用量。在进行性能分析和内存检查期间，您可能需要停用广告检查器。此功能可确保广告检查器不会运行，也不会干扰应用的效果衡量。

停用广告检查器可防止该工具通过手势、调试菜单或方法调用来增加内存用量或启动。在测试模式下进行性能测试时，您可以停用广告检查器。在正式版中，广告检查器始终处于停用状态，不会影响应用的性能。

本指南介绍了如何停用广告检查器以及如何验证停用操作。

前提条件

在继续之前，请完成以下操作：

• 设置 GMA Next-Gen SDK。
• 使用 GMA Next-Gen SDK 1.3.0 版或更高版本。

按 build 类型停用

如需在调试 build 中保留广告检查器，同时在分析 build 中停用该工具，请使用 Gradle build 类型和清单占位符管理 build 配置设置。 请完成以下步骤：

1. 在 Gradle build 文件中定义 manifestPlaceholders 属性。

2. 为每种 build 类型分配值。以下示例定义了键 disableAdInspector，并创建了继承自 release build 类型的 profile build 类型。此示例还为分析 build 将键值设置为 true，为调试 build 和发布 build 将键值设置为 false。

   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. 在应用的清单文件中引用占位变量。以下示例使用您在上一步中定义的 disableAdInspector 占位符。

   <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>
   

验证停用情况

当您尝试打开广告检查器，但该检查器在 AndroidManifest.xml 文件中处于停用状态时，您会在 Logcat 中看到以下消息：

Ad inspector is disabled in the AndroidManifest.xml.

调用 MobileAds.openAdInspector 方法会在回调中返回一个 AdInspectorError 对象，通知应用广告检查器无法打开：

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