דווח על באג

פועלים לפי השלבים שבדף הזה כדי לדווח על באג. יש הגבלות למשאבים לתיקון באגים, כך שבאגים שהושלמו נותנים עדיפות למידע. דוחות חלקיים על באגים נסגרים. אם זה במקרה כזה, יש לשלוח מחדש את הבאג עם מידע נוסף.

כדי להבטיח שלא מדווחים על באג שכבר תוקן, לוודא שאתם משתמשים בגרסאות האחרונות של הכלים. אפשר גם לחפש בעיות דומות מעקב אחר בעיות ב-Android Studio כדי לראות אם הבעיה שנתקלת בה כבר דווחה.

הערה: הכלי למעקב אחר בעיות הוא לא פורום תמיכה. אם יש לכם שאלות לגבי אופן השימוש בכלים או איך לגרום לאפליקציה ל-Android לפעול, כניסה גלישת מחסנית או באחד ממקורות המידע לתמיכה למפתחי Android.

איך מדווחים על באג

כדי לדווח על באג, פועלים לפי השלבים הבאים:

1. כדי לפתוח דוח על באג מ-Android Studio, בוחרים באפשרות עזרה > שולחים משוב.

   זו הדרך הקלה ביותר להתחיל באג, כי הוא מאכלס את דוח הבאג בגרסת Android Studio, בגרסת Kotlin או Java ובמערכת מידע, שנדרש כדי לשחזר את הבעיה בצורה תקינה.

   אפשר גם דיווח על הבאג כאן ולהוסיף את פרטי הגרסה בעצמכם.

2. יש לצרף דוח אבחון כדי שנוכל לנפות את הבאגים שגרמו לבעיה. כדי ליצור קובץ ZIP של דוח האבחון, לוחצים על עזרה > איסוף יומנים ונתוני אבחון.

3. יש לתאר את השלבים המדויקים לשחזור הבעיה. שליחה בתור כמה שיותר מידע, כולל קטעי קוד ופרויקט ב-GitHub שאפשר להשתמש בהם כדי לשחזר את הבאג, וגם צילומי מסך או הקלטות של שאתם צופים בהם.

4. יש לתאר בפירוט את הבעיה. להסביר מה התוצאה שציפית לקבל ובנתונים שצפיתם בהם.

5. בוחרים כותרת תיאורית לדוח הבאג. שימוש בשפה תיאורית יותר כך קל יותר למיין לפי בעיה.

לגבי באגים מסוימים, אנחנו זקוקים למידע נוסף, כמו שמתואר ב לסעיפים הבאים:

• פרטים על באגים ב-Android Studio
• פרטים על כלי build ובאגים של Gradle
• פרטים על באגים באמולטור Android

פרטים על באגים ב-Android Studio

כדי לדווח על באגים ספציפיים ל-Android Studio, צריך לכלול מידע נוסף כמתואר בסעיף הזה.

אם סביבת הפיתוח המשולבת (IDE) נתקעת

אם סביבת הפיתוח המשולבת עצמה נראית איטית מאוד או קפואה לגמרי, ליצור כמה קובצי נתונים של שרשורים כפי שמתואר בדף הזה ולצרף אותם לדוח הבאג. קובצי ה-thread מראים מה עושה סביבת הפיתוח המשולבת (IDE) שמאט אותו.

אם סביבת הפיתוח המשולבת (IDE) איטית אבל לא קפואה, יש לצרף את הקובץ idea.log לבאג שלנו. כדי לצרף את הקובץ, צריך לבחור באפשרות עזרה > איסוף יומנים ונתוני אבחון או עזרה > הצגת הקבצים ביומן (עזרה > הצגת פרטי היומן ב-macOS). בקובץ הזה אפשר לראות אם סביבת הפיתוח המשולבת מקפיצה שגיאות ליומן.

שימוש בפרופילים של המעבד (CPU) לאבחון איטיות

אם הבעיה ב-Android Studio מסוכנת, הפרופילים של המעבד (CPU) יכולים לפעמים עוזרים לאבחן את הבעיה.

יש לבצע את השלבים הבאים כדי לתעד פרופיל CPU באמצעות Android Studio הפלאגין לבדיקת ביצועים:

1. מתקינים את הפלאגין.

   • ב-Android Studio, מחפשים את האפשרות 'בדיקת ביצועים' בפלאגין זירת מסחר.
   • אפשר גם להוריד גרסה שתואמת ל-Android Studio מאתר הפלאגין.

