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