سجلات الأعطال

نظرة عامة

تُعد سجلات الأعطال أدوات تشخيصية قيّمة تساعد المطورين على تحديد وإصلاح المشكلات والأخطاء التي تتسبب في تعطل التطبيق أو سلوكه بشكل غير متوقع. من الممكن مشاركة السجلات من جهاز Android الخاص بك مع فريق تطوير OsmAnd. حاليًا، يتوفر لمستخدمي iOS خيار واحد فقط من نوع سجل الأعطال لإرساله.

سجلات الأعطال وسجلات التطبيق

يتيح لك OsmAnd إرسال نوعين من البيانات إلى المطورين:

• سجلات الأعطال. يتم إنشاؤها عندما يواجه تطبيق OsmAnd خطأً حرجًا أو استثناءً يتسبب في تعطله. توفر هذه السجلات معلومات مفصلة حول حالة التطبيق أثناء الفشل، بما في ذلك بيانات البناء، وتتبع المكدس، ورسائل الخطأ، وتفاصيل أخرى ذات صلة.
• سجلات الجلسة/التطبيق الحالية. سجل لتدفق سجل OsmAnd يلتقط أحداثًا ورسائل مختلفة. تساعد هذه السجلات المطورين على مراقبة سلوك التطبيق، وتتبع تدفق التنفيذ، وتتبع إجراءات محددة، والتحقيق في المشكلات غير المتعلقة بالتعطل. تحتوي سجلات Logcat عادةً على سجلات للنشاط من وقت آخر بدء للتطبيق.

معلوماتك الخاصة

كن حذرًا عند إرسال سجلات التطبيق، حيث قد تحتوي على معلومات خاصة مثل موقع الجهاز، واستعلامات البحث، ونتائج بناء المسار، وبيانات التنقل.

إرسال السجلات من تطبيق OsmAnd

Android

iOS

1. انتقل إلى القائمة → مساعدة → إرسال سجل الأعطال أو إرسال سجل السجلات (إرسال سجل التطبيق الحالي على iOS). بناءً على حالتك، حدد نوع السجل المناسب. يمكنك الرجوع إلى قسم سجلات الأعطال وسجلات التطبيق للحصول على تفاصيل حول الاختلافات بين أنواع السجلات.
2. في القائمة المنبثقة، اختر Gmail أو تطبيق البريد الإلكتروني المفضل لديك. نوصي بإرسال السجلات إلى support@osmand.net.
3. اضغط على زر إرسال.

إرسال ملفات Tombstone (أندرويد)

حاسم

للمستخدمين المتقدمين فقط!

في بعض الحالات المعقدة أو غير العادية، قد تكون ملفات Tombstone مطلوبة. توفر هذه الملفات تتبعًا تفصيليًا للمكدس لجميع الخيوط في عملية متعطلة (وليس فقط الخيط الذي تسبب في الخطأ)، وخريطة ذاكرة كاملة، وقائمة بجميع واصفات الملفات المفتوحة. تعد ملفات Tombstone حيوية لتصحيح الأخطاء وتشخيص المشكلات المتعلقة بالرمز الأصلي على نظام Android الأساسي.

استخدام جهازك

لتصدير ملفات tombstone، تحتاج إلى إنشاء تقرير خطأ باستخدام إعدادات نظام Android:

1. تمكين خيارات المطور (هذه الشاشة مخفية افتراضيًا).

   • انتقل إلى الإعدادات → حول الهاتف → معلومات البرنامج (هذا المسار صالح لأجهزة Samsung).
   • اضغط على رقم البناء سبع مرات حتى يؤكد إشعار منبثق أن وضع المطور نشط.

2. انتقل إلى خيارات المطور، والتي توجد عادةً في أسفل قائمة الإعدادات. يمكنك أيضًا استخدام وظيفة البحث.

   • اضغط على خيار أخذ تقرير خطأ.
   • حدد نوع تقرير الخطأ واضغط على تقرير.

بعد أن يصبح تقرير الخطأ جاهزًا، ستتلقى إشعارًا. اضغط على مربع الإشعار لتنزيل التقرير على جهازك. قم بفك ضغط الملف وأرسل ملفات tombstone إلى فريق مطوري OsmAnd (البريد الإلكتروني: support@osmand.net).

note

يرجى ملاحظة أن تقارير الأخطاء قد تحتوي على بيانات خاصة، بما في ذلك استخدام التطبيق أو الموقع.

استخدام ADB

Android Debugging Bridge (ADB) هي أداة سطر أوامر تتيح للمطورين تصحيح أخطاء تطبيقاتهم. لاستخدام ADB لتصدير ملفات tombstone، ستحتاج إلى تنزيلها وتثبيتها أولاً. اتبع التعليمات المتوفرة على الموقع الرسمي لمطوري Android.

إعداد جهازك

تأكد من تمكين خيارات المطور (هذه الشاشة مخفية افتراضيًا) وتشغيل تصحيح أخطاء USB:

• انتقل إلى الإعدادات → حول الهاتف → معلومات البرنامج.
• اضغط على رقم البناء سبع مرات حتى يؤكد إشعار منبثق أن وضع المطور نشط.
• في خيارات المطور، قم بتمكين تصحيح أخطاء USB.

ثم، قم بتوصيل جهازك بمحطة العمل الخاصة بك عبر USB. إذا كانت هذه هي المرة الأولى التي تقوم فيها بالاتصال، فستظهر نافذة منبثقة تطلب الإذن بالسماح بالتصحيح.

إنشاء تقرير خطأ

1. افتح نافذة طرفية لسطر الأوامر. على Mac أو Linux، استخدم تطبيق Terminal، وعلى Windows، استخدم Command Line.
2. انتقل إلى مجلد platform-tools حيث يوجد ADB باستخدام الأمر cd (على سبيل المثال، 'cd /Users/Username/Downloads/Tools').
3. أنشئ تقرير الخطأ:
   • على Mac: adb bugreport
   • على Windows: adb.exe bugreport
4. انتظر بضع دقائق حتى يتم إنشاء التقرير. سيتم حفظ الملف الناتج في مجلد أدوات النظام الأساسي.
5. قم بفك ضغط الملف.
6. ابحث عن مجلد tombstones الذي يحتوي على ملفات مثل tombstone_00، tombstone_01، وما شابه ذلك.
7. أرسل ملفات tombstone إلى support@osmand.net.

استخدام الأجهزة ذات صلاحيات الروت أو محاكي Android Studio

• مع صلاحيات الروت على جهازك، يمكنك فتح مجلد /data/tombstones مباشرة.

• في Android Studio، استخدم المحاكي للانتقال إلى مستكشف ملفات الجهاز وابحث عن مجلد /data/tombstones. ستجد بالداخل ملفات بأسماء مثل tombstone_00، tombstone_01، وغيرها. قم بتنزيل هذه الملفات وأرسلها إلى support@osmand.net.

لمزيد من التفاصيل حول تقارير الأخطاء، ارجع إلى وثائق Android.