التوثيق · التكامل مع Android

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

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

تصفية Logcat

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

bash

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) أسرع طريقة للتحقّق من إصدار AKS AAR المُدمَج فعليًا عندما تشتبه في عدم تطابق الإصدارات — إذ يطبع رسالة الإصدار في PTB_LOG.

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