Anzeigenprüftool deaktivieren

Sie können das Anzeigenprüftool verwenden, um das Anzeigenverhalten während der Entwicklung, beim Testen und bei der Fehlerbehebung zu prüfen. Wenn das Tool aktiviert ist, kann dies jedoch die Arbeitsspeichernutzung erhöhen. Möglicherweise möchten Sie das Anzeigenprüftool während der Leistungsprofilierung und Speicherprüfung deaktivieren. Mit dieser Funktion wird dafür gesorgt, dass das Anzeigenprüftool nicht ausgeführt wird und die Leistungsmessungen Ihrer App nicht beeinträchtigt.

Wenn Sie das Anzeigenprüftool deaktivieren, wird verhindert, dass das Tool die Arbeitsspeichernutzung erhöht oder über Gesten, das Debug-Menü oder Methodenaufrufe gestartet wird. Sie können das Anzeigenprüftool während Leistungstests im Testmodus deaktivieren. In der Produktion ist das Anzeigenprüftool immer deaktiviert und hat keine Auswirkungen auf die Leistung Ihrer App.

In dieser Anleitung wird beschrieben, wie Sie das Anzeigenprüftool deaktivieren und die Deaktivierung bestätigen.

Vorbereitung

Führen Sie die folgenden Schritte aus, bevor Sie fortfahren:

• Richten Sie GMA Next-Gen SDK ein.
• Verwenden Sie GMA Next-Gen SDK Version 1.3.0 oder höher.

Mit Build-Typen deaktivieren

Wenn Sie das Anzeigenprüftool in Debug-Builds verfügbar halten, aber in Profiling-Builds deaktivieren möchten, verwalten Sie die Einstellung für die Build-Konfiguration mit Gradle-Build-Typen und Manifest-Platzhaltern. Gehen Sie folgendermaßen vor:

1. Definieren Sie manifestPlaceholders-Attribute in Ihrer Gradle-Build-Datei.

2. Weisen Sie jedem Build-Typ Werte zu. Im folgenden Beispiel wird der Schlüssel disableAdInspector definiert und ein profile-Build-Typ erstellt, der vom release-Build-Typ abgeleitet wird. Außerdem wird der Schlüsselwert für Profil-Builds auf true und für Debug- und Release-Builds auf false festgelegt.

   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. Verweisen Sie in der Manifestdatei Ihrer App auf die Platzhaltervariable. Im folgenden Beispiel wird der Platzhalter disableAdInspector verwendet, den Sie im vorherigen Schritt definiert haben.

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

Deaktivierung bestätigen

Wenn Sie versuchen, das Anzeigenprüftool zu öffnen, während es in der Datei AndroidManifest.xml deaktiviert ist, wird in Logcat die folgende Meldung angezeigt:

Ad inspector is disabled in the AndroidManifest.xml.

Wenn Sie die Methode MobileAds.openAdInspector aufrufen, wird im Callback ein AdInspectorError-Objekt zurückgegeben, das die App darüber informiert, dass das Anzeigenprüftool nicht geöffnet werden kann:

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