דווח על באג

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

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

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

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

כדי לדווח על באג:

1. כדי לפתוח דוח על באג מ-Android Studio, בוחרים באפשרות Help (עזרה) > Submit a Bug Report (שליחת דוח על באג).

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

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

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

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

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

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

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

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

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

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

אם סביבת הפיתוח האינטגרטית (IDE) תקועה

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

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

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

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

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

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

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

2. יוצרים את פרופיל המעבד.

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

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

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

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

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

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

כדי להריץ דוח על שימוש בזיכרון:

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

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

   

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

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

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

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

   

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

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

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

אם סביבת הפיתוח קורסת או גורמת לחריגות

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

יצירת דמפ של שרשור

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

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

JDK כולל כלי בשם jstack שאפשר להשתמש בו כדי ליצור גרסת dump של חוט. קודם כול, צריך למצוא את מזהה התהליך (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. בוחרים באפשרות File > Project Structure.
  2. לוחצים על Project.
  3. מאתרים את גרסת הפלאגין של Android Gradle.

• גרסת Gradle:

  1. בוחרים באפשרות File > Project Structure.
  2. לוחצים על Project.
  3. מאתרים את גרסת Gradle.

• גרסת Android Studio:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• גרסת Android SDK Tools

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

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

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

• שם המכשיר

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