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

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

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

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

پیش‌نیازها

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

• ‫GMA Next-Gen SDK را راه‌اندازی کنید.
• از GMA Next-Gen SDK نسخه ۱.۳.۰ یا بالاتر استفاده کنید.

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

برای اینکه بازرس آگهی در ساخت‌های اشکال‌زدایی دردسترس باشد و درعین‌حال این ابزار در ساخت‌های نمایه‌سازی غیرفعال باشد، تنظیم پیکربندی ساخت را بااستفاده از انواع ساخت 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.