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

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

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

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

للإبلاغ عن خطأ في AOSP، يُرجى اتّباع الخطوات التالية:

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

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

    1. راجِع قسم هذا المستند ذا الصلة بالمكوّن الذي يرتبط بخطأك. تحدِّد مكوّنات الخطأ الجزء من نظام التشغيل Android الذي ينطبق عليه الخطأ.

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

    2. املأ النموذج المقدَّم:

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

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

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

مكونات الخطأ

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

الأمان

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

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

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

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

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

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

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

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

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

المستندات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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