11. تصحيح الأخطاء باستخدام سجلات AKS (PTB_LOG)

كل سطر سجل يُنتجه AKS — سواء من استدعاءات AKSLogManager/AppsKitSDKLogManager أو أحداث تحميل الإعلانات وعرضها أو النشاط الداخلي لـ SDK — يُرسل إلى وجهتين في الوقت نفسه: Logcat، مع وسم بحسب الفئة، ومُجمِّع السجلات في الذاكرة الذي تعتمد عليه شاشة سجلات AKS في §10.

تصفية Logcat

يمكنك التصفية بحسب الوسم في Logcat ضمن Android Studio (tag:PTB_LOG) أو عبر adb:

adb logcat -s PTB_LOG:* PTB_LOG_ADS:* PTB_LOG_ANALYTICS:*

• PTB_LOG — سجلات SDK العامة (تسلسل التهيئة، رسائل توضيح الوضع، دورة الحياة، الأخطاء)
• PTB_LOG_ADS — دورة حياة تحميل الإعلانات وعرضها لكل أشكال الإعلانات
• PTB_LOG_ANALYTICS — الأحداث المُرسلة إلى Firebase ومنصات قياس أداء التسويق عبر الأجهزة المحمولة (MMPs)، بما في ذلك كل استدعاء لـ sendAKSEvent/AKSLogManager.log من §7

قراءة السجلات دون Logcat

إذا كنت تُصحّح أخطاء نسخة إصدار، أو تعمل على جهاز أحد المختبِرين، أو تتعامل مع تذكرة دعم لا يمكن فيها الاتصال عبر adb، فافتح بدلًا من ذلك شاشة سجلات AKS ضمن مجموعة أدوات الاختبار (§10) — فهي تعرض سطور السجل نفسها تمامًا على الجهاز، مع إمكانية البحث داخل الشاشة، ليتمكن المختبِر من تصفّح السجلات والبحث فيها مباشرةً أو إرسال لقطة شاشة إليك.

يُعدّ AppsKitSDKLogManager.logAarVersion() (راجع §7.3) أسرع طريقة للتأكد من إصدار AAR الخاص بـ AKS المُدمج فعليًا عندما تشكّ في وجود عدم تطابق في الإصدارات — فهو يطبع رسالة توضيح الإصدار في PTB_LOG.