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

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

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

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

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

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

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

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