2. יוצרים את פרופיל ה-CPU.

   1. כשנראה ש-Android Studio פועל באיטיות, בוחרים באפשרות התחלת השימוש במעבד (CPU) יצירת פרופילים.
   2. חזרה על כמה פעולות שזמן האחזור בעייתי (השלמת הקוד, הקלדה והמתנה להדגשה כדי להתעדכן וכו').
   3. לוחצים על הפסקת יצירת פרופילים של שימוש במעבד (CPU).

3. משתפים את קובץ הפרופיל.

   מופיע בלון שמספק את שם קובץ תמונת המצב של המעבד (CPU), בפורמט snapshot-NNN. משתפים את קובץ ה-snapshot בחשבון דוח איתור באגים.

אם נגמר הזיכרון בסביבת הפיתוח המשולבת (IDE)

לפעמים קשה לשחזר בעיות זיכרון ב-Android Studio שלנו. כדי לעזור בפתרון הבעיה הזו, מערכת Android Studio כוללת שימוש בזיכרון שאפשר לשלוח לצוות Android Studio כדי לעזור בזיהוי הוא המקור של בעיות הזיכרון.

הרצת דוח שימוש בזיכרון

כדי להריץ דוח שימוש בזיכרון, מבצעים את השלבים הבאים:

1. לוחצים על עזרה > ניתוח השימוש בזיכרון בסרגל התפריטים.

   מערכת Android Studio מוחקת את הערימה ומוצגת בקשה להפעיל מחדש את סביבת הפיתוח המשולבת (IDE). אם מפעילים מחדש את סביבת הפיתוח המשולבת (IDE), הניתוח של תמונת המצב של הזיכרון יתחיל באופן מיידי. אחרת, הפרמטר הניתוח של תמונת מצב של הזיכרון יתחיל בהפעלה הבאה של Android Studio. באחד משני הסוגים תופיע הודעה בסביבת הפיתוח המשולבת כשדוח השימוש בזיכרון יהיה מוכן של הביקורת, כפי שמוצג באיור 1.

   

   איור 1. זיכרון שימוש בהתראות הדיווח.

   חשוב: שליחת דוח שימוש בזיכרון לצוות Android Studio לא כוללת את הנתונים הגולמיים של תמונת מצב של הזיכרון, כי תמונת המצב של הזיכרון נמחק ברגע שהניתוח מסתיים. למרות שהדוח שנוצר לא מכיל מידע אישי, אלא נעשה בו שימוש בהתאם מדיניות הפרטיות של Google.

2. לוחצים על בדיקת הדוח.

   לפני שליחת הדוח, אפשר לבדוק את המידע כלול:

   

   איור 2. השימוש בזיכרון ניתוח דוחות.

3. לאחר סיום הבדיקה, מעתיקים את התוכן של לדווח לקובץ ולצרף את הקובץ הזה לדווח על הבאג.

   שליחת פרטי הדיווח בדרך הזו מאפשרת ל-Android Studio בצוות שלנו יתקשרו איתכם באמצעות הכלי למעקב אחר בעיות בזמן שהם יבדקו את בעיות בזיכרון.

אם סביבת הפיתוח המשולבת (IDE) קורסת או גורמת חריגות

לסוגים אחרים של קריסות, יש לצרף את הקובץ idea.log שנמצא על ידי בחירה באפשרות עזרה > איסוף יומנים ונתוני אבחון או עזרה > הצגת קובצי התחברות (עזרה > הצגת Log in Finder ב-macOS).

יצירת תמונת מצב של שרשורים

תמונת מצב של שרשורים היא הדפסה של כל השרשורים שרצים ב-JVM. בכל פעם שרשור, הוא כולל הדפסת כל ה-Stackframes. ככה קל לראות סביבת הפיתוח המשולבת (IDE) עמוסה, במיוחד אם יוצרים כמה השרשורים נעלמים בהפרש של כמה שניות.

כשמדווחים על באגים שבהם סביבת הפיתוח המשולבת עסוקה מאוד במעבד (CPU) מחובר או שבה נראה שסביבת הפיתוח המשולבת (IDE) הוקפאה, תמונת מצב של שרשורים יכולה לאתר איזה קוד מבצע הרבה עבודה או אילו שרשורים מתחרים משאבים שונים ולגרום למבוי סתום.

ה-JDK נשלח עם כלי בשם jstack שיכול לשמש ליצירת תמונת מצב של השרשורים. קודם כול, מאתרים את מזהה התהליך (PID) של תהליך Android Studio. כדי לעשות את זה, משתמשים בפקודה 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

הערה: גם jstack וגם jps נמצאים ב-bin של ה-JDK. אם מותקנות לכם כמה מפתחות JDK, השתמשו כאן יש את אותה הגרסה שמשמשת אותך ב-Android Studio. שפת תרגום כדי לבדוק באיזו גרסה מדובר, אפשר לעיין בתיבת הדו-שיח מידע כללי של Android Studio.

אם זה לא עובד, יש כמה דרכים נוספות שספציפיות לפלטפורמה יכול ליצור תמונת מצב של שרשורים. הוראות מפורטות זמינות במאמר תמיכה ב-IntelliJ.

פרטים על כלי build ובאגים ב-Gradle

כדי לדווח על באג בכלי build או ב-Gradle, צריך לצרף פרויקט אמיתי או פרויקט לדוגמה שממחיש את הבעיה כדי להבטיח שכל המידע מתבצע תיעוד. חשוב להסיר כל מידע רגיש לפני שמשתפים אותו.

אם לא ניתן לשתף פרויקט, צריך לציין את הגרסאות של הכלים באמצעות. (כדאי לנסות להשתמש בגרסאות היציבות או בגרסאות המקדימות האחרונות לפני דיווח על באג). כדי למצוא את גרסאות הכלים:

• גרסת הפלאגין של Android Gradle:

  1. בוחרים באפשרות קובץ > מבנה הפרויקט.
  2. לוחצים על פרויקט.
  3. מאתרים את גרסת הפלאגין של Android Gradle.

• גרסת Gradle:

  1. בוחרים באפשרות קובץ > מבנה הפרויקט.
  2. לוחצים על פרויקט.
  3. מאתרים את גרסת Gradle.

• גרסת Android Studio:

  1. בוחרים באפשרות עזרה > מידע כללי.
  2. מאתרים את התכונה גרסת Android Studio.

בנוסף, צריך לכלול את הפרטים הבאים, במקרים הרלוונטיים:

• אם התנהגות השתנתה באופן בלתי צפוי מגרסה קודמת את הגרסה הנוכחית, צריך לציין את שתי הגרסאות.
• אם ה-build נכשל עם שגיאה, צריך להריץ את ה-build משורת הפקודה עם האפשרות --stacktrace (למשל ./gradlew <task> --stacktrace) ומספקים דוח קריסות בדוח איתור הבאגים.
• אם ה-build נמשך יותר זמן מהצפוי, אפשר לנסות את אחת מהפעולות הבאות:
  • מריצים את ./gradlew <task> --scan ומשתפים את הקובץ שנוצר סריקת build באמצעות Gradle בבאג שלנו.
  • מריצים את ./gradlew <task> -Pandroid.enableProfileJson=true ומשתפים את מעקב ב-Chrome שנוצרו בתיקייה <root-project>/build/android-profile.

פרטים על באגים באמולטור Android

כדי להשתמש בפקדים המורחבים של האמולטור כדי לאסוף מידע, צריך לבצע את השלבים הבאים ומדווחים על באג:

1. בחלונית האמולטור, לוחצים על עוד .

2. בחלון מורחבים, בוחרים באפשרות דוח איתור באגים.

   נפתח מסך עם פרטים של דוח על באג, כמו צילום מסך, פרטי תצורת ה-AVD ויומן דוח איתור באגים. אפשר להזין את השלבים לשחזור כאן או להמתין ולהזין אותם הדוח שיופק בשלב הבא.

3. צריך להמתין עד שהאיסוף של דוח איתור הבאגים יסתיים, ואז לוחצים על שליחה אל Google.

   ייפתח חלון שבו תוכלו לשמור את דוח הבאג בתיקייה. הדפדפן שלך ייפתח גם דוח בכלי למעקב אחר בעיות של Google, יחד עם מילאת את הפרטים הנחוצים לאמולטור.

4. ממלאים את שאר הפרטים בדוח, כמו השלבים שצריך לבצע לשחזר את הבאג ולצרף את הקבצים שנשמרו כשיצרתם את הבאג שלנו.

אם לא, מזינים את הפרטים הבאים באופן ידני:

• גרסת אמולטור

  1. באמולטור, פותחים את פקדים מורחבים.
  2. לוחצים על עזרה.
  3. לוחצים על הכרטיסייה מידע כללי כדי למצוא את גרסת האמולטור.

• הגרסה של Android SDK Tools

  1. בוחרים באפשרות כלים > SDK Manager.
  2. לוחצים על SDK Tools.
  3. מאתרים את האפשרות כלים ל-Android SDK.

• דגם המעבד (CPU) המארח

  • ב-Linux: פותחים את /proc/cpuinfo.
  • ב-Windows: לוחצים לחיצה ימנית על המחשב שלי ובוחרים באפשרות מאפיינים.
  • ב-macOS: בוחרים את סמל Apple ואז לוחצים על אודות Mac הזה.

• שם המכשיר

  1. ב-AVD Manager, לוחצים כדי לפתוח את התפריט בקטע פעולות. של המכשיר.
  2. בוחרים באפשרות הצגת פרטים (או פותחים את הקובץ $avdname.avd/config.ini).
  3. מאתרים את הרשומה hw.device.name. עבור לדוגמה: hw.device.name=Nexus 5.