IMetricCollector

public interface IMetricCollector
implements ILogSaverListener , IDisableable

com.android.tradefed.device.metric.IMetricCollector

תת-מחלקות עקיפות ידועות AtraceCollector , AtraceRunMetricCollector , BaseDeviceMetricCollector , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CountTestCasesCollector , DebugHostLogOnFailureCollector , DeviceTraceCollector , FilePullerDeviceMetricCollector , FilePullerLogCollector , GcovCodeCoverageCollector , GcovKernelCodeCoverageCollector , and 11 others. AtraceCollector IMetricCollector שמריץ atrace במהלך בדיקה ואוסף את התוצאה ומחבר אותם ל-invocation. AtraceRunMetricCollector אוסף את העקבות מכל ספריית הבדיקה תחת הספרייה הנתונה ממכשיר הבדיקה, רושם את ספריית הבדיקה ולאחר עיבוד קבצי המעקב תחת ספריית הבדיקה ומצבירה את המדדים. BaseDeviceMetricCollector יישום בסיס של IMetricCollector המאפשר להתחיל ולהפסיק איסוף ב- onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) ו- ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) . BluetoothConnectionLatencyCollector האספן ידחוף למכשירים תצורת מדדי משך סטטיסטיקה מוגדרת מראש ויאסוף משך חיבור Bluetooth עבור כל פרופיל. BluetoothConnectionStateCollector אספן זה יאסוף מדדי BluetoothConnectionStateChanged ויתעד את מספר מצב החיבור עבור כל פרופיל. BugreportzOnFailureCollector אסוף דיווח באג כאשר מקרה מבחן נכשל. BugreportzOnTestCaseFailureCollector אסוף דיווח באג כאשר מקרה בדיקה בהרצה נכשל. ClangCodeCoverageCollector BaseDeviceMetricCollector שימשוך מדידות כיסוי Clang מהמכשיר וירשום אותן כחפצי בדיקה. CountTestCasesCollector ספור ודווח על מספר מקרי הבדיקה עבור IRemoteTest נתון. DebugHostLogOnFailureCollector אספן שיאסוף וירשום את היומנים בצד המארח כאשר מתרחש כשל של מקרה בדיקה. DeviceTraceCollector אספן שיתחיל מעקב פרפטו כשתתחיל ריצת בדיקה וקובץ מעקב יומן בסוף. FilePullerDeviceMetricCollector BaseDeviceMetricCollector שמאזין למפתח מדדים המגיע מהמכשיר ומושך אותם כקובץ מהמכשיר. FilePullerLogCollector לוגר של הקובץ שדווח על ידי צד המכשיר. GcovCodeCoverageCollector BaseDeviceMetricCollector שימשוך מדידות כיסוי gcov מהמכשיר וירשום אותם כחפצי בדיקה. GcovKernelCodeCoverageCollector BaseDeviceMetricCollector שימשוך מדידות כיסוי ליבת gcov מתוך ניפוי באגים ומחוץ למכשיר ואז לבסוף ירשום אותם כחפצי בדיקה. HostStatsdMetricCollector IMetricCollector שאוסף מדדי statsd מהצד המארח באמצעות פקודות השירות statsd. JavaCodeCoverageCollector BaseDeviceMetricCollector שימשוך מדידות כיסוי Java מהמכשיר וירשום אותם כחפצי בדיקה. LogcatOnFailureCollector אספן שילכוד ויועד logcat כאשר מקרה בדיקה נכשל. LogcatTimingMetricCollector אספן מדדים שאוסף מידע תזמון (למשל זמן החלפת משתמש) מ-logcat במהלך בדיקה חוזרת אחת או מרובות על ידי שימוש בתבניות רגקס נתונות כדי לנתח אותות התחלה וסיום של אירוע משורות logcat. ModuleLogcatCollector גרסה של אספן logcat אבל עבור מודול. PerfettoPullerMetricCollector יישום בסיס של FilePullerDeviceMetricCollector המאפשר משיכת קבצי הפרפטו מהמכשיר ואיסוף המדדים ממנו. RebootReasonCollector אספן שאוסף אתחול מחדש של המכשיר במהלך הפעלת הבדיקה ומדווח עליהם לפי סיבה וספירות. RuntimeRestartCollector אספן שאוסף חותמות זמן של הפעלה מחדש של זמן ריצה (קריסת שרת מערכת) במהלך ריצת הבדיקה, אם בכלל. צילום מסךOnFailureCollector אספן שיצלם ויועד צילום מסך כאשר מקרה מבחן נכשל. הצג מפהPullerMetricCollector יישום בסיס של FilePullerDeviceMetricCollector המאפשר משיכת קבצי ה-showmap מהמכשיר ואיסוף המדדים ממנו. TraceCmdCollector IMetricCollector שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ורושמת אותם ל-invocation.

---

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

לא ניתן להשתמש בממשק זה בתור א אפילו זה מרחיב את ITestInvocationListener . בדיקת התצורה תדחה אותה. יש להשתמש בו כ-"metrics_collector".

אספנים לא צפויים לשמור על מצב פנימי מכיוון שהם עשויים להיות בשימוש חוזר במספר מקומות. אם באמת יש להשתמש במצב פנימי, יש לנקות אותו ב- init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener) .

סיכום

