على الرغم من إمكانية استخدام "أداة فحص الإعلانات" لفحص سلوك الإعلانات أثناء التطوير والاختبار وتحديد المشاكل وحلّها، قد تؤدي الأداة إلى زيادة استخدام الذاكرة عند تفعيلها. ننصحك بإيقاف "أداة فحص الإعلانات" أثناء تحديد مستوى الأداء والتحقّق من الذاكرة. تضمن هذه الميزة عدم تشغيل أداة فحص الإعلانات وعدم تداخله مع قياسات أداء تطبيقك.
يؤدي إيقاف "أداة فحص الإعلانات" إلى منع الأداة من زيادة استخدام الذاكرة أو تشغيلها من خلال الإيماءات أو قائمة تصحيح الأخطاء أو استدعاءات الطرق. يمكنك إيقاف "أداة فحص الإعلانات" أثناء اختبار الأداء في "الوضع التجريبي". في مرحلة الإنتاج، تكون "أداة فحص الإعلانات" غير مفعّلة دائمًا ولا تؤثّر في أداء تطبيقك.
يتناول هذا الدليل كيفية إيقاف "أداة فحص الإعلانات" والتأكّد من إيقافها.
المتطلبات الأساسية
قبل المتابعة، أكمل ما يلي:
- إعداد GMA Next-Gen SDK
- استخدام الإصدار 1.3.0 أو إصدار أحدث من GMA Next-Gen SDK
الإيقاف باستخدام أنواع الإصدارات
لإبقاء أداة فحص الإعلانات متاحة في إصدارات تصحيح الأخطاء مع إيقاف الأداة في إصدارات إنشاء الملفات الشخصية، عليك إدارة إعدادات التصميم باستخدام أنواع إصدارات Gradle وعناصر نائب في ملف البيان. أكمِل الخطوات التالية:
حدِّد سمات
manifestPlaceholdersفي ملف تصميم Gradle.تعيين قيم لكل نوع تصميم يوضّح المثال التالي كيفية تحديد المفتاح
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"] } } }
أشِر إلى المتغيّر النائب في ملف بيان تطبيقك. يستخدم المثال التالي العنصر النائب
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.