الإبلاغ عن الأخطاء وتتبُّعها

يمكنك المساعدة في تحسين Android من خلال الإبلاغ عن المشاكل وطلب ميزات جديدة باستخدام أداة تتبُّع المشاكل من Google. ‫Google Issue Tracker هي أداة تستخدمها Google لتتبُّع المشاكل وطلبات الميزات في AOSP. تتوفّر أداة "تعقُّب المشاكل" خارج Google ليستخدمها المستخدمون الخارجيون من الجمهور والشركاء الذين يحتاجون إلى التعاون مع فِرق Google بشأن مشاكل وميزات معيّنة.

للتعرّف على أساسيات "أداة تتبُّع المشاكل في Google"، يمكنك الاطّلاع على أداة تتبُّع المشاكل في Google.

ملاحظة: لا تستخدِم أداة "متتبّع المشاكل في Google" إلا للإبلاغ عن خطأ في AOSP أو لطلب ميزة في AOSP. إذا كنت بحاجة إلى مساعدة فورية بشأن AOSP أو هواتف Android أو تطوير تطبيقات Android أو مشاكل أخرى غير متعلّقة بـ AOSP، يُرجى الرجوع إلى منتدى Android وجهات الاتصال.

الإبلاغ عن خطأ

للإبلاغ عن خطأ في AOSP، اتّبِع الخطوات التالية:

1. باستخدام جميع الأخطاء المفتوحة كأساس لعملية البحث، استخدِم حقل البحث في "أداة تتبُّع المشاكل" لمعرفة ما إذا كان أحد المستخدمين قد أبلغ عن مشكلتك أو طلب الميزة التي تريدها. لا تنسَ البحث أيضًا عن الأخطاء التي تم إغلاقها وإصلاحها. لمساعدتك في العثور على النتائج الأكثر شيوعًا، رتِّب النتائج حسب عدد النجوم. للحصول على تفاصيل حول استخدام حقل البحث، يُرجى الرجوع إلى عمليات البحث عن المشاكل.
2. إذا عثرت على مشكلتك وكانت مهمة بالنسبة إليك، ميّزها بنجمة. يساعد عدد النجوم في تحديد أولوية المشكلة.

3. إذا لم يبلّغ أحد عن مشكلتك، أنشئ خطأً جديدًا.

   1. يُرجى الرجوع إلى القسم من هذا المستند الذي يتعلّق بالمكوّن الذي يتضمّن الخطأ. تحدّد مكوّنات الخطأ البرمجي الجزء من Android الذي ينطبق عليه الخطأ.

      • إذا كان الخطأ مرتبطًا بالأمان، يُرجى الرجوع إلى الأمان.
      • إذا كانت المشكلة مرتبطة بنظام التشغيل AOSP، يُرجى الرجوع إلى النظام الأساسي.
      • إذا كانت المشكلة مرتبطة بأدوات المطوّرين، يُرجى الرجوع إلى أدوات المطوّرين في Android.
      • إذا كان الخطأ يشير إلى مستندات غير صحيحة، يُرجى الرجوع إلى المستندات.

   2. املأ النموذج المتوفّر:

      • إذا كانت المشكلة عبارة عن خطأ، يجب تضمين خطوات إعادة إنتاج الخطأ في التعليقات. من المحتمل أن يتطلّب التعليق الذي يذكر فقط أنّ شيئًا ما لا يعمل توفير معلومات إضافية. كلما قدّمت تفاصيل أكثر، بما في ذلك ملفات السجلّ وحتى مجموعة تصحيحات، ساعد ذلك Google في حلّ مشكلتك.
      • إذا كانت المشكلة عبارة عن طلب ميزة، يُرجى تقديم تفاصيل واضحة حول الميزة المقترَحة، بما في ذلك المشكلة التي تحلّها واعتبارات التصميم.

   3. انقر على إنشاء. يتم إنشاء تقرير الخطأ لكي تراجعه Google.

ملاحظة: عند الإبلاغ عن خطأ جديد في AOSP، تأكَّد من أنّ المكوّن يندرج ضمن أداة تتبُّع المشاكل العامة في Android.

للتعرّف على كيفية تتبُّع حالة الخطأ، يُرجى الرجوع إلى تتبُّع حالة الخطأ.

مكوّنات الأخطاء

تم تصميم الأقسام الأربعة التالية لمساعدتك في البحث عن الأخطاء والإبلاغ عنها باستخدام المكوّن الصحيح.

الأمان

