איך יוצרים דוח על באג ומצלמים סרטון במכשיר Android

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

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

הפעלת האפשרויות למפתחים וניפוי באגים ב-USB

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

הפעלת רישום מפורט (verbose) ביומן של Messages

מכשיר עם הרשאות בסיס

במכשיר עם הרשאת root, משתמשים בפקודות הבאות כדי להפעיל רישום ביומן מפורט:

adb shell setprop log.tag.Bugle VERBOSE
adb shell setprop log.tag.BugleDataModel VERBOSE
adb shell setprop log.tag.RcsProvisioning VERBOSE
adb shell setprop log.tag.CarrierServices VERBOSE
adb shell setprop log.tag.BugleAction VERBOSE:
adb shell setprop log.tag.BugleRcsEngine VERBOSE;
adb shell setprop log.tag.BugleTransport VERBOSE;
adb shell setprop log.tag.BugleRcsProvisioning VERBOSE;
adb shell setprop log.tag.RcsClientLib VERBOSE;
adb shell setprop log.tag.BugleRcs VERBOSE;

מפעילים רישום מפורט ביומן רק במכשירי הבדיקה. היומן הבא כולל פרטים אישיים מזהים (PII).

adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e carrier_services_log_level VERBOSE
adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e carrier_services_enable_debug_mode true
adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e bugle_rcs_allow_overrides true
adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e bugle_debugging true
adb shell su root am broadcast -a com.google.gservices.intent.action.GSERVICES_OVERRIDE -e carrier_services_enable_sensitive_logging true

מכשיר ללא הרשאת root

במכשיר ללא הרשאת root, משתמשים בפקודה הבאה כדי להפעיל רישום מפורט ביומן:

adb shell am broadcast -a 'com.google.android.gms.phenotype.FLAG_OVERRIDE' --es package "com.google.android.apps.messaging#com.google.android.apps.messaging" --es user "\*" --esa flags "bugle_phenotype__enable_verbose_bug_reports" --esa values "true" --esa types "boolean" com.google.android.gms

איך משחזרים את הבעיה

  1. בקטע הגדרות > מערכת > אפשרויות למפתחים > גודלי מאגר של יומן רישום, מגדילים את נפח מאגר הנתונים הזמני לרישום ביומן. כדאי להשתמש בגודל הגדול ביותר שמתאים למכשיר (לדוגמה, 16MB במכשיר מתקדם).
  2. סוגרים ידנית את אפליקציית Messages.
  3. אם הבאג קשור להקצאה של שירותי תקשורת מגוונים (RCS), צריך לבצע את השלבים הבאים:
    1. מפעילים את מצב הטיסה.
    2. מנקים את האחסון של Messages ושל Carrier Services דרך הגדרות.
    3. משביתים את מצב הטיסה.
    4. מפעילים את השימוש ב-RCS לצ'אטים בהגדרות.
    5. יש להמתין לפחות חמש דקות לפני שמתחילים לשלוח את דוח הבאג.

  4. לכל באג חדש, מוחקים את ההודעות ב-logcat:

    adb logcat -c

  5. מתחילים לצלם את הסרטון:

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

  6. מפעילים את אפליקציית Messages ומשחזרים את הבאג.

  7. מפסיקים את צילום הסרטון.

איסוף הדוח על הבאג

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

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

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

  4. מצרפים את דוח הבאג לבאג ששלחתם.

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

  1. מפעילים את תפריט ניפוי הבאגים של Messages:
    1. פותחים את Messages.
    2. מקישים על סרגל החיפוש.
    3. חיפוש של *xyzzy*. התפריט Debug Utils נפתח או שמופיעה הודעת טוסט עם ההודעה Debug menu option enabled.
  2. לוחצים לחיצה ארוכה על ההודעה.
  3. מקישים על סמל התפריט ואז על הצגת הפרטים.