الإبلاغ عن الأخطاء وتتبُّعها (original) (raw)
يمكنك المساعدة في تحسين Android من خلال الإبلاغ عن المشاكل وطلب ميزات جديدة باستخدام أداة تتبُّع المشاكل من Google. Google Issue Tracker هي أداة تستخدمها Google لتتبُّع المشاكل وطلبات الميزات في AOSP. تتوفّر أداة "تعقُّب المشاكل" خارج Google ليستخدمها المستخدمون الخارجيون من الجمهور والشركاء الذين يحتاجون إلى التعاون مع فِرق Google بشأن مشاكل وميزات معيّنة.
للتعرّف على أساسيات "أداة تتبُّع المشاكل في Google"، يمكنك الاطّلاع على أداة تتبُّع المشاكل في Google.
الإبلاغ عن خطأ
للإبلاغ عن خطأ في AOSP، اتّبِع الخطوات التالية:
- باستخدامجميع الأخطاء المفتوحة كأساس لعملية البحث، استخدِم حقل البحث في "أداة تتبُّع المشاكل" لمعرفة ما إذا كان أحد المستخدمين قد أبلغ عن مشكلتك أو طلب الميزة التي تريدها. لا تنسَ البحث أيضًا عن الأخطاء التي تم إغلاقها وإصلاحها. لمساعدتك في العثور على النتائج الأكثر شيوعًا، رتِّب النتائج حسب عدد النجوم. للحصول على تفاصيل حول استخدام حقل البحث، يُرجى الرجوع إلىعمليات البحث عن المشاكل.
- إذا عثرت على مشكلتك وكانت مهمة بالنسبة إليك،ميّزها بنجمة. يساعد عدد النجوم في تحديد أولوية المشكلة.
- إذا لم يبلّغ أحد عن مشكلتك، أنشئ خطأً جديدًا.
- يُرجى الرجوع إلى القسم من هذا المستند الذي يتعلّق بالمكوّن الذي يتضمّن الخطأ. تحدّد مكوّنات الخطأ البرمجي الجزء من نظام التشغيل Android الذي ينطبق عليه الخطأ.
- إذا كان الخطأ مرتبطًا بالأمان، يُرجى الرجوع إلى الأمان.
- إذا كانت المشكلة مرتبطة بنظام التشغيل AOSP، يُرجى الرجوع إلى النظام الأساسي.
- إذا كانت المشكلة مرتبطة بأدوات المطوّرين، يُرجى الرجوع إلى أدوات المطوّرين في Android.
- إذا كان الخطأ يشير إلى مستندات غير صحيحة، يُرجى الرجوع إلىالمستندات.
- املأ النموذج المتوفّر:
- إذا كانت المشكلة عبارة عن خطأ، يجب تضمين خطوات إعادة إنتاج الخطأ في التعليقات. من المحتمل أن يتطلّب التعليق الذي يذكر فقط أنّ شيئًا ما لا يعمل توفير معلومات إضافية. كلما قدّمت تفاصيل أكثر، بما في ذلك ملفات السجلّ وحتى مجموعة تصحيحات، ساعد ذلك Google في حلّ مشكلتك.
- إذا كانت المشكلة عبارة عن طلب ميزة، يُرجى تقديم تفاصيل واضحة حول الميزة المقترَحة، بما في ذلك المشكلة التي تحلّها واعتبارات التصميم.
- انقر على إنشاء. يتم إنشاء تقرير الخطأ لكي تراجعه Google.
- يُرجى الرجوع إلى القسم من هذا المستند الذي يتعلّق بالمكوّن الذي يتضمّن الخطأ. تحدّد مكوّنات الخطأ البرمجي الجزء من نظام التشغيل 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) إلى أن تقدّم المعلومات المطلوبة. بعد فترة من الوقت، إذا لم يتم تقديم أي معلومات إضافية، يتم منح الخطأ حالة تشير إلى أنّه لن يتم اتخاذ أي إجراء بشأنه.
- يتم تعيين الخطأ إلى مستخدم، ويمكن إعادة ترتيب أولويته اختياريًا. تم الاعتراف بتقرير الخطأ على أنّه تقرير مفصّل بشكل كافٍ عن مشكلة صحيحة. يتم تحديد أولوية الخطأ بشكل صحيح أو إعادة تحديدها. أخيرًا، يتم تعيين الخطأ إلى مساهم معيّن لتقييمه وتحليله.
عادةً، تظل حالة الخطأ تم التعيين إلى أن يقرّر أحد الأشخاص حلّ الخطأ، وعندها يتم تعيين الحالة تم القبول. ومع ذلك، قد لا يغيّر المسؤول حالة الخطأ إلى تم القبول، بل يكتفي بإصلاح الخطأ وتعيين الحالة تم الإصلاح أو تم الإصلاح (تم التحقّق). - لن يتم اتّخاذ أي إجراء بشأن الخطأ. يتم تصنيف الخطأ ضمن هذه الفئة لعدة أسباب، مثل أن يكون الخطأ نسخة مكررة من خطأ آخر، أو أن يكون من غير الممكن إصلاح الخطأ، أو أن يمثّل الخطأ وظيفة تعمل على النحو المنشود.
لتتبُّع حالة الخطأ، اتّبِع الخطوات التالية:
- افتح الخطأ وانظر إلى حقول الأولوية والحالة والتعليقات. للحصول على توضيحات بشأن الأولوية والحالة، يُرجى الرجوع إلى حقول المشاكل.
- (اختياري) الردّ على أي أسئلة أو تعليقات في حقل التعليقات
يتم تضمين الأخطاء التي تحمل الحالة تم الإصلاح (تم التحقّق) في إصدار مستقبلي من Android.
معلومات إضافية عن حالات محدّدة
في ما يلي شرح إضافي لبعض حالات الأخطاء (بالإضافة إلى المعلومات المقدَّمة في مستندات حقول المشاكل في "أداة تتبُّع المشاكل"):
- لن يتم إصلاحها (السلوك المقصود): حدّد أحد المسؤولين عن صيانة AOSP أنّ السلوك الموصوف ليس خطأً، بل هو السلوك المقصود. يُشار إلى هذه الحالة أيضًا باسم "تعمل على النحو المنشود". بالنسبة إلى طلبات الميزات، تبيّن لأحد المسؤولين عن صيانة AOSP أنّه لن يتم تنفيذ الطلب في Android.
- لن يتم حلّ المشكلة (غير ممكن): التغييرات المطلوبة لمعالجة المشكلة غير ممكنة بشكل معقول. يتم استخدام هذه الحالة أيضًا للمشاكل التي تم الإبلاغ عنها والتي لا يمكن التعامل معها في AOSP، وعادةً ما يكون ذلك لأنّها مرتبطة بجهاز معدَّل أو بتطبيق خارجي، أو لأنّ المُبلِغ أخطأ في فهم وظيفة "أداة تتبُّع المشاكل" وظنّها منتدى للمساعدة.
- تم الإصلاح (تم التحقّق): تم إصلاح هذا الخطأ، وهو مضمّن في إصدار رسمي.
- تم الإصلاح: تم إصلاح هذا الخطأ (أو تنفيذ الميزة) في شجرة مصدر، ولكن قد لا يكون مضمّنًا بعد في إصدار رسمي.