إذا عثرت على مشكلة تؤثر في أمان Android أو المكوّنات في أجهزة Pixel، يُرجى الإبلاغ عن الخطأ باتّباع التعليمات الواردة في مقالة الإبلاغ عن مشاكل الأمان. بالإضافة إلى ذلك، تكون أخطاء الأمان مؤهَّلة للانضمام إلى برنامج مكافآت Android وأجهزة Google.

النظام الأساسي

إذا كانت لديك مشكلة أو طلب ميزة يؤثران في أحد جوانب منصة Android، يمكنك تسجيل الخطأ من خلال النقر على رمز الخطأ بجانب منطقة المكوّن ذي الصلة:

تصفُّح جميع مشاكل المنصة

تصفُّح الأخطاء	الإبلاغ عن خطأ
تسهيل الاستخدام
ART
المتصفّح
CTS
Framework
الرسومات
نواة (GKI)
16 كيلوبايت
الوسائط
التطبيقات الفورية
Libcore
التواصل
النظام
صورة النظام العامة
Text
الأشياء
Wear

أدوات مطوّري تطبيقات Android

إذا كانت لديك مشكلة أو طلب ميزة يؤثر في أحد جوانب أدوات مطوّري تطبيقات Android، يمكنك الإبلاغ عن الخطأ من خلال النقر على رمز الخطأ بجانب منطقة المكوّن المعني في الجدول التالي.

ملاحظة: بما أنّ الأدوات لها متطلبات مختلفة، يُرجى قراءة تفاصيل إرسال التقارير العامة عن الأخطاء والتفاصيل المرتبطة بالأداة.

تصفُّح جميع المشاكل في "أدوات المطوّرين"

تصفُّح الأخطاء	التفاصيل	الإبلاغ عن خطأ
adb
استوديو Android	معلومات خاصة بأخطاء "استوديو Android"
C++‎	مشاكل في "استوديو Android"
المحاكي أو صور النظام	معلومات خاصة بأخطاء المحاكي
Gradle	المعلومات الخاصة بأخطاء Gradle
تطبيق التغييرات	معلومات خاصة بأخطاء ميزة "تطبيق التغييرات"
Lint
NDK	مشاكل في نظام الإنشاء أو برنامج التحويل البرمجي في NDK لا يمكن استخدامها لطلبات البيانات من واجهة برمجة التطبيقات أو الإبلاغ عن الأخطاء. تُعد واجهات برمجة التطبيقات جزءًا من نظام التشغيل، ويجب تقديم الطلبات ذات الصلة بها في أحد مكونات "النظام الأساسي" السابقة (إذا كنت لا تعرف أيّها، استخدِم "إطار العمل").
أدوات تحليل الأداء
Jetpack (androidx)
اختبار Jetpack (androidx)
حزمة تطوير البرامج (SDK) للألعاب

المستندات

إذا كانت لديك مشكلة أو طلب ميزة يؤثران في أحد جوانب مستندات Android، يمكنك تسجيل الخطأ من خلال النقر على رمز الخطأ بجانب منطقة المكوّن ذات الصلة:

تصفُّح الأخطاء	الإبلاغ عن خطأ
developer.android.com (مستندات مطوّر التطبيق)
source.android.com (مستندات AOSP)

طلب إمكانية التشغيل التفاعلي في منطقة السوق المحددة

إذا أردت إرسال طلب بشأن إمكانية التشغيل التفاعلي بموجب قانون الأسواق الرقمية على Android، استخدِم منطقة المكوّن ذات الصلة:

تقديم طلب	تصفُّح الطلبات
إنشاء طلب عام جديد	الطلبات العلنية
إنشاء طلب خاص جديد

طلب خلاصة المحتوى بموجب "قانون الأسواق الرقمية" على هواتف Pixel

في المنطقة الاقتصادية الأوروبية (EEA)، يعرض هاتف Pixel شاشات اختيار محرك البحث على الإنترنت (OSE) بموجب "قانون الأسواق الرقمية"، ما يتيح للمستخدمين اختيار محرك البحث المفضّل لديهم. إذا اختار المستخدم مزوّد خدمة معيّنًا في شاشة اختيار OSE، يمكن لمزوّد الخدمة هذا اختيار عرض خلاصة المحتوى الخاصة به على شاشة Pixel التي تظهر عندما يمرّر المستخدمون سريعًا لليسار من الشاشة الرئيسية لهاتف Pixel.

