المتطلبات
- 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
كل شيء جاهز! تابع إلى تتبع الأخطاء لإرسال أخطاء مخصّصة، أو إلى الإشعارات لتفعيل الإشعارات.