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

يُرسَل كل سطر سجل يُنتجه AKS — سواء من استدعاءات AKSLogManager/AppsKitSDKLogManager، أو أحداث تحميل الإعلانات وعرضها، أو الأنشطة الداخلية لـ SDK — إلى وجهتين في الوقت نفسه: Logcat، مع وسم بحسب الفئة، ومُجمِّع السجلات في الذاكرة الذي يزوّد شاشة AKS Logs في §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 Logs ضمن مجموعة الاختبارات (§10) — فهي تعرض أسطر السجل نفسها تمامًا على الجهاز، مع إمكانية البحث داخل الشاشة، ليتمكّن المختبِر من تصفّحها أو البحث فيها مباشرةً، أو إرسال لقطة شاشة منها إليك.

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