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

يمكنك المساعدة في تحسين 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 الأساسي، يمكنك إرسال الخطأ من خلال النقر على رمز الخطأ بجانب منطقة المكوّن المعني :

تصفُّح جميع المشاكل في النظام الأساسي

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

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

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

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

المستندات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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