Overview
متى تحتاج إلى ذلك؟
إذا تعطل Primuse أو توقف عن الاستجابة أو تخطّى مقاطع أثناء الفحص أو تعذّر عليه الاتصال بمصدر موسيقى أو انقطع التشغيل، فإن المطوّر يحتاج عادةً إلى سجلّ اللحظة التي حدثت فيها المشكلة. تبقى معلومات التشخيص على جهازك ولا تُرسل تلقائيًا أبدًا؛ لا تغادر الجهاز إلا عندما ترسلها بنفسك.
قبل أن تبدأ
- تحقّق من إصدار التطبيق: يعرض الإعدادات ← نبذة كلًّا من النسخة والبناء. اذكرهما في بلاغك.
- يتطلب الرفع اتصالًا بالإنترنت. يمكن لكل جهاز الرفع حتى 5 مرات يوميًا، وألا تتجاوز كل حزمة 8 ميغابايت.
الخطوة 1: فعّل وضع التشخيص (موصى به)
- افتح الإعدادات ← نبذة ← «التقارير التشخيصية».
- Mac: الإعدادات ← نبذة ← «سجلات التشخيص...»، ثم انقر «التقارير التشخيصية» في النافذة التي تُفتح.
- Apple TV: افتح «التقارير التشخيصية» في الإعدادات.
- شغّل «تسجيل سجلات مفصلة». خلال الـ24 ساعة التالية يسجّل التطبيق تفاصيل إضافية لاستكشاف الأخطاء، ثم يوقف الخيار تلقائيًا.
- كرّر المشكلة (مثل إعادة الفحص أو تشغيل المقطع مجددًا أو إعادة الاتصال بالمصدر)، ودوّن الوقت التقريبي.
ما حدث قبل تفعيل الوضع موجود في السجل الأساسي فقط وقد لا يكون مفصّلًا بما يكفي، لذا من الأفضل تكرار المشكلة مرة واحدة والوضع مفعّل.
الخطوة 2: ارفعها إلى المطوّر
- في شاشة «التقارير التشخيصية»، اضغط «إرسال إلى المطوّر» في شريط الأدوات.
- ضمن «المرفقات (اختياري)» اختر ما تريد إرفاقه: «التقارير التشخيصية» (تقارير الأعطال والتجمّد وبيانات الأداء) و«السجلات».
- يمكنك إضافة لقطات شاشة في «الصور (اختياري)» (حتى 6، تُصغّر تلقائيًا)، وأن تصف في حقل «طلبات أو اقتراحات» ما كنت تفعله وما توقعته وما حدث فعلًا ومتى تقريبًا.
- اضغط «الرفع إلى المطوّر» في الأسفل. ستظهر بالتتابع «جارٍ التجهيز…» و«جارٍ الرفع …%» و«جارٍ التأكيد…».
- عندما تظهر «تم الرفع إلى المطوّر»، اضغط «نسخ الرمز» واذكر الرمز في بلاغك على GitHub أو في رسالة البريد.
النتيجة المتوقعة: يظهر رمز التقرير على الشاشة. بعد نجاح الرفع تُحذف التقارير والسجلات المرفوعة من الجهاز.
لا توجد تقارير أعطال من النظام على Apple TV، لذا يُرفع السجل ورسالتك فقط؛ وبعد ظهور الرمز يمكنك الضغط على «إرسال تقرير آخر» لإرسال المزيد.
إذا تعذّر الرفع: البريد أو المشاركة
- أسفل زر الرفع يوجد «الإرسال بالبريد الإلكتروني بدلًا من ذلك» أو «المشاركة بدلًا من ذلك». تُرفق التقارير أو السجلات المختارة بالرسالة، وتراجعها قبل الإرسال.
- إذا كانت خدمة الرفع غير متاحة، فلن يظهر زر الرفع؛ بل يظهر في شريط الأدوات «فتح البريد» أو «مشاركة» مع عنوان بريد المطوّر.
- لا يتوفر الرفع في الإصدارات الأقدم من 1.12.2؛ استخدم «إرسال إلى المطوّر» للإرسال بالبريد أو عبر المشاركة.
مشاركة تقرير واحد
اضغط على تقرير في شاشة «التقارير التشخيصية» لمشاركته وحده. على Mac، يعرض زر «سجلات التصدير» ملف السجل في Finder.
معاني الخيارات
| الخيار | المعنى |
|---|---|
| تقارير الأعطال والتوقف | تقارير يتركها النظام بعد تعطّل التطبيق أو تجمّده طويلًا؛ تظهر عادةً بعد فتح التطبيق مرة أخرى |
| مقاييس التشغيل | بيانات أداء يقدّمها النظام دوريًا، مثل ذروة استهلاك الذاكرة وأسباب الإنهاء |
| السجلات | سجلّ التطبيق الخاص بالتشغيل والفحص والمزامنة مؤخرًا؛ يُضمَّن الجزء الأحدث فقط عند الرفع والمشاركة |
| تسجيل سجلات مفصلة | يسجّل تفاصيل أكثر لمدة 24 ساعة ثم يتوقف |
| مسح السجلات | يحذف السجلات من هذا الجهاز؛ لا يمكن التراجع عنه |
الخصوصية
تحتوي السجلات على أسماء المقاطع ومسارات الملفات؛ وتُستبدل عناوين مصادر الموسيقى وحساباتها بتسميات قصيرة. تُزال كلمات المرور والرموز المميزة وبيانات الاعتماد الأخرى قبل الكتابة. يُستخدم ما يُرفع لاستكشاف الأخطاء فقط، ويُحذف من خادم المطوّر بعد 30 يومًا (أو قبل ذلك إذا ضاقت المساحة). يمكنك قبل الإرسال إلغاء تحديد «السجلات» أو عدم إرفاق لقطات الشاشة.
القيود
- لا يتجاوز الرفع الواحد 8 ميغابايت بعد التحزيم؛ 5 مرات رفع يوميًا لكل جهاز، وتُحتسب المحاولات غير المكتملة أيضًا.
- تُحفظ التقارير والسجلات على الجهاز نحو 7 أيام.
- لا توجد تقارير أعطال أو تجمّد على Apple TV؛ ولا توجد شاشة تشخيص على Apple Watch، لذا أبلغ من جهاز iPhone المقترن.