غیرفعال کردن بازرس آگهی

درحالی‌که می‌توانید از بازرس آگهی برای بازرسی رفتار آگهی درطول توسعه، آزمایش، و عیب‌یابی استفاده کنید، این ابزار ممکن است هنگام فعال بودن، استفاده از حافظه را افزایش دهد. شاید بخواهید بازرس آگهی را درطول نمایه‌سازی عملکرد و بررسی حافظه غیرفعال کنید. این ویژگی تضمین می‌کند که بازرس آگهی اجرا نشود و در اندازه‌گیری‌های عملکرد برنامه‌تان تداخل ایجاد نکند.

غیرفعال کردن بازرس آگهی مانع از افزایش استفاده از حافظه توسط این ابزار یا راه‌اندازی آن ازطریق اشاره‌ها، منو اشکال‌زدایی، یا فراخوانی‌های روش می‌شود. می‌توانید بازرس آگهی را درحین آزمایش عملکرد در حالت آزمایشی غیرفعال کنید. در دسته هدف، بازرس آگهی همیشه غیرفعال است و بر عملکرد برنامه‌تان تأثیری نمی‌گذارد.

این راهنما شامل غیرفعال کردن بازرس آگهی و تأیید غیرفعال‌سازی است.

پیش‌نیازها

پیش‌از ادامه دادن، موارد زیر را تکمیل کنید:

غیرفعال کردن با انواع ساخت

برای اینکه بازرس آگهی در ساخت‌های اشکال‌زدایی دردسترس باشد و درعین‌حال این ابزار در ساخت‌های نمایه‌سازی غیرفعال باشد، تنظیمات پیکربندی ساخت را بااستفاده از انواع ساخت Gradle و جای‌بان‌های مانیفست مدیریت کنید. مراحل زیر را تکمیل کنید:

  1. ویژگی‌های manifestPlaceholders را در فایل ساخت Gradle تعریف کنید.

  2. برای هر نوع ساخت، مقادیری اختصاص دهید. مثال زیر کلید disableAdInspector را تعریف می‌کند و نوع ساخت profile را ایجاد می‌کند که از نوع ساخت release ارث‌بری می‌کند. این مثال همچنین مقدار کلید را روی 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.