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 جميع البيانات الأخرى (حالات الإعلانات، والإعدادات، وبيانات الجلسات) داخليًا.