إيقاف "أداة فحص الإعلانات"

اختيار النظام الأساسي: Android iOS

على الرغم من إمكانية استخدام "أداة فحص الإعلانات" لفحص سلوك الإعلانات أثناء التطوير والاختبار وتحديد المشاكل وحلّها، قد تؤدي الأداة إلى زيادة استخدام الذاكرة عند تفعيلها. ننصحك بإيقاف "أداة فحص الإعلانات" أثناء تحديد مستوى الأداء والتحقّق من الذاكرة. تضمن هذه الميزة عدم تشغيل أداة فحص الإعلانات وعدم تداخله مع قياسات أداء تطبيقك.

يؤدي إيقاف "أداة فحص الإعلانات" إلى منع الأداة من زيادة استخدام الذاكرة أو تشغيلها من خلال الإيماءات أو قائمة تصحيح الأخطاء أو استدعاءات الطرق. يمكنك إيقاف "أداة فحص الإعلانات" أثناء اختبار الأداء في "الوضع التجريبي". في مرحلة الإنتاج، تكون "أداة فحص الإعلانات" غير مفعّلة دائمًا ولا تؤثّر في أداء تطبيقك.

يتناول هذا الدليل كيفية إيقاف "أداة فحص الإعلانات" والتأكّد من إيقافها.

المتطلبات الأساسية

قبل المتابعة، أكمل ما يلي:

الإيقاف باستخدام أنواع الإصدارات

لإبقاء أداة فحص الإعلانات متاحة في إصدارات تصحيح الأخطاء مع إيقاف الأداة في إصدارات إنشاء الملفات الشخصية، عليك إدارة إعدادات التصميم باستخدام أنواع إصدارات 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.