كيفية تقديم تقارير الأخطاء الرائعة – اكتشف

الأخطاء هي جزء لا مفر منه من عملية التطوير. على الرغم من أنها قد تكون محبطة عند مواجهتها، إلا أنه يمكنك المساعدة في القضاء على هذه الأنواع من المشكلات بسرعة عن طريق تحديد المشكلة التي تواجهها، وإعادة إنتاجها، وتقديم تقرير بالأخطاء من خلال مساعد الملاحظات من Apple.

تعرف على المزيد حول الإبلاغ عن الأخطاء

تعرف على المزيد حول سياسة الخصوصية الخاصة بنا عند تقديم الأخطاء باستخدام Feedback Assistant

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

كن واضحًا ومباشرًا ومفصلاً

عند تسجيل أي تقرير خطأ جديد، كن وصفيًا قدر الإمكان، بدءًا من عنوان يصف بوضوح المشكلة والعامل المسبب لها. يترك عنوان مثل “أحداث التقويم مفقودة” معلومات مهمة مثل كيف أو لماذا، بينما عنوان مثل “أحداث التقويم على macOS 12.4 مفقودة بعد إنشاء حدث سريع” يوفر المزيد من التفاصيل القابلة للتنفيذ.

نصيحة: غالبًا ما يكون من المفيد لفاحصي الأخطاء فهم كيفية تأثير المشكلات على تطوير التطبيق. إذا حددت مشكلة أثناء تطوير تطبيقك، فقم بتضمين اسم التطبيق وإصداره في كل من حقل العنوان والوصف — حتى إذا كان بإمكانك إعادة إنتاج المشكلة في نموذج مشروع مستقل — وأضف رابطًا إلى سجل متجر التطبيقات الخاص بك أو بناء اختبار الطيران.

عند كتابة مشكلتك، قم بوصف كل خطوة بدقة – غالبًا ما يكون من المفيد التظاهر بأن من يقرأ تقريرك لم يسبق له أن واجه التطبيق أو النظام الذي تكتب عنه. على سبيل المثال، عبارة مثل “عندما أقوم بإنشاء حدث في التقويم، فإنه يختفي في لحظة” تحذف العديد من التفاصيل الضرورية لإعادة إظهار المشكلة. هل تقوم بإنشاء حدث في التقويم من خلال زر “الحدث السريع”، أو من خلال Siri، أم أنك تقوم بالسحب لإضافة حدث جديد؟ كم هي لحظة؟ هل اختفى الحدث بعد تعدد المهام أم أنك بقيت في التطبيق؟

عندما يتعين على أداة فحص الأخطاء التوقف مؤقتًا والنظر في هذا النوع من الأسئلة، فإن ذلك يقلل من احتمالية إصلاح مشكلتك بسرعة. بدلاً من ذلك، فكر في كيفية وصف الخلل الخاص بك بالتفصيل. على سبيل المثال، يمكنك كتابة:

1. Click Quick Event button in the Calendar app. 
2. Fill out an event with any title. 
3. Hit Return.

Actual Results: The event appears in the right place in my calendar but then disappears.

Expected Results: The Calendar event should appear and stay on my calendar.

بعد أن تقوم بملء خطوات التكاثر والنتيجة المتوقعة، ضع في اعتبارك أي عوامل إضافية يمكن أن تؤثر على المشكلة. هل قمت بتسجيل الدخول إلى iCloud؟ هل قمت بتشغيل أي إعدادات إمكانية الوصول؟ هل يمكنك تكرار المشكلة في مكان آخر في نظام التشغيل؟ كلما قمت بتضمين المزيد من المعلومات في التقرير الأولي، كلما تمكنت أداة الفحص من فرزها بشكل فعال ونقلها إلى الفريق المناسب لإصلاحها بشكل أسرع.

أضف بعض العناصر المرئية

يمكن أن توفر لقطة الشاشة أو تسجيل الشاشة للخلل المعاد إنتاجه أدلة قيمة – وقد تتضمن تفاصيل ربما لم تفكر في كتابتها في حقل الوصف. إذا كانت لديك مشكلة مع واجهة المستخدم، فيجب عليك دائمًا تضمين العناصر المرئية.

تسجيل الحادث

لسوء الحظ، ليست كل الأخطاء قابلة للتكرار أو لها خطوات سهلة المتابعة. بالنسبة لهذه الحالات الأكثر صعوبة، فكر في توفير معلومات التسجيل مثل تشخيص النظام؛ إذا كنت تقوم بالإبلاغ عن خطأ على iPhone أو iPad، فيمكنك استخدام تطبيق Feedback Assistant لالتقاط الخطأ تلقائيًا. إذا كنت تقوم بالحفظ من خلال بوابة ويب Apple، فيمكنك تثبيت ملفات التعريف لمساعدتك في جمع تشخيص النظام يدويًا.

يمكنك أيضًا تقديم أي تسجيل إضافي ذي صلة بالمشكلة. على سبيل المثال، إذا كنت تواجه عطلًا، قم بتضمين سجلات الأعطال الخاصة بتطبيقك. إذا كنت تقوم بالإبلاغ عن تراجع في الأداء، فقم بتضمين تتبع الأدوات على iOS أو iPadOS، أو نموذج على macOS.

إنشاء مشروع عينة

هل تواجه مشكلة أثناء تطوير التطبيق؟ فكر في عزل المشكلة إلى نموذج مشروع صغير أو مشروع Swift Playgrounds الذي يتم تجميعه. لا يمكن أن يساعدك ذلك في تضييق نطاق الأخطاء المحددة التي تواجهها فحسب، بل إنها أيضًا إحدى أسهل الطرق التي يستخدمها فاحصو الأخطاء والمهندسون لفرز المشكلة. إذا لم تتمكن من إنتاج نموذج مشروع كامل، فإن نموذج التعليمات البرمجية يكون مفيدًا أيضًا — وجميع المعلومات الإضافية التي يمكن أن تساعد في تضييق نطاق المشكلة تعتبر ذات قيمة.

تصعيد التقرير الخاص بك

إذا كنت عضوًا مدفوع الأجر في برنامج Apple Developer أو برنامج Enterprise أو برنامج MFi وتواجه مشكلة فنية مع إحدى منصات Apple في إصدار إنتاجي، ففكر في تقديم حادث دعم فني. هذا طلب للحصول على دعم على مستوى التعليمات البرمجية لأطر عمل Apple وواجهات برمجة التطبيقات والأدوات عندما لا تتمكن من إصلاح خطأ ما، أو تواجه مشكلة عند تنفيذ تقنية معينة، أو لديك أسئلة عامة حول التعليمات البرمجية الخاصة بك.

طلب الدعم الفني