Skip to main content

المتطلبات

  • Flutter >=3.0.0
  • Dart >=3.0.0

متطلبات iOS

  • جهاز يعمل بـ iOS 12+‎ أو iPadOS 12+‎، أو محاكي Xcode يعمل بـ iOS 16.2+‎
  • Swift Package Manager (يتطلب تفعيلاً يدوياً) أو CocoaPods 1.16.2+‎

متطلبات Android

  • جهاز أو محاكي Android 7.0+‎ مع تثبيت خدمات Google Play

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

أضف atelerix إلى ملف pubspec.yaml:
pubspec.yaml
ثم نفّذ:

2. هيّئ الـ SDK

استدعِ Atelerix.init() في أقرب وقت ممكن — يُفضّل في بداية main() داخل main.dart. التهيئة تُعِدّ مراقبة الأخطاء والإبلاغ عنها فقط. هي لا تُهيّئ الإشعارات؛ استدعِ Atelerix.notifications.init() بشكل منفصل عند الحاجة لتلك الوحدة.
main.dart
ستجد مفتاح الـ API ومعرّف المشروع في لوحة تحكم Atelerix ضمن إعدادات المشروع (Project Settings).

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

التهيئة غير المتزامنة (Async)

إذا احتاج builder إلى إعداد غير متزامن قبل runApp()، استدعِ WidgetsFlutterBinding.ensureInitialized() أولاً:
main.dart

وضع التصحيح (Debug mode)

فعّل debugMode: true أثناء التطوير لطباعة سجلّات الـ SDK في الـ console:
main.dart

معالج أخطاء مخصّص

استخدم onError لتشغيل منطقك الخاص عند التقاط الـ SDK لخطأ — مثلاً لعرض واجهة بديلة أو تسجيله في خدمة أخرى:
main.dart

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

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