停用廣告檢查器

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

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

本指南說明如何停用廣告檢查器，以及如何驗證停用狀態。

必要條件

繼續操作前，請先完成下列步驟：

• 設定 GMA Next-Gen SDK。
• 使用 GMA Next-Gen SDK 1.3.0 以上版本。

停用 (有建構類型)

如要在停用剖析建構作業中的工具時，讓廣告檢查器在偵錯建構作業中保持可用，請使用 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.