שיטות ציבוריות
default boolean	captureModuleLevel () בין אם האספן ישים ללכידה ברמת המודול או לא וצריך להיות בו.
abstract	getBuildInfos () מחזירה את רשימת פרטי הבנייה הזמינים בהזמנה.
abstract	getDevices () מחזירה את רשימת המכשירים הזמינים בהזמנה.
abstract ITestInvocationListener	getInvocationListener () מחזירה את ה- ITestInvocationListener המקורי שאליו אנו מעבירים את התוצאות.
abstract ITestInvocationListener	init ( IInvocationContext context, ITestInvocationListener listener) אתחול האספן עם ההקשר הנוכחי ולאן להעביר תוצאות.
abstract void	onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test) התקשרות חוזרת כאשר מקרה בדיקה נכשל עם כשל בהנחה.
abstract void	onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) התקשרות חוזרת כאשר מקרה בדיקה מסתיים.
abstract void	onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) התקשרות חוזרת כאשר מקרה בדיקה מסתיים.
abstract void	onTestFail ( DeviceMetricData testData, TestDescription test) התקשרות חוזרת כאשר מקרה מבחן נכשל.
default void	onTestModuleEnded () מאפשר ללכוד את האירוע שהמודול הסתיים.
default void	onTestModuleStarted () מאפשר ללכוד את אירוע המודול שהתחיל.
abstract void	onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) התקשרות חוזרת כאשר הפעלת מבחן מסתיימת.
abstract void	onTestRunStart ( DeviceMetricData runData) התקשרות חוזרת כאשר מתחילה ריצת מבחן.
default void	onTestRunStart ( DeviceMetricData runData, int testCount) התקשרות חוזרת כאשר מתחילה ריצת מבחן.
abstract void	onTestStart ( DeviceMetricData testData) התקשרות חוזרת כאשר מתחיל מקרה בדיקה.

שיטות ציבוריות

captureModuleLevel

public boolean captureModuleLevel ()

בין אם האספן ישים ללכידה ברמת המודול או לא וצריך להיות בו.

החזרות
boolean

getBuildInfos

public abstract  getBuildInfos ()

מחזירה את רשימת פרטי הבנייה הזמינים בהזמנה.

החזרות

getDevices

public abstract  getDevices ()

מחזירה את רשימת המכשירים הזמינים בהזמנה.

החזרות

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

מחזירה את ה- ITestInvocationListener המקורי שאליו אנו מעבירים את התוצאות.

החזרות
ITestInvocationListener

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

אל תעקוף אלא אם כן אתה יודע מה אתה עושה.

פרמטרים
context	IInvocationContext : ה- IInvocationContext עבור ההתקשרות בתהליך.
listener	ITestInvocationListener : ה- ITestInvocationListener היכן לשים תוצאות.

החזרות
ITestInvocationListener	המאזין החדש עוטף את המאזין המקורי.

זורק
DeviceNotAvailableException

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

התקשרות חוזרת כאשר מקרה בדיקה נכשל עם כשל בהנחה.

פרמטרים
testData	DeviceMetricData : ה- DeviceMetricData את הנתונים עבור מקרה הבדיקה.
test	TestDescription : ה- TestDescription של מקרה הבדיקה בתהליך.

זורק
DeviceNotAvailableException

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

התקשרות חוזרת כאשר מקרה בדיקה מסתיים. זה אמור להיות הזמן לניקוי.

פרמטרים
testData	DeviceMetricData : ה- DeviceMetricData את הנתונים עבור מקרה הבדיקה. יהיה אותו אובייקט כמו במהלך onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .
currentTestCaseMetrics	: המפה הנוכחית של המדדים הועברה ל- ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .
test	TestDescription : ה- TestDescription של מקרה הבדיקה בתהליך.

זורק
DeviceNotAvailableException

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

התקשרות חוזרת כאשר מקרה בדיקה מסתיים. זה אמור להיות הזמן לניקוי.

פרמטרים
testData	DeviceMetricData : ה- DeviceMetricData את הנתונים עבור מקרה הבדיקה. יהיה אותו אובייקט כמו במהלך onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .
currentTestCaseMetrics	: המפה הנוכחית של המדדים הועברה ל- ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

זורק
DeviceNotAvailableException

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

התקשרות חוזרת כאשר מקרה מבחן נכשל.

פרמטרים
testData	DeviceMetricData : ה- DeviceMetricData את הנתונים עבור מקרה הבדיקה.
test	TestDescription : ה- TestDescription של מקרה הבדיקה בתהליך.

זורק
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

מאפשר ללכוד את האירוע שהמודול הסתיים.

זורק
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

מאפשר ללכוד את אירוע המודול שהתחיל.

זורק
DeviceNotAvailableException

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

פרמטרים
runData	DeviceMetricData : ה- DeviceMetricData שמחזיק את הנתונים להרצה. יהיה אותו אובייקט כמו במהלך onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) .
currentRunMetrics	: המפה הנוכחית של המדדים שהועברה ל- ERROR(/#testRunEnded(long,Map)) .

זורק
DeviceNotAvailableException

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

התקשרות חוזרת כאשר מתחילה ריצת מבחן.

פרמטרים
runData	DeviceMetricData : ה- DeviceMetricData שמחזיק את הנתונים להרצה.

זורק
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

התקשרות חוזרת כאשר מתחילה ריצת מבחן.

פרמטרים
runData	DeviceMetricData : ה- DeviceMetricData שמחזיק את הנתונים להרצה.
testCount	int : מספר מקרי הבדיקה בהפעלת הבדיקה הזו.

זורק
DeviceNotAvailableException

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

התקשרות חוזרת כאשר מתחיל מקרה בדיקה.

פרמטרים
testData	DeviceMetricData : ה- DeviceMetricData את הנתונים עבור מקרה הבדיקה.

זורק
DeviceNotAvailableException