BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector

תת-כיתות ישירות ידועות AtraceCollector, ‏ BugreportzOnFailureCollector, ‏ BugreportzOnTestCaseFailureCollector, ‏ ClangCodeCoverageCollector, ‏ CodeCoverageCollector, ‏ CountTestCasesCollector, ‏ DebugHostLogOnFailureCollector, ‏ DeviceTraceCollector, ‏ FilePullerDeviceMetricCollector, ‏ GcovCodeCoverageCollector, ‏ GcovKernelCodeCoverageCollector, ‏ HostStatsdMetricCollector, ‏ JavaCodeCoverageCollector, ‏ LogcatOnFailureCollector, ‏ LogcatTimingMetricCollector, ‏ RebootReasonCollector, ‏ RuntimeRestartCollector, ‏ ScreenshotOnFailureCollector AtraceCollector IMetricCollector שמפעיל את atrace במהלך בדיקה, אוסף את התוצאה ומעדכן את היומן בקריאה.  BugreportzOnFailureCollector איסוף דוח bugreportz כשמקרה בדיקה נכשל.  BugreportzOnTestCaseFailureCollector איסוף דוח על באג כשמקרה בדיקה נכשל בהרצה.  ClangCodeCoverageCollector BaseDeviceMetricCollector שמושך מהמכשיר את מדידות הכיסוי של Clang ומתעדה אותן כפריטי בדיקה.  CodeCoverageCollector BaseDeviceMetricCollector שמושך מהמכשיר מדידות של כיסוי ב-Java ובקוד מקורי, ומתעדה אותן ביומן בתור ארטיפקטים של בדיקה.  CountTestCasesCollector ספירה של מספר תרחישי הבדיקה ודיווח עליהם עבור IRemoteTest נתון.  DebugHostLogOnFailureCollector אוסף את היומנים בצד המארח ומתעדה אותם כשמתרחשת כשל בתרגיל הבדיקה.  DeviceTraceCollector אוסף נתונים שיתחיל מעקב של perfetto כשהרצת הבדיקה תתחיל, וירשום את קובץ המעקב ביומן בסיום.  FilePullerDeviceMetricCollector BaseDeviceMetricCollector שמאזין למפתח המדדים שמגיע מהמכשיר ושולח אותם כקובץ מהמכשיר.  GcovCodeCoverageCollector BaseDeviceMetricCollector שמושך את מדידות הכיסוי של gcov מהמכשיר ומתעדה אותן כפריטי בדיקה.  GcovKernelCodeCoverageCollector BaseDeviceMetricCollector שמושך מדידות כיסוי של הליבה של gcov מ-debugfs ומהמכשיר, ולאחר מכן מתעד אותן כפריטי מידע שנוצרו במהלך הבדיקה.  HostStatsdMetricCollector IMetricCollector שאוסף מדדי statsd מצד המארח באמצעות פקודות השירות של statsd.  JavaCodeCoverageCollector BaseDeviceMetricCollector שמושך מהמכשיר מדידות של כיסוי Java ומתעדה אותן כפריטי בדיקה.  LogcatOnFailureCollector אוסף שיאגר logcat ויתעדה אותו ביומן כשמקרה בדיקה נכשל.  LogcatTimingMetricCollector אוסף מדדים שאוסף מידע על תזמון (למשל, זמן המעבר של המשתמש) מ-logcat במהלך בדיקה אחת או כמה בדיקות חוזרות, באמצעות דפוסי ביטוי רגולרי נתונים כדי לנתח אותות התחלה וסיום של אירוע משורות logcat.  RebootReasonCollector אוסף נתונים של הפעלות מחדש של המכשיר במהלך הרצה של הבדיקה, ומדווח עליהם לפי סיבה ומספר.  RuntimeRestartCollector אגרגטור שאוסף חותמות זמן של הפעלות מחדש בסביבת זמן הריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה.  ScreenshotOnFailureCollector אסוף נתונים שיצלם צילום מסך וירשום אותו ביומן כשמקרה בדיקה נכשל.