إذا كنت موفّرًا يشارك في شاشة اختيار نظام التشغيل الافتراضي (OSE) بموجب قانون الأسواق الرقمية (DMA) في أي دولة عضو وكنت مهتمًا بعرض المحتوى الخاص بك على الشاشة -1 في هواتف Pixel، يُرجى إبلاغنا عن خطأ للتواصل معنا:

إنشاء طلب خاص جديد

تتبُّع حالة الخطأ

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

• تحتاج إلى مزيد من المعلومات. لا يتضمّن تقرير الخطأ معلومات كافية لتحديد أولويته أو تحليله بشكل صحيح. يتم وضع تقرير الخطأ في قائمة (New + Hotlist:NeedsInfo) إلى أن تقدّم المعلومات المطلوبة. بعد فترة من الوقت، إذا لم يتم تقديم أي معلومات إضافية، يتم منح الخطأ حالة تشير إلى أنّه لن يتم اتخاذ أي إجراء بشأنه.

• يتم تعيين الخطأ إلى مستخدم، ويمكن إعادة ترتيب أولويته اختياريًا. تم الاعتراف بتقرير الخطأ على أنّه تقرير مفصّل بشكل كافٍ عن مشكلة صحيحة. يتم تحديد أولوية الخطأ بشكل صحيح أو إعادة تحديدها. أخيرًا، يتم تعيين الخطأ إلى مساهم معيّن لتقييمه وتحليله.

  عادةً، تظل حالة الخطأ تم التعيين إلى أن يقرّر أحد الأشخاص حلّ الخطأ، وعندها يتم تعيين الحالة تم القبول. ومع ذلك، قد لا يغيّر المسؤول حالة الخطأ إلى تم القبول، بل يكتفي بإصلاح الخطأ وتعيين الحالة تم الإصلاح أو تم الإصلاح (تم التحقّق).

• لن يتم اتّخاذ أي إجراء بشأن الخطأ. يتم تصنيف الخطأ ضمن هذه الفئة لعدة أسباب، مثل أن يكون الخطأ نسخة مكررة من خطأ آخر، أو أن يكون من غير الممكن إصلاح الخطأ، أو أن يمثّل الخطأ وظيفة تعمل على النحو المنشود.

ملاحظة: تمثّل هذه العملية عملية نموذجية لأخطاء AOSP. قد يختلف مسار تقدّم الخطأ خلال الحالات المختلفة قليلاً.

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

لتتبُّع حالة الخطأ، اتّبِع الخطوات التالية:

1. افتح الخطأ وانظر إلى حقول الأولوية والحالة والتعليقات. للحصول على توضيحات بشأن الأولوية والحالة، يُرجى الرجوع إلى حقول المشاكل.
2. (اختياري) الردّ على أي أسئلة أو تعليقات في حقل التعليقات

يتم تضمين الأخطاء التي تحمل الحالة تم الإصلاح (تم التحقّق) في إصدار مستقبلي من Android.

معلومات إضافية عن حالات محدّدة

في ما يلي شرح إضافي لبعض حالات الأخطاء (بالإضافة إلى المعلومات المقدَّمة في مستندات حقول المشاكل في "أداة تتبُّع المشاكل"):

• لن يتم إصلاحها (السلوك المقصود): حدّد أحد المسؤولين عن صيانة AOSP أنّ السلوك الموصوف ليس خطأً، بل هو السلوك المقصود. يُشار إلى هذه الحالة أيضًا باسم "تعمل على النحو المنشود". بالنسبة إلى طلبات الميزات، تبيّن لأحد المسؤولين عن صيانة AOSP أنّه لن يتم تنفيذ الطلب في Android.

• لن يتم حلّ المشكلة (غير ممكن): التغييرات المطلوبة لمعالجة المشكلة غير ممكنة بشكل معقول. يتم استخدام هذه الحالة أيضًا للمشاكل التي تم الإبلاغ عنها والتي لا يمكن التعامل معها في AOSP، وعادةً ما يكون ذلك لأنّها مرتبطة بجهاز معدَّل أو بتطبيق خارجي، أو لأنّ المُبلِغ أخطأ في فهم وظيفة "أداة تتبُّع المشاكل" وظنّها منتدى للمساعدة.

• تم الإصلاح (تم التحقّق): تم إصلاح هذا الخطأ، وهو مضمّن في إصدار رسمي.

• تم الإصلاح: تم إصلاح هذا الخطأ (أو تنفيذ الميزة) في شجرة مصدر، ولكن قد لا يكون مضمّنًا بعد في إصدار رسمي.