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

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

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

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

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

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

• إعداد GMA Next-Gen SDK
• استخدِم الإصدار 1.3.0 أو إصدارًا أحدث من 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.