10. لوحة الإعدادات / مجموعة الاختبارات المدمجة

يتضمن AKS شاشة تشخيص مبنية باستخدام Compose، ولا تتطلب نسخة منفصلة لتصحيح الأخطاء أو إدخالًا في ملف manifest؛ إذ تظهر كمربع حوار بملء الشاشة فوق أي Activity تفتحها منها. وهي مفيدة للتحقق من الحالة التي يرصدها AKS (الإعدادات عن بُعد، وحالات الإعلانات، والموافقة) دون توصيل أداة تصحيح الأخطاء.

فتح الشاشة

استدعِ ما يلي من أي موضع يتوفر فيه مرجع إلى Activity، سواء من صف مخفي في شاشة إعدادات تطبيقك، أو عبر الضغط المطوّل على رقم إصدار التطبيق، أو من زر مخصص لتصحيح الأخطاء فقط، أو بأي آلية تشغيل تضيفها (لا يضيف AKS آلية تشغيل نيابةً عنك):

AppsKitSDK.showGodModeScreen(PlatformActivity(this))

يفتح هذا الاستدعاء لوحة إعدادات AKS، التي تتيح لك الاطلاع على ما يلي:

• تفعيل الإعلانات — مفتاح تبديل، وحالة GDPR — قيمة للقراءة فقط، إما TRUE أو FALSE، تعكس نتيجة AdsManager.isUserConsentsProvided().
• التحقق من الإعدادات — يفتح مجموعة الاختبارات نفسها (انظر أدناه).
• استدعاءات مواضع الإعلانات — تفريغ JSON منسّق لنشاط استدعاءات الإعلانات لكل موضع.
• إحصاءات تحميل مواضع الإعلانات — عدّادات محاولات التحميل ونجاحها وفشلها لكل موضع.
• سجلات AKS — سجل الأحداث المتراكم نفسه الذي تطّلع عليه عادةً عبر Logcat (انظر §11)، مع إمكانية البحث فيه على الشاشة.

مجموعة الاختبارات

يؤدي النقر على التحقق من الإعدادات إلى فتح شاشة مجموعة الاختبارات، التي تعرض: مؤشرات وضع الاختبار ووضع التطوير، وما إذا كانت الإعدادات الافتراضية (دون اتصال) أو الإعدادات المجلوبة عن بُعد هي النشطة حاليًا، وإصدار AKS SDK، وبيانات JSON الخام للإعدادات التي جلبها AKS عن بُعد، والحالة الآنية ووقت آخر عرض لكل من الإعلانات البينية وإعلانات المكافآت وإعلانات فتح التطبيق، بالإضافة إلى العدد الحالي للجلسات والأيام.

يمكنك أيضًا الانتقال إليها مباشرةً دون المرور بلوحة الإعدادات:

AppsKitSDK.showAKSTestSuit(PlatformActivity(activity))

لا يتطلب أيٌّ من الاستدعاءين سوى PlatformActivity؛ إذ يقرأ AKS سائر البيانات (حالات الإعلانات، والإعدادات، وبيانات الجلسات) داخليًا.