תיעוד מעקב המערכת במכשיר

מכשירים שמותקנת בהם מערכת Android בגרסה 9 (רמת API 28) ואילך כוללים אפליקציה ברמת המערכת שנקרא 'מעקב אחרי המערכת'. האפליקציה הזו דומה systraceבכלי שורת הפקודה, אבל האפליקציה מאפשרת לתעד מעקבים ישירות ממכשיר הבדיקה עצמו, צריך לחבר את המכשיר ולהתחבר אליו באמצעות adb. לאחר מכן אפשר להשתמש כדי לשתף את התוצאות מעקבות אלה עם צוות הפיתוח שלך.

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

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

הקלטת מעקב מערכת

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

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

הקלטה באמצעות לחצן בהגדרות המהירות

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

הגדרת כרטיס מידע

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

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

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

   

   איור 1. המתג הצגת הלחצן 'הגדרות מהירות' מופעל את האפליקציה System Tracing.

   

   איור 2. הלחצן מעקב מערכת בתוך החלונית הגדרות מהירות.

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

השלמת תיעוד של מעקב המערכת

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

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

   

   איור 3. התראה מתמשכת שמופיעה אחרי הפעלה של מעקב מערכת במכשיר.

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

   הערה: אפשר לתעד באגים שקשה לשחזר אותם. כדי לעשות זאת, יוצאים מהמערכת המעקב רץ ברקע ובקרוב יפסיק את מעקב המערכת לאחר שהבאג מתרחש. התכונה 'מעקב אחר המערכת' שומרת את נתוני הפעילות במכשיר בגלגול מאגר נתונים זמני, שכולל 10-30 שניות של אירועים.

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

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

   

   איור 4. התראה מתמשכת שמופיעה אחרי המערכת מסיימת לשמור מעקב מתועד.

הקלטה באמצעות תפריט האפליקציה

תפריט האפליקציה מאפשר לקבוע כמה הגדרות מתקדמות שקשורות למערכת מספק מתג להפעלה ולעצירה של מעקב המערכת.

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

1. הפעלת אפשרויות למפתחים.

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

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

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

4. אופציונלי: בוחרים את הקטגוריות של קריאות המערכת והחיישנים למעקב, ובוחרים גודל מאגר נתונים זמני לכל מעבד (CPU) ב-KB. בחרו קטגוריות מתאימות לתרחיש לדוגמה שאתם בודקים, למשל, הקטגוריה אודיו של לבדוק פעולות Bluetooth או את הקטגוריה זיכרון להקצאות של הזיכרון.

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

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

6. מפעילים את המתג Record tracking (הקלטת מעקב), שמודגש באיור 5. האריח הופך להיות מופעלת, ומופיעה התראה קבועה כדי להודיע לך שהמערכת מתעד מעקב, כפי שמוצג באיור 3.

   

   איור 5. המתג תיעוד מעקב במערכת הגדרות מעקב.

7. מבצעים באפליקציה את הפעולות שרוצים שהמערכת תבדוק.

   הערה: אפשר לתעד באגים שקשה לשחזר אותם. כדי לעשות זאת, יוצאים מהמערכת המעקב רץ ברקע ובקרוב יפסיק את מעקב המערכת לאחר שהבאג מתרחש. כברירת מחדל, מעקב המערכת שומר את הפעילות של המכשיר למאגר הנתונים הזמני, שמאחסן 10-30 שניות של אירועים. אם מעקבים ארוכים מופעלת, הפעילות במכשיר נשמרת באופן רציף באחסון של המכשיר למגבלות שהגדרתם.

8. כדי להפסיק את המעקב, משביתים את המתג תיעוד מעקב.

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

שיתוף מעקב מערכת

האפליקציה 'מעקב אחר המערכת' עוזרת לך לשתף תוצאות של מעקב המערכת כחלק תהליכי עבודה שונים. במכשיר שמותקנת בו גרסת Android 10 (API ברמה 29) ואילך, מבצעים מעקב קבצים שמורים עם הסיומת .perfetto-trace, ואפשר לפתוח אותם בממשק המשתמש של Perfetto. במכשיר שפועלת בו גרסה קודמת של Android, קובצי מעקב נשמרים באמצעות .ctrace filename, שמציין את הפורמט של Systrace.

שיתוף כהודעה

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

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

שיתוף מהאפליקציה 'קבצים'

במכשירים בגרסת Android 10 (רמת API 29) ואילך, נתוני המעקב מוצגים אפליקציית Files. ניתן לשתף נתוני מעקב מהאפליקציה הזו.

הורדת דוח באמצעות ADB

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

cd /path-to-traces-on-my-dev-machine && \
  adb pull /data/local/traces/ .

המרה בין פורמטים של מעקב

אפשר להמיר קובצי מעקב של Perfetto לפורמט Systrace. ראו המרות בין פורמטים למעקב אפשר לקבל מידע נוסף.

יצירת דוח HTML

כשמשתפים את המעקב, הדוח עצמו נמצא בקובץ .perfetto-trace ב- מכשירים עם Android 10 או קובץ .ctrace לכל הגרסאות האחרות.

ליצור דוח HTML מקובץ המעקב באמצעות ממשק משתמש מבוסס-אינטרנט או משורת הפקודה.

ממשק משתמש מבוסס-אינטרנט

משתמשים בממשק המשתמש של Perfetto כדי לפתוח את קובץ המעקב ולהפיק את הדוח.

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

שורת הפקודה

מריצים את הפקודות הבאות בחלון טרמינל כדי ליצור דוח HTML מקובץ המעקב:

cd /path-to-traces-on-my-dev-machine && \
  systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

אם עוד לא התקנתם את תוכנת שורת הפקודה systrace, אפשר להוריד אותו קטאפולט ב-GitHub, או ישירות מהקוד הפתוח של Android פרויקט.