الانتقال إلى المحتوى الرئيسي

مقدمة

يلتقط Lerix الأخطاء والأعطال من تطبيق Android الأصلي (native) الخاص بك لتتمكّن من تصحيح المشاكل بشكل أسرع. بعد إتمام تثبيت Android، استخدم Lerix.throwError لإرسال أخطاء مخصّصة أو استثناءات ملتقطة إلى لوحة التحكم — أما الأعطال غير الملتقطة فتُلتقط تلقائياً، دون الحاجة لأي كود إضافي.
تأكّد من تهيئة الـ SDK عبر Lerix.initialize() قبل الإبلاغ عن الأخطاء.

الإبلاغ عن خطأ

استخدم Lerix.throwError للإبلاغ عن خطأ يدوياً. هذا مفيد عندما تلتقط استثناءً بنفسك وتريد إرساله إلى Lerix مع سياق إضافي.

المعاملات (Parameters)

قيم BugType

قيم BugSeverity

الالتقاط التلقائي للأعطال

يُثبّت Lerix.initialize() معالج أعطال (crash handler) تلقائياً، يلفّ الدالة العامة Thread.setDefaultUncaughtExceptionHandler في Java/Kotlin — أي استثناء غير ملتقط على أي خيط (thread) يُلتقط، بغضّ النظر عن الخيط الذي حدث فيه. لا يمكن للعطل إجراء استدعاء شبكة بشكل موثوق — فالعملية (process) تكون بصدد الإنهاء — لذا يُكتب التقرير إلى القرص بشكل متزامن (synchronous) لحظة العطل، ثم يُرسَل تلقائياً في المرة التالية لتشغيل تطبيقك، مصنَّفاً كـ type: CRASH, severity: CRITICAL. لا تحتاج لفعل أي شيء لاستلامه؛ سيظهر في لوحة التحكم عند التشغيل التالي. لتعطيل هذه الميزة (مثلاً إذا كان تطبيقك يملك بالفعل نظام تتبع أعطال خاصاً به وتريد فقط استدعاءات throwError اليدوية):

تحقّق من التكامل

أرسل خطأً تجريبياً للتأكّد من أن كل شيء يعمل:
ثم افتح لوحة التحكم — يجب أن يظهر الخطأ خلال ثوانٍ.

ترشيح الأخطاء

يتطلّب الـ SDK الخاص بـ Android بالإصدار 1.2.0 أو أحدث. احذف الأخطاء المزعجة أو نظّف البيانات قبل أن تغادر الجهاز. ينطبق الترشيح على كل خطأ يرسله الـ SDK: Lerix.throwError والأعطال غير الملتقطة (يُفحص العطل عند إرساله في التشغيل التالي).
  • تعمل ignoreErrors (List<String>) وignoreErrorPatterns (List<Regex>) أولاً. تُتجاوَز عناصر ignoreErrors الفارغة أو التي تحتوي مسافات فقط.
  • ثم تستقبل beforeSend كائن LerixErrorEvent بالحقول message وstack وtype وseverity وmetadata. أعِده (معدّلاً أو كما هو) لإرساله، أو أعِد null لحذفه. تُستدعى على خيط (thread) في الخلفية.
  • إذا رمت beforeSend استثناءً، يُرسَل الحدث الأصلي ويُبتلَع الاستثناء (ويُسجَّل في debugMode).
  • الرسالة التي تطابقها هي عنوان المشكلة، وتتضمّن صنف الخطأ.
كما يجمّع Lerix الأخطاء المتكرّرة في مشكلة واحدة ويرشّح الضوضاء الشائعة على الخادم، لكل إصدارات الـ SDK. راجع كيف تُجمَّع الأخطاء في مشكلات.