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

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

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

كيفية الإبلاغ عن خطأ

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

  1. لفتح تقرير خطأ من "استوديو Android"، انقر على مساعدة > إرسال ملاحظات.

    وهذه هي أسهل طريقة لبدء حدوث خطأ، لأنّها تملأ تقرير الخطأ بإصدار "استوديو Android" وإصدار Kotlin أو Java، بالإضافة إلى معلومات النظام المطلوبة لإعادة إظهار المشكلة بشكل صحيح.

    يمكنك أيضًا الإبلاغ عن الخطأ هنا وإضافة معلومات الإصدار بنفسك.

  2. أرفِق تقرير بيانات تشخيصي حتى نتمكّن من تصحيح مشكلتك. لإنشاء ملف ZIP لتقرير بيانات التشخيص، انقر على مساعدة > جمع السجلّات وبيانات التشخيص.

  3. قدِّم وصفًا للخطوات اللازمة لإعادة إظهار المشكلة. عليك إرسال أكبر قدر ممكن من المعلومات، بما في ذلك مقتطفات التعليمات البرمجية ومشروع GitHub الذي يمكن استخدامه لإعادة إنتاج الخطأ ولقطات الشاشة أو التسجيلات لما تراقبه.

  4. يُرجى وصف المشكلة بالتفصيل. اشرح النتيجة التي توقعتها وما لاحظته بدلاً من ذلك.

  5. اختَر عنوانًا وصفيًا لتقرير الخطأ. يؤدي استخدام عنوان أكثر وصفية إلى تسهيل الفرز حسب المشكلة.

بالنسبة إلى أخطاء معينة، نحتاج إلى معلومات إضافية، كما هو موضّح في الأقسام التالية:

تفاصيل أخطاء "استوديو Android"

للإبلاغ عن أخطاء خاصة بـ "استوديو Android"، عليك تضمين معلومات إضافية على النحو الموضَّح في هذا القسم.

في حال توقّف بيئة التطوير المتكاملة

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

إذا كان بيئة التطوير المتكاملة (IDE) بطيئة ولكن غير مجمّدة، عليك إرفاق ملف idea.log بتقرير الأخطاء. لإرفاق الملف، اختَر مساعدة > جمع السجلّات وبيانات التشخيص أو المساعدة > عرض ملفات تسجيل الدخول (المساعدة > عرض الباحث عن تسجيل الدخول على نظام التشغيل macOS). يُظهر هذا الملف ما إذا كان بيئة التطوير المتكاملة (IDE) تعرض أخطاءً في السجلّ.

استخدام الملفات التعريفية الخاصة بوحدة المعالجة المركزية (CPU) لتشخيص بطء الأداء

إذا كان لديك بطء في أداء Android Studio، يمكن أن تساعد الملفات الشخصية لوحدة المعالجة المركزية (CPU) في بعض الأحيان في تشخيص المشكلة.

يمكنك اتّباع الخطوات التالية لالتقاط ملف شخصي لوحدة المعالجة المركزية (CPU) باستخدام المكوِّن الإضافي لاختبار الأداء في "استوديو Android":

  1. ثبِّت المكوّن الإضافي.

  2. أنشئ ملفًا تعريفيًا لوحدة المعالجة المركزية (CPU).

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

    يظهر بالون اسم ملف لقطة وحدة المعالجة المركزية الذي يتبع التنسيق snapshot-NNN. شارك ملف اللقطة هذا في تقرير الأخطاء.

في حال نفاد ذاكرة IDE

يصعب في بعض الأحيان إعادة إنتاج مشاكل الذاكرة والإبلاغ عنها في "استوديو Android". للمساعدة في حل هذه المشكلة، يتضمّن "استوديو Android" تقريرًا حول استخدام الذاكرة يمكنك إرساله إلى فريق "استوديو Android" للمساعدة في تحديد مصدر مشاكل الذاكرة.

تنفيذ تقرير استخدام الذاكرة

لتشغيل تقرير حول استخدام الذاكرة، اتَّبِع الخطوات التالية:

  1. انقر على مساعدة > تحليل استخدام الذاكرة من شريط القوائم.

    يحذف "استوديو Android" كومة الذاكرة المؤقتة ويطلب منك إعادة تشغيل بيئة التطوير المتكاملة. إذا أعدت تشغيل بيئة التطوير المتكاملة، سيبدأ تحليل نَسْخ الذاكرة على الفور. وإلا، يبدأ تحليل نَسْخ الذاكرة في المرة التالية التي تشغّل فيها Android Studio. في كلتا الحالتين، يرسل إليك بيئة التطوير المتكاملة (IDE) إشعارًا بمجرد أن يصبح تقرير استخدام الذاكرة جاهزًا للمراجعة، كما هو موضح في الشكل 1.

    إشعار يشير إلى أنّ تقرير استخدام الذاكرة جاهز للمراجعة
    الشكل 1. الذاكرة إشعار استخدام التقرير.
  2. انقر على مراجعة التقرير.

    قبل إرسال التقرير، يمكنك مراجعة المعلومات التي يتم تضمينها:

    تقرير استخدام الذاكرة
    الشكل 2. تحليل تقرير استخدام الذاكرة
  3. بعد الانتهاء من المراجعة، انسخ محتوى التقرير في ملف وأرفِقه عند الإبلاغ عن الخطأ.

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

في حال تعطُّل بيئة التطوير المتكاملة أو حدوث استثناءات

بالنسبة إلى الأنواع الأخرى من الأعطال، أرفِق ملف idea.log الذي تم العثور عليه من خلال اختيار المساعدة > جمع السجلّات وبيانات التشخيص أو المساعدة > عرض ملفات تسجيل الدخول (المساعدة > عرض أداة البحث عن تسجيل الدخول على نظام التشغيل macOS).

إنشاء عملية تفريغ سلسلة التعليمات

عملية تفريغ سلسلة التعليمات هي نسخة مطبوعة من جميع سلاسل التعليمات التي يتم تشغيلها في أداة JVM. ولكل سلسلة ترابط، تتضمن نسخة مطبوعة من جميع إطارات المكدس. يسهّل ذلك معرفة ما يقوم به بيئة التطوير المتكاملة (IDE)، خاصةً إذا قمت بإنشاء بضع عمليات تفريغ للسلاسل النصية على بعد بضع ثوانٍ.

عند الإبلاغ عن أخطاء حيث يكون IDE مشغولاً للغاية بوحدة معالجة مركزية (CPU) مركبة أو حيث يبدو أن بيئة التطوير المتكاملة (IDE) قد توقف عن العمل، يمكن لعملية تفريغ سلسلة التعليمات أن تحدد إما الرمز الذي يقوم بالكثير من الأعمال أو السلاسل التي تتنافس على الموارد وتتسبب في توقف العملية.

يتم شحن JDK مع أداة تُسمى jstack يمكن استخدامها لإنشاء ملف تفريغ سلسلة التعليمات. أولاً، ابحث عن معرّف العملية (PID) الخاص بعملية "استوديو Android". ولتنفيذ ذلك، استخدِم الأمر jps:

على نظام التشغيل Linux أو نظام التشغيل macOS:

jps -mv | grep studio

في نظام التشغيل Windows:

jps -mv | findstr studio

يؤدي ذلك إلى طباعة خط طويل، مثل:

$ jps -mv | grep studio
37605 -Dfile.encoding=UTF-8 -ea -Dsun.io.useCanonCaches=false -Djava.net.preferIPv4Stack=true -Djna.nosys=true ...

الرقم الأول (37605، في هذا المثال) هو رقم تعريف العملية.

بعد ذلك، عليك إنشاء عملية تفريغ سلسلة محادثات وحفظها في ملف dump.txt:

jstack -l pid >> dump.txt

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

تفاصيل حول أدوات الإنشاء وأخطاء Gradle

للإبلاغ عن خطأ في أدوات الإنشاء أو Gradle، يمكنك إرفاق مشروع حقيقي أو نموذجي يوضح المشكلة للمساعدة في ضمان تسجيل جميع المعلومات اللازمة. يُرجى إزالة أي معلومات حساسة قبل مشاركتها.

إذا لم تتمكن من مشاركة مشروع، حدد إصدارات الأدوات التي تستخدمها. (جرِّب استخدام أحدث الإصدارات الثابتة أو أحدث المعاينة قبل الإبلاغ عن خطأ). للعثور على إصدارات أدواتك، قم بما يلي:

  • إصدار المكوّن الإضافي لنظام Gradle المتوافق مع Android:

    1. حدد ملف > هيكل المشروع.
    2. انقر على مشروع.
    3. حدِّد موقع إصدار المكوّن الإضافي لنظام Gradle المتوافق مع Android.
  • إصدار Gradle:

    1. حدد ملف > هيكل المشروع.
    2. انقر على مشروع.
    3. حدِّد موقع إصدار Gradle.
  • إصدار "استوديو Android":

    1. اختَر مساعدة > لمحة.
    2. حدِّد موقع إصدار "استوديو Android".

بالإضافة إلى ذلك، يُرجى تضمين المعلومات التالية، حيثما ينطبق ذلك:

  • إذا تغيّر سلوك ما بشكل غير متوقع من إصدار سابق إلى الإصدار الحالي، حدِّد كلا الإصدارين.
  • إذا تعذّر إنشاء الإصدار بسبب حدوث خطأ، يمكنك تشغيل الإصدار من سطر الأوامر باستخدام الخيار --stacktrace (مثل ./gradlew <task> --stacktrace) وتوفير تتبُّع تسلسل استدعاء الدوال البرمجية في تقرير الخطأ.
  • إذا استغرق الإصدار وقتًا أطول من المتوقَّع، يمكنك تجربة أحد الإجراءات التالية:
    • شغِّل ./gradlew <task> --scan وشارِك فحص إصدار Gradle الذي تم إنشاؤه في تقرير الأخطاء.
    • شغِّل ./gradlew <task> -Pandroid.enableProfileJson=true وشارك ملفات Chrome-trace التي تم إنشاؤها ضمن دليل <root-project>/build/android-profile.

تفاصيل حول أخطاء محاكي Android

اتّبِع الخطوات التالية لاستخدام عناصر التحكّم الموسّعة في المحاكي لجمع المعلومات والإبلاغ عن الخطأ:

  1. في لوحة المحاكي، انقر على رمز المزيد .
  2. في نافذة عناصر التحكّم الموسّعة، اختَر تقرير الخطأ.

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

  3. انتظر حتى ينتهي تقرير الخطأ من جمع البيانات، ثم انقر على إرسال إلى Google.

    ستفتح نافذة لحفظ تقرير الخطأ في مجلد. سيفتح المتصفّح أيضًا لإنشاء تقرير في أداة تتبّع المشاكل من Google مع ملء تفاصيل المحاكي الضرورية.

  4. في التقرير، أكمِل أي تفاصيل متبقية، مثل خطوات إعادة إظهار الخطأ، وأرفِق الملفات التي تم حفظها عند إنشاء تقرير الخطأ.

وبخلاف ذلك، أدخِل التفاصيل التالية يدويًا:

  • إصدار المحاكي

    1. في المحاكي، افتح عناصر التحكّم الموسّعة.
    2. انقر على مساعدة.
    3. انقر على علامة التبويب لمحة للعثور على إصدار المحاكي.
  • إصدار أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android

    1. اختَر الأدوات > مدير SDK.
    2. انقر على أدوات حزمة تطوير البرامج (SDK).
    3. حدِّد موقع أدوات Android SDK.
  • طراز وحدة المعالجة المركزية المضيفة

    • على نظام التشغيل Linux: افتح /proc/cpuinfo.
    • على نظام التشغيل Windows: انقر بزر الماوس الأيمن على My Computer (جهاز الكمبيوتر) واختَر Properties (الخصائص).
    • على نظام التشغيل macOS: اختَر رمز Apple وانقر على About This Mac (لمحة عن جهاز Mac هذا).
  • اسم الجهاز

    1. من مدير AVD، انقر لفتح القائمة في عمود الإجراءات للجهاز.
    2. حدد عرض التفاصيل (أو افتح ملف $avdname.avd/config.ini).
    3. ابحث عن إدخال hw.device.name. على سبيل المثال: hw.device.name=Nexus 5.