CircularAtraceUtil

public class CircularAtraceUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.CircularAtraceUtil

---

כלי atrace פותח בעיקר כדי לזהות את שורש הבעיות של שגיאות ANR במהלך בדיקות Monkey. הפעלת הפקודה start תתחיל מעקב אסינכרוני אחרי העקבות שתויגו במאגר זמני (circular buffer). הפעלת הפונקציה stop תגרום להעברת התוכן של המאגר אל InputStreamSource שהיא מחזירה. כדי להשתמש ב-API הזה במקרה שצוין למעלה (זיהוי של ANR), צריך קודם להטמיע את ה-method‏ start בתחילת הבדיקה ואת ה-method‏ end מיד בסוף הבדיקה. כאן אפשר לבחור איך לאחסן את הנתונים ולטפל בהם. ברוב המקרים, כדאי להשתמש ב-systrace עם האפשרות ‎--from-file כדי ליצור כלי לצפייה ב-HTML.

סיכום

‫constructors ציבוריים
CircularAtraceUtil()

‫methods ציבוריים
static FileInputStreamSource	endTrace(ITestDevice device) עוצרת את atrace ומעבירה את הפלט שלה באופן אסינכרוני לקובץ, שאותו היא מחזירה ב-InputStreamSource.
static void	startTrace(ITestDevice device, List<String> tags, int bufferSizeMB) הפונקציה מתחילה מעקב באופן אסינכרוני עם התגים שצוינו.

‫constructors ציבוריים

CircularAtraceUtil

public CircularAtraceUtil ()

‫methods ציבוריים

endTrace

public static FileInputStreamSource endTrace (ITestDevice device)

עוצרת את atrace ומעבירה את הפלט שלה באופן אסינכרוני לקובץ, שאותו היא מחזירה ב-InputStreamSource.

פרמטרים
device	ITestDevice

החזרות
FileInputStreamSource	‫FileInputStreamSource עם התוצאות מהפקודה atrace

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException
IllegalStateException

startTrace

public static void startTrace (ITestDevice device, 
                List<String> tags, 
                int bufferSizeMB)

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

פרמטרים
device	‫ITestDevice: המכשיר שהפעולות בו יעברו מעקב
tags	‫List: תגים שצריך לעקוב אחריהם באמצעות atrace. ברירת המחדל היא 'am gfx sched view'
bufferSizeMB	‫int: גודל המאגרים המעגליים ב-MB

הקפצת הודעות שגיאה (throw)
DeviceNotAvailableException
IllegalStateException