يمكنك المساعدة في تحسين Android من خلال الإبلاغ عن المشاكل وطلب ميزات جديدة باستخدام أداة تتبُّع المشاكل من Google. "متتبع المشاكل" من Google هو أداة تستخدمها Google لتتبع مشكلات AOSP وطلبات الميزات. تتوفّر أداة تتبُّع المشاكل خارج Google ليستخدمها المستخدمون الخارجيون من الجمهور والشركاء الذين يحتاجون إلى التعاون مع فِرق Google بشأن مشاكل وميزات معيّنة.
للتعرّف على أساسيات أداة "تتبُّع المشاكل في Google"، اطّلِع على أداة "تتبُّع المشاكل في Google".
الإبلاغ عن خطأ
للإبلاغ عن خطأ في AOSP:
- استخدِم حقل البحث في "نظام تتبُّع المشاكل" للاطّلاع على ما إذا كان أحد المستخدمين قد أبلغ عن مشكلتك أو ميزتك باستخدام جميع الأخطاء المفتوحة كأساس لبحثك. لا تنسَ أيضًا البحث عن الأخطاء التي تم إغلاقها وإصلاحها. لمساعدتك في العثور على النتائج الأكثر رواجًا، يمكنك ترتيب النتيجة بالاستناد إلى عدد النجوم. لمعرفة التفاصيل حول استخدام حقل البحث، يُرجى الرجوع إلى عمليات البحث عن المشاكل.
- إذا عثرت على مشكلتك وكانت مهمة بالنسبة إليك، امنح هذه المشكلة علامة النجمة. يساعد عدد النجوم في تحديد أولوية المشكلة.
إذا لم يبلِّغ أحد عن مشكلتك، أنشئ خطأ جديدًا.
راجِع قسم هذا المستند المرتبط بالمكوّن الذي يرتبط بخطأك. تحدد مكونات الأخطاء الجزء الذي ينطبق عليه الخطأ في Android.
- إذا كان الخطأ مرتبطًا بالأمان، عليك الرجوع إلى قسم الأمان.
- إذا كان الخطأ مرتبطًا بنظام التشغيل AOSP، يُرجى الرجوع إلى النظام الأساسي.
- إذا كان الخطأ مرتبطًا بأدوات المطوّرين، يُرجى الرجوع إلى أدوات المطوّرين في Android.
- إذا كان الخطأ يشير إلى مستندات غير صحيحة، يُرجى الرجوع إلى المستندات.
املأ النموذج المقدَّم:
- إذا كانت المشكلة هي "خطأ"، يُرجى تضمين خطوات إعادة إنتاج الخطأ في التعليقات. إذا كان التعليق يشير فقط إلى أنّ هناك مشكلة، من المحتمل أن يحتاج إلى مزيد من المعلومات. تساعد Google في حلّ مشكلتك من خلال التفاصيل التي تقدّمها، بما في ذلك ملفات السجلّ وحتى مجموعة التصحيحات.
- إذا كانت المشكلة طلبًا لتقديم ميزة، يُرجى تقديم تفاصيل واضحة عن الميزة المقترَحة، بما في ذلك المشكلة التي تم حلّها واعتبارات التصميم.
انقر على إنشاء. يتم إنشاء تقرير الخطأ لكي تراجعه Google.
للتعرّف على كيفية تتبُّع حالة الخطأ، راجِع مقالة تتبُّع حالة الخطأ.
مكونات الخطأ
تم تصميم الأقسام الأربعة التالية لمساعدتك في البحث عن الأخطاء والإبلاغ عنها باستخدام المكوّن الصحيح.
الأمان
إذا عثرت على مشكلة تؤثر في أمان Android أو مكونات في أجهزة Pixel، يُرجى الإبلاغ عن الخطأ باتّباع التعليمات الواردة في الإبلاغ عن مشاكل الأمان. بالإضافة إلى ذلك، يمكن الاستفادة من أخطاء الأمان في برنامج المكافآت الخاص بأجهزة Android وGoogle.
النظام الأساسي
إذا كانت لديك مشكلة أو طلب ميزة يؤثران في أحد جوانب نظام Android الأساسي، يمكنك إرسال الخطأ من خلال النقر على رمز الخطأ بجانب منطقة المكوّن المعني:
أدوات مطوّري برامج Android
إذا كانت لديك مشكلة أو طلب ميزة يؤثر في أحد جوانب أدوات المطوّرين في Android، يمكنك الإبلاغ عن الخطأ عن طريق النقر على رمز الخطأ بجانب منطقة المكوّن ذات الصلة في الجدول التالي.
تصفُّح جميع مشاكل أدوات المطوّرين
| تصفُّح الأخطاء | التفاصيل | الإبلاغ عن خطأ |
|---|---|---|
| adb | bug_report | |
| Android Studio | معلومات خاصة بأخطاء "استوديو Android " | bug_report |
| C++ | المشاكل في "استوديو Android" | bug_report |
| محاكيات أو صور نظام | معلومات خاصة بأخطاء المحاكي | bug_report |
| أداة Gradle | معلومات خاصة بأخطاء Gradle | bug_report |
| تطبيق التغييرات | معلومات خاصة بتطبيق الإصلاحات على الأخطاء | bug_report |
| لينت | bug_report | |
| NDK | مشاكل في نظام الإنشاء أو في مُجمِّع NDK لا يُستخدم هذا القسم لطلبات البيانات من واجهة برمجة التطبيقات أو الأخطاء. واجهات برمجة التطبيقات هي جزء من نظام التشغيل، ويجب إرسال الطلبات المتعلّقة بها في أحد مكونات النظام الأساسي المذكورة أعلاه (إذا لم تكن تعرف أيًا منها، استخدِم Framework). | bug_report |
| أدوات تحليل الأداء | bug_report | |
| Jetpack (androidx) | bug_report | |
| Jetpack (androidx) Test | bug_report | |
| حزمة تطوير البرامج (SDK) للألعاب | bug_report | |
المستندات
إذا كانت لديك مشكلة أو طلب ميزة يؤثر على جانب من وثائق Android، فأبلغ عن الخطأ بالنقر على رمز الخطأ بجوار جزء المكون ذي الصلة:
| تصفُّح الأخطاء | الإبلاغ عن خطأ |
|---|---|
developer.android.com (مستندات مطوّري التطبيقات) |
bug_report |
source.android.com (مستندات AOSP) |
bug_report |
طلب إمكانية التشغيل التفاعلي في منطقة السوق المحدّدة
إذا أردت إرسال طلب تفاعل بين التطبيقات في إطار قانون DMA لنظام التشغيل Android، يُرجى استخدام منطقة المكوّن ذات الصلة:
| تقديم طلب | تصفُّح الطلبات |
|---|---|
| إنشاء طلب علني جديد | الطلبات العلنية |
| إنشاء طلب خاص جديد |
تتبُّع حالة الخطأ
يتم دائمًا وضع علامة جديد على الأخطاء التي تم إنشاؤها حديثًا. يراجع مطوّرو AOSP الأخطاء ويصنّفونها بانتظام من خلال تغيير حالتها وربما تحديد مطوّر لمعالجتها. يتم تصنيف الأخطاء إلى إحدى الفئات الثلاث التالية:
يجب تقديم المزيد من المعلومات. لا يتضمّن تقرير الخطأ معلومات كافية لأحدهم لتحديد أولوية الخطأ أو تحليله بشكل صحيح. يتم وضع بلاغ الخطأ في قائمة (قائمة جديدة + قائمة ساخنة:يجب تقديم معلومات) إلى أن تقدّم المعلومات المطلوبة. بعد مرور بعض الوقت، إذا لم يتم تقديم أي معلومات إضافية، يتم منح الخطأ حالة تشير إلى أنّه لن يتم اتخاذ أي إجراء بشأنه.
يتم تخصيص الخطأ لشخص ما، ثم إعادة تحديد أولوياته اختياريًا. تم الاعتراف بتقرير الأخطاء على أنه تقرير مفصّل وواضح عن مشكلة مشروعة. تم تحديد أولوية الخطأ بشكلٍ صحيح أو تم إعادة تحديد أولويته. أخيرًا، يتم إسناد الخطأ إلى مساهم محدد لتقييمه وتحليله.
وعادةً ما يظل الخطأ مقبولاً إلى أن يقرّر أحد المستخدمين إصلاح الخطأ، وعندها تُصنَّف الحالة مقبولاً. ومع ذلك، قد لا يغيِّر المُسنَد إليه حالة الخطأ إلى مقبول، وبدلاً من ذلك، عليك إصلاح الخطأ وتحديد الحالة تم الإصلاح أو تم التحقّق منه (تم التحقّق منه).
لن يتم اتخاذ أي إجراء بشأن الخطأ. يندرج الخطأ ضمن هذه الفئة لعدة أسباب، مثل أنّ الخطأ هو نسخة طبق الأصل من خطأ آخر، أو أنّه يتعذّر إصلاحه، أو أنّه يمثّل وظيفة تعمل على النحو المطلوب.
لتتبُّع حالة الخطأ:
- افتح الخطأ وانظر إلى حقلَي الأولوية والحالة والتعليقات. للاطّلاع على تفسيرات حول الأولوية والحالة، يُرجى الرجوع إلى حقول "المشاكل".
- (اختياري) يمكنك الرد على أي أسئلة أو تعليقات في حقل التعليقات.
يتم تضمين الأخطاء التي تم وضع علامة تم إصلاحها (تم التحقّق منها) عليها في إصدار قادم من Android.
معلومات إضافية لحالات معيّنة
في ما يلي المزيد من الشرح لبعض حالات الأخطاء (بالإضافة إلى المعلومات المقدَّمة في مستندات "أداة تتبُّع المشاكل" حقول المشكلة):
لن يتم إصلاحه (السلوك المقصود): اتّضح لمشرف AOSP أنّ السلوك الموضّح ليس خطأ، بل هو السلوك المقصود. ويُشار إلى هذه الحالة أيضًا باسم "يعمل على النحو المقصود (WAI)". بالنسبة إلى طلبات الميزات، اتّخذ أحد مشرفي AOSP قرارًا بأنّه لن يتم تنفيذ الطلب في Android.
لن يتم إصلاحه (غير قابل للتنفيذ): التغييرات اللازمة لمعالجة المشكلة ليست ممكنة بشكل معقول. وتُستخدَم هذه الحالة أيضًا لتسجيل المشاكل التي تم الإبلاغ عنها والتي لا يمكن التعامل معها في AOSP، وذلك عادةً لأنّها مرتبطة بجهاز مخصّص أو بتطبيق خارجي، أو لأنّ مُبلِغ المشكلة ظنّ أنّه يستخدم أداة تتبُّع المشاكل كمنتدى مساعدة.
تم إصلاحه (تم التحقّق منه): تم إصلاح هذا الخطأ، وهو مضمّن في إصدار رسمي.
تم الإصلاح: تم إصلاح هذا الخطأ (أو تم تنفيذ الميزة) في شجرة المصدر، ولكن ربما لم يتم تضمينه في إصدار رسمي بعد.