Skip to main content

المتطلبات

  • Android 7.0+‎ (API 24)
  • Kotlin 1.9+‎، Android Gradle Plugin 8.5+‎
هذه هي المكتبة الأصلية (native) بلغة Kotlin للتطبيقات التي لا تستخدم Flutter إطلاقاً. إذا كان تطبيقك مبنياً بـ Flutter، استخدم Flutter SDK بدلاً من ذلك — فهو يغطّي iOS وAndroid وWeb من حزمة واحدة.

1. أضف الاعتمادية (Dependency)

يُوزَّع الـ SDK عبر JitPack، ويُبنى مباشرة من إصدارات GitHub. أضف مستودع JitPack في ملف settings.gradle.kts:
settings.gradle.kts
ثم أضف الاعتمادية في ملف build.gradle.kts الخاص بتطبيقك:
build.gradle.kts
استبدل 1.0.0 بالإصدار الذي تريد الاعتماد عليه — راجع صفحة الإصدارات للاطّلاع على الإصدارات المتاحة.

2. هيّئ الـ SDK

استدعِ Lerix.initialize() في أقرب وقت ممكن — من دالة Application.onCreate() مخصّصة. هذا يسجّل تطبيقك/جهازك مع الخادم (backend) ويفعّل الإبلاغ التلقائي عن الأعطال (crash reporting).
LerixExampleApp.kt
سجّل الصنف (class) في ملف AndroidManifest.xml الخاص بك:
AndroidManifest.xml
ستجد مفتاح الـ API ومعرّف المشروع في لوحة تحكم Lerix ضمن إعدادات المشروع (Project Settings).

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

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

أرسل خطأً تجريبياً للتأكّد من أن كل شيء يعمل:
ثم افتح لوحة التحكم — يجب أن يظهر الخطأ خلال ثوانٍ.
كل شيء جاهز! تابع إلى تتبع الأخطاء لإرسال أخطاء مخصّصة وتفعيل الإبلاغ التلقائي عن الأعطال، أو إلى الإشعارات لتفعيل الإشعارات.