عن المشروع

## حزمة SDK لبرنامج Unity Engine الخاص بـ Aptabase تقوم هذه الحزمة بتجهيز مشاريع Unity Engine مع Aptabase، وهو منصة تحليلات مفتوحة المصدر تعتمد على الخصوصية-first للتطبيقات المحمولة وتطبيقات سطح المكتب والتطبيقات الويب. ### التثبيت ثبت عبر Unity Package Manager بإضافة عنوان URL النجمي https://github.com/aptabase/aptabase-unity.git من خلال القائمة Window > Package Manager > Add Package from git URL. ### التكوين بعد الحصول على App Key من Aptabase، اضبطه في `Aptabase/Resources/AptabaseSettings.Asset`. يتم اختيار Host تلقائياً بناءً على المفتاح؛ في حالات النشر الذاتي يظهر حقل `SelfHostURL`. المفاتيح التي تبدأ بـ `A-DEV-*` تستهدف نسخة Aptabase المحلية على العنوان `https://localhost:3000`. الإعدادات اختيارية تشمل تجاوز إصدار التطبيق (`AppVersion`)، وتحديد رقم البناء الخاص بالمنصة (`AppBuildNumber`)، وتعديل فاصل تباعد الإرسال (`FlushInterval`)، وتمكين الإبلاغ التلقائي عن الانهيارات (`EnableCrashReporting`). ### تتبع الأحداث يتم تسجيل الأحداث عبر `Aptabase.TrackEvent()` ضمن مساحة الاسم `AptabaseSDK`. تقبل الخصائص المخصصة فقط النصوص والأرقام. تُجمع الأحداث وترسل كل 60 ثانية في الإنتاج أو كل ثانيتين في التطوير. يتوفر التصريف اليدوي عبر `Aptabase.Flush()`. تزود الحزمة الأحداث تلقائياً ببيانات النظام التشغيلي وإصدار التطبيق وغيرها من البيانات الوصفية. لا يتم تتبع أي أحداث تلقائياً — يجب أن يكون جميع التسجيل يدوياً. ### تتبع الأخطاء (نسخة تجريبية) استخدم `Aptabase.TrackError(ex)` للاستثناءات المعالجة و`Aptabase.TrackError(ex, fatal: true)` للأخطاء غير القابلة للاسترداد. مع تمكين `EnableCrashReporting`، تبلغ الحزمة تلقائياً عن: - الاستثناءات الملتقطة من استدعاءات MonoBehaviour وCoroutines و`Debug.LogException` بصنف `unhandled` - استثناءات إنهاء العملية بصنف `crash` مع شدة `fatal` - استثناءات المهام غير المرصودة بصنف `taskException` تشمل كل تقرير نوع الاستثناء والرسالة وتتبع المكدس والشدة وطريقة الالتقاط. تصل التقارير إلى 100 خطأ فريد لكل جلسة. لا يتم التقاط انهيارات Native. ### ميزات إضافية - مستمع استجابة عبر `SetResponseListener()` لأكواد حالة HTTP - تمكين/تعطيل الـ SDK عبر `SetEnabled()` - إرشادات نموذج خصوصية متجر Apple App Store مقدمة