停用廣告檢查器

您可以在開發、測試和疑難排解期間,使用廣告檢查器檢查廣告行為,但啟用這項工具可能會增加記憶體用量。在進行效能剖析和記憶體檢查時,建議您停用廣告檢查器。這項功能可確保廣告檢查器不會執行,也不會干擾應用程式的成效評估。

停用廣告檢查器後,該工具就不會增加記憶體用量,也無法透過手勢、偵錯選單或方法呼叫啟動。在測試模式下進行效能測試時,您可以停用廣告檢查器。在正式版中,廣告檢查器一律會停用,不會影響應用程式效能。

本指南說明如何停用廣告檢查器,以及確認是否已停用。

必要條件

繼續操作前,請先完成下列事項:

使用建構類型停用

如要在偵錯版本中保留廣告檢查器,但在分析版本中停用該工具,請使用 Gradle 建構類型和資訊清單預留位置,管理建構設定。操作步驟如下:

  1. 在 Gradle 建構檔案中定義 manifestPlaceholders 屬性。

  2. 為每個建構類型指派值。以下範例定義了 disableAdInspector 鍵,並建立繼承 release 建構類型的 profile 建構類型。這個範例也會將設定檔建構作業的索引鍵值設為 true,並將偵錯和發布建構作業的值設為 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.