תת-כיתות עקיפות ידועות AtraceRunMetricCollector, ‏ BluetoothConnectionLatencyCollector, ‏ BluetoothConnectionStateCollector, ‏ BluetoothHciSnoopLogCollector, ‏ FilePullerLogCollector, ‏ ModuleLogcatCollector, ‏ PerfettoPullerMetricCollector, ‏ ShowmapPullerMetricCollector, ‏ TraceCmdCollector AtraceRunMetricCollector האובייקט הזה אוסף את כל הטראסים מתיקיית הבדיקה בתיקייה הנתונה במכשיר הבדיקה, מתעד את תיקיית הבדיקה, מעבד את קובצי הטראס בתיקיית הבדיקה ומאגד את המדדים.  BluetoothConnectionLatencyCollector האוסף ידחוף למכשירים הגדרה מוגדרת מראש של מדד משך זמן ב-statsd, ויאסוף את משך הזמן של חיבור ה-Bluetooth לכל פרופיל.  BluetoothConnectionStateCollector האוסף הזה יאסוף את המדדים של BluetoothConnectionStateChanged ויתעדה את מספר סטטוס החיבור לכל פרופיל.  BluetoothHciSnoopLogCollector כלי איסוף לצורך הפעלת רישום Snoop של Bluetooth HCI ב-DUT ואיסוף היומן לכל בדיקה.  FilePullerLogCollector יומן של הקובץ שדווח בצד המכשיר.  ModuleLogcatCollector גרסת האוסף של logcat, אבל למודול.  PerfettoPullerMetricCollector הטמעה בסיסית של FilePullerDeviceMetricCollector שמאפשרת למשוך את קובצי perfetto מהמכשיר ולאסוף ממנו את המדדים.  ShowmapPullerMetricCollector הטמעה בסיסית של FilePullerDeviceMetricCollector שמאפשרת למשוך את הקבצים של המפה הוויזואלית מהמכשיר ולאסוף ממנו את המדדים.  TraceCmdCollector IMetricCollector שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ומתעדה אותם ביומן של ההפעלה.

---

הטמעה בסיסית של IMetricCollector שמאפשרת להתחיל ולהפסיק את האיסוף ב-onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) וב-ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)).

סיכום

שדות
public static final String	TEST_CASE_EXCLUDE_GROUP_OPTION
public static final String	TEST_CASE_INCLUDE_GROUP_OPTION

יוצרים ציבוריים
BaseDeviceMetricCollector()

שיטות ציבוריות
void	extraInit(IInvocationContext context, ITestInvocationListener listener)
final	getBuildInfos() הפונקציה מחזירה את רשימת פרטי ה-build שזמינים בקריאה.
final	getDevices() הפונקציה מחזירה את רשימת המכשירים שזמינים בקריאה.
File	getFileFromTestArtifacts(String fileName) אחזור הקובץ מהארטיפקטים של הבדיקה או מהארטיפקטים של המודול ושמירתו במטמון במפה לשיחות הבאות.
final ITestInvocationListener	getInvocationListener() הפונקציה מחזירה את ITestInvocationListener המקורי שאליו אנחנו מעבירים את התוצאות.
String	getModuleName()
final	getRealDevices() הפונקציה מחזירה את כל המכשירים שאינם stubs מרשימת getDevices().
String	getRunName() הפונקציה מחזירה את השם של הרצה של הבדיקה mRunName שמפעילה את האוסף.
final ITestInvocationListener	init(IInvocationContext context, ITestInvocationListener listener) אתחול האוסף עם ההקשר הנוכחי ואיפה להעביר את התוצאות.
final void	invocationEnded(long elapsedTime) האירוע הזה מדווח על סיום ההפעלה, בין שהיא הסתיימה בהצלחה ובין שהיא הסתיימה בגלל תנאי שגיאה כלשהו.
final void	invocationFailed(FailureDescription failure) דיווח על קריאה חלקית עקב תנאי שגיאה כלשהו.
final void	invocationFailed(Throwable cause) דיווח על קריאה חלקית עקב תנאי שגיאה כלשהו.
void	invocationSkipped(SkipReason reason) דיווח על קריאה כ'דילוג'
final void	invocationStarted(IInvocationContext context) Listeners להפעלה להעברה
final boolean	isDisabled() הפונקציה מחזירה את הערך True אם האובייקט כולו מושבת (דילוג על ההגדרה ועל ביטול ההגדרה).
boolean	isDisabledReceiver() אם IDeviceActionReceiver מושבת או לא.
final void	logAssociation(String dataName, LogFile logFile) אין להשתמש בקוד הזה בתוך הטמעת האוסף של המדדים.
void	onTestAssumptionFailure(DeviceMetricData testData, TestDescription test) קריאה חוזרת (callback) כשמקרה בדיקה נכשל בגלל כישלון של הנחת יסוד.
void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) קריאה חוזרת (call back) בסיום בדיקת מקרה.
void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics) קריאה חוזרת (call back) בסיום בדיקת מקרה.
void	onTestFail(DeviceMetricData testData, TestDescription test) קריאה חוזרת (callback) כשמקרה בדיקה נכשל.
void	onTestModuleEnded() מאפשרת לתעד את האירוע 'המודול הסתיים'.
void	onTestModuleStarted() מאפשרת לתעד את האירוע 'המודול התחיל'.
void	onTestRunEnd(DeviceMetricData runData, currentRunMetrics) קריאה חוזרת כשהרצת הבדיקה מסתיימת.
void	onTestRunFailed(DeviceMetricData testData, FailureDescription failure) קריאה חוזרת (callback) לאירועים מסוג testRunFailed
void	onTestRunStart(DeviceMetricData runData) קריאה חוזרת (callback) כשהרצת הבדיקה מתחילה.
void	onTestStart(DeviceMetricData testData) קריאה חוזרת (callback) כשמקרה בדיקה מתחיל.
void	rebootEnded(ITestDevice device) קבלת התראה כשההפעלה מחדש של המכשיר מסתיימת.
void	rebootStarted(ITestDevice device) מקבלת התראה כשהפעלה מחדש מתחילה במכשיר.
final void	setDisable(boolean isDisabled) מגדיר אם האובייקט יושבת.
void	setDisableReceiver(boolean isDisabled) הגדרה של השבתה או הפעלה של IDeviceActionReceiver.
final void	setLogSaver(ILogSaver logSaver) אין להשתמש בקוד הזה בתוך הטמעת האוסף של המדדים.
final void	testAssumptionFailure(TestDescription test, String trace) הקריאה מתבצעת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
final void	testAssumptionFailure(TestDescription test, FailureDescription failure) הקריאה מתבצעת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר
final void	testEnded(TestDescription test, long endTime, testMetrics) חלופה ל-ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) שבה אפשר לציין את שעת הסיום ישירות.
final void	testEnded(TestDescription test, testMetrics) הדיווח על סיום הביצוע של מקרה בדיקה ספציפי.
final void	testFailed(TestDescription test, FailureDescription failure) דיווח על כשל של מקרה בדיקה ספציפי.
final void	testFailed(TestDescription test, String trace) דיווח על כשל של מקרה בדיקה ספציפי.
final void	testIgnored(TestDescription test) הקריאה מתבצעת כשבדיקה לא מופעלת, בדרך כלל כי השיטה לבדיקה מסומנת ב-org.junit.Ignore.
final void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) הנתונים המשויכים של היומן או ניפוי הבאגים מהפעלת הבדיקה.
final void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) אין להשתמש בקוד הזה בתוך הטמעת האוסף של המדדים.
final void	testModuleEnded() דיווח על סיום הרצת מודול.
final void	testModuleStarted(IInvocationContext moduleContext) דיווח על תחילת ההרצה של מודול.
final void	testRunEnded(long elapsedTime, runMetrics) דיווח על סיום הרצת הבדיקה.
final void	testRunFailed(FailureDescription failure) הרצת הבדיקה של הדוחות נכשלה בגלל כשל שמתואר ב-FailureDescription.
final void	testRunFailed(String errorMessage) הרצת הבדיקה של הדוחות נכשלה בגלל שגיאה קטלנית.
final void	testRunStarted(String runName, int testCount, int attemptNumber) דיווח על התחלת הרצה של בדיקה.
final void	testRunStarted(String runName, int testCount) בדיקה של קריאות חזרה (callbacks) להרצה
final void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) דיווח על התחלת הרצה של בדיקה.
final void	testRunStopped(long elapsedTime) הרצת הבדיקה של הדוחות הופסקה לפני שהסתיימה עקב בקשה של משתמש.
final void	testSkipped(TestDescription test, SkipReason reason) הקריאה מתבצעת כשבדיקה מועברת ולא מתבצעת מסיבה שלא צפויה בדרך כלל.
final void	testStarted(TestDescription test, long startTime) חלופה ל-testStarted(com.android.tradefed.result.TestDescription) שבה מציינים גם את מועד ההתחלה של הבדיקה, בשילוב עם ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) למדידה מדויקת.
final void	testStarted(TestDescription test) קריאות חזרה של תרחישים לבדיקה

שדות

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

יוצרים ציבוריים

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

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

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildInfos

public final  getBuildInfos ()

הפונקציה מחזירה את רשימת פרטי ה-build שזמינים בקריאה.

החזרות

getDevices

public final  getDevices ()

הפונקציה מחזירה את רשימת המכשירים שזמינים בקריאה.

החזרות

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

אחזור הקובץ מהארטיפקטים של הבדיקה או מהארטיפקטים של המודול ושמירתו במטמון במפה לשיחות הבאות.

פרמטרים
fileName	String: שם הקובץ לחיפוש בפריטים.

החזרות
File	קובץ מהארטיפקט של הבדיקה או מהארטיפקט של המודול. הפונקציה מחזירה ערך null אם הקובץ לא נמצא.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

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

החזרות
ITestInvocationListener

getModuleName

public String getModuleName ()

החזרות
String

getRealDevices

public final  getRealDevices ()

הפונקציה מחזירה את כל המכשירים שאינם stubs מהרשימה getDevices().

החזרות

getRunName

public String getRunName ()

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

החזרות
String	mRunName, השם הנוכחי של הרצה של הבדיקה.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

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

אל תשנו את ההגדרות אלא אם אתם יודעים מה אתם עושים.

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

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

זריקות
DeviceNotAvailableException

invocationEnded

public final void invocationEnded (long elapsedTime)

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

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

פרמטרים
elapsedTime	long: הזמן שחלף מהקריאה, באלפיות השנייה

invocationFailed

public final void invocationFailed (FailureDescription failure)

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

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

פרמטרים
failure	FailureDescription: ה-FailureDescription שמתאר את הסיבה לכישלון

invocationFailed

public final void invocationFailed (Throwable cause)

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

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

פרמטרים
cause	Throwable: Throwable הסיבה לכישלון

invocationSkipped

public void invocationSkipped (SkipReason reason)

דיווח על קריאה כ'דילוג'

פרמטרים
reason	SkipReason

invocationStarted

public final void invocationStarted (IInvocationContext context)

Listeners להפעלה להעברה

פרמטרים
context	IInvocationContext: מידע על ההפעלה

isDisabled

public final boolean isDisabled ()

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

החזרות
boolean

isDisabledReceiver

public boolean isDisabledReceiver ()

אם IDeviceActionReceiver מושבת או לא.

החזרות
boolean	הפונקציה מחזירה את הערך true אם האפשרות מושבתת, ואת הערך false במקרים אחרים.

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

אין להשתמש בקוד הזה בתוך הטמעת אגרוף המדדים. זוהי העברה טהורה.

פרמטרים
dataName	String: השם של הנתונים
logFile	LogFile: ה-LogFile שרשום ביומן קודם וצריך לשייך למקרה הבדיקה.

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

קריאה חוזרת (callback) כשמקרה בדיקה נכשל בגלל כישלון של הנחת יסוד.

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

זריקות
DeviceNotAvailableException

onTestEnd

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

קריאה חוזרת (call back) בסיום בדיקת מקרה. זה הזמן לנקות.

פרמטרים
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 void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

קריאה חוזרת (call back) בסיום בדיקת מקרה. זה הזמן לנקות.

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

זריקות
DeviceNotAvailableException

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

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

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

זריקות
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

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

זריקות
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

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

זריקות
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

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

זריקות
DeviceNotAvailableException

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

קריאה חוזרת (callback) לאירועים מסוג testRunFailed

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

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

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

זריקות
DeviceNotAvailableException

onTestStart

public void onTestStart (DeviceMetricData testData)

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

פרמטרים
testData	DeviceMetricData: ה-DeviceMetricData שמכיל את הנתונים של תרחיש הבדיקה.

זריקות
DeviceNotAvailableException

rebootEnded

public void rebootEnded (ITestDevice device)

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

הערה: מומלץ להימנע מהפעלה מחדש של המכשירים במהלך השיחה החוזרת. המערכת תתעלם מכל ניסיון להפעיל מחדש.

פרמטרים
device	ITestDevice: ITestDevice שבו הסתיימה ההפעלה מחדש.

זריקות
DeviceNotAvailableException

rebootStarted

public void rebootStarted (ITestDevice device)

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

הערה: מומלץ להימנע מהפעלה מחדש של המכשירים במהלך השיחה החוזרת. המערכת תתעלם מכל ניסיון להפעיל מחדש.

פרמטרים
device	ITestDevice: ITestDevice המיקום שבו החלה ההפעלה מחדש.

זריקות
DeviceNotAvailableException

setDisable

public final void setDisable (boolean isDisabled)

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

פרמטרים
isDisabled	boolean: המצב שאליו צריך להעביר את האובייקט.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

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

פרמטרים
isDisabled	boolean

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

אין להשתמש בקוד הזה בתוך הטמעת האוסף של המדדים. זוהי העברה טהורה.

פרמטרים
logSaver	ILogSaver: ILogSaver

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

הפונקציה נקראת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר

פרמטרים
test	TestDescription: מזהה את הבדיקה
trace	String: סטאק טריי של הכשל

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

הפונקציה נקראת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר

פרמטרים
test	TestDescription: מזהה את הבדיקה
failure	FailureDescription: FailureDescription שמתאר את התקלה ואת ההקשר שלה.

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

חלופה ל-ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) שבה אפשר לציין את שעת הסיום ישירות. כדי לקבל מדידה מדויקת, אפשר לשלב את הפונקציה עם testStarted(com.android.tradefed.result.TestDescription, long).

פרמטרים
test	TestDescription: מזהה את הבדיקה
endTime	long: השעה שבה הסתיים הבדיקה, נמדדת באמצעות System.currentTimeMillis()
testMetrics	: ERROR(/Map) של המדדים שמונפקים

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

הדיווח על סיום הביצוע של מקרה בדיקה ספציפי.

אם לא הופעל testFailed(TestDescription, FailureDescription), הבדיקה הזו עברה. הפונקציה מחזירה גם מדדים מסוג מפתח/ערך שעשויים להופיע במהלך ביצוע מקרה הבדיקה.

פרמטרים
test	TestDescription: מזהה את הבדיקה
testMetrics	: ERROR(/Map) של המדדים שמונפקים

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

הקריאה תתבצע בין testStarted ל-testEnded.

פרמטרים
test	TestDescription: מזהה את הבדיקה
failure	FailureDescription: FailureDescription שמתאר את התקלה ואת ההקשר שלה.

testFailed

public final void testFailed (TestDescription test, 
                String trace)

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

הקריאה תתבצע בין testStarted ל-testEnded.

פרמטרים
test	TestDescription: מזהה את הבדיקה
trace	String: סטאק טריי של הכישלון

testIgnored

public final void testIgnored (TestDescription test)

הקריאה מתבצעת כשבדיקה לא מופעלת, בדרך כלל כי השיטה לבדיקה מסומנת ב-org.junit.Ignore.

פרמטרים
test	TestDescription: מזהה את הבדיקה

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

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

צריך להפעיל את הפונקציה לפני ERROR(/ITestInvocationListener#invocationFailed(Throwable)) או ERROR(/ITestInvocationListener#invocationEnded(long))

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

פרמטרים
dataName	String: String שם תיאורי של הנתונים. לדוגמה, 'device_logcat'. הערה: שם המשתנה dataName לא חייב להיות ייחודי לכל קריאה. כלומר, למטמיעים צריכה להיות אפשרות לטפל בכמה קריאות עם אותו שם משתנה
dataType	LogDataType: ה-LogDataType של הנתונים
dataStream	InputStreamSource: ה-InputStreamSource של הנתונים. מי שמטמיע את הקוד צריך להפעיל את createInputStream כדי להתחיל לקרוא את הנתונים, ולוודא שהוא סוגר את ה-InputStream שנוצר בסיום. מבצעי הקריאה צריכים לוודא שמקור הנתונים יישאר נוכח וזמין עד להשלמת השיטה testLog.

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

אין להשתמש בקוד הזה בתוך הטמעת האוסף של המדדים. זוהי העברה טהורה.

פרמטרים
dataName	String: String שם תיאורי של הנתונים. לדוגמה, 'device_logcat'. הערה: שם המשתנה dataName לא חייב להיות ייחודי לכל קריאה. כלומר, למטמיעים צריכה להיות אפשרות לטפל בכמה קריאות עם אותו שם משתנה
dataType	LogDataType: ה-LogDataType של הנתונים
dataStream	InputStreamSource: ה-InputStreamSource של הנתונים. מי שמטמיע את הקוד צריך להפעיל את createInputStream כדי להתחיל לקרוא את הנתונים, ולוודא שהוא סוגר את ה-InputStream שנוצר בסיום.
logFile	LogFile: ה-LogFile שמכיל את המטא-נתונים של הקובץ שנשמר.

testModuleEnded

public final void testModuleEnded ()

דיווח על סיום הרצת מודול.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

דיווח על תחילת ההרצה של מודול. קריאת החזרה (callback) הזו משויכת ל-testModuleEnded() והיא אופציונלית בסדרה. הוא משמש רק במהלך ריצה שמשתמשת במודולים: כלי ריצה מבוססי-חבילות.

פרמטרים
moduleContext	IInvocationContext: ה-IInvocationContext של המודול.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

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

פרמטרים
elapsedTime	long: הזמן שחלף שדווח על ידי המכשיר, באלפיות השנייה
runMetrics	: צמדי מפתח/ערך שמדווחים בסוף הרצה של בדיקה

testRunFailed

public final void testRunFailed (FailureDescription failure)

הרצת הבדיקה של הדוחות נכשלה בגלל כשל שמתואר ב-FailureDescription.

פרמטרים
failure	FailureDescription: FailureDescription שמתאר את התקלה ואת ההקשר שלה.

testRunFailed

public final void testRunFailed (String errorMessage)

הרצת הבדיקה של הדוחות נכשלה בגלל שגיאה קטלנית.

פרמטרים
errorMessage	String: String שמתאר את הסיבה לכישלון ההרצה.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

דיווח על התחלת הרצה של בדיקה.

פרמטרים
runName	String: שם ההרצה לניסיון
testCount	int: המספר הכולל של הבדיקות בהרצה לניסיון
attemptNumber	int: מספר הזמנה, שמזהה את הניסיונות השונים של אותו runName שמוצגים כמה פעמים. הערך של attemptNumber מתחיל ב-0 וצריך לעלות בכל פעם שמתבצעה הפעלה חדשה. לדוגמה, אם מתבצעות 3 ניסיונות מפורטים של בדיקה, צריכות להיות לה 4 הפעלות בסך הכול באותו runName, והערך של attemptNumber יהיה בין 0 ל-3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

בדיקה של קריאות חזרה (callbacks) להרצה

פרמטרים
runName	String: שם ההרצה לניסיון
testCount	int: המספר הכולל של הבדיקות בהרצה לניסיון

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

דיווח על התחלת הרצה של בדיקה.

פרמטרים
runName	String: שם ההרצה לניסיון
testCount	int: המספר הכולל של הבדיקות בהרצה לניסיון
attemptNumber	int: מספר הזמנה, שמזהה את הניסיונות השונים של אותו runName שמוצגים כמה פעמים. הערך של attemptNumber מתחיל ב-0 וצריך לעלות בכל פעם שמתבצעה הפעלה חדשה. לדוגמה, אם מתבצעות 3 ניסיונות מפורטים של בדיקה, צריכות להיות לה 4 הפעלות בסך הכול באותו runName, והערך של attemptNumber יהיה בין 0 ל-3.
startTime	long: השעה שבה הרצת הקוד התחילה, שנמדדת באמצעות System.currentTimeMillis()

testRunStopped

public final void testRunStopped (long elapsedTime)

הרצת הבדיקה של הדוחות הופסקה לפני שהסתיימה עקב בקשה של משתמש.

TODO: currently unused, consider removing

פרמטרים
elapsedTime	long: הזמן שחלף שדווח על ידי המכשיר, באלפיות השנייה

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

פרמטרים
test	TestDescription: מזהה את הבדיקה
reason	SkipReason: SkipReason

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

חלופה ל-testStarted(com.android.tradefed.result.TestDescription) שבה מציינים גם את מועד ההתחלה של הבדיקה, בשילוב עם ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) למדידה מדויקת.

פרמטרים
test	TestDescription: מזהה את הבדיקה
startTime	long: השעה שבה הבדיקה התחילה, נמדדת באמצעות System.currentTimeMillis()

testStarted

public final void testStarted (TestDescription test)

קריאות חזרה של תרחישים לבדיקה

פרמטרים
test	TestDescription: מזהה את הבדיקה