Anzeigenprüftool deaktivieren

Mit dem Anzeigenprüftool können Sie das Anzeigenverhalten während der Entwicklung, des Testens und der Fehlerbehebung prüfen. Wenn das Tool aktiviert ist, kann sich jedoch die Speichernutzung erhöhen. Es empfiehlt sich, das Anzeigenprüftool während der Leistungsprofilerstellung und der Speicherprüfung zu deaktivieren. So wird verhindert, dass das Anzeigenprüftool ausgeführt wird und die Leistungsmessungen Ihrer App beeinträchtigt.

Wenn Sie das Anzeigenprüftool deaktivieren, kann es die Speichernutzung nicht erhöhen oder über Touch-Gesten, das Debug-Menü oder Methodenaufrufe gestartet werden. Sie können das Anzeigenprüftool während der Leistungstests im Testmodus deaktivieren. In der Produktion ist das Anzeigenprüftool immer deaktiviert und hat keinen Einfluss auf die Leistung Ihrer App.

In diesem Leitfaden wird beschrieben, wie Sie das Anzeigenprüftool deaktivieren und die Deaktivierung überprüfen.

Vorbereitung

Bevor Sie fortfahren, müssen Sie Folgendes tun:

Mit Build-Typen deaktivieren

Wenn Sie das Anzeigenprüftool in Debug-Builds verfügbar halten, aber in Profiling-Builds deaktivieren möchten, können Sie die Build-Konfigurationseinstellung mithilfe von Gradle-Build-Typen und Manifest-Platzhaltern verwalten. Gehen Sie folgendermaßen vor:

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

  2. Weisen Sie jedem Build-Typ Werte zu. Im folgenden Beispiel wird der Schlüssel disableAdInspector definiert und ein Build-Typ profile erstellt, der vom Build-Typ release erbt. In diesem Beispiel 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 prüfen

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.