停用广告检查器

请选择平台： Android iOS

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

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

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

前提条件

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

• 设置 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.