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

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

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

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

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

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

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

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

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

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

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

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

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

تفاصيل أخطاء Android Studio

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

في حال توقف بيئة تطوير البرامج (IDE)

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

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

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

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

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

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

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

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

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

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

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

إعداد تقرير استخدام الذاكرة

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

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

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

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

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

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

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

في حال تعطّل بيئة تطوير البرامج (IDE) أو طرح استثناءات

بالنسبة إلى الأنواع الأخرى من الأعطال، أرفِق ملف 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. في نافذة عناصر التحكّم الموسّعة، اختَر تقرير الخطأ.

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

  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.