דף זה תורגם על ידי Cloud Translation API.

ITestLogger

public interface ITestLogger

com.android.tradefed.log.ITestLogger

תת-כיתות עקיפות ידועות

AggregatePostProcessor,‏ AtraceCollector,‏ AtraceRunMetricCollector,‏ AveragePostProcessor,‏ BaseDeviceMetricCollector,‏ BasePostProcessor,‏ BluetoothConnectionLatencyCollector,‏ BluetoothConnectionStateCollector,‏ BluetoothConnectionSuccessRatePostProcessor,‏ BluetoothHciSnoopLogCollector,‏ BugreportCollector,‏ BugreportzOnFailureCollector,‏ BugreportzOnTestCaseFailureCollector,‏ ClangCodeCoverageCollector,‏ CollectingTestListener ו-75 אחרים.

AggregatePostProcessor	צובר מדדים שמציג את הערכים המינימלי, המקסימלי, הממוצע, השונות, סטיית התקן, הסכום, המספר והפרסנטילים (אופציונלי) של מדדים מספריים שנאספו במהלך מספר סבבי בדיקה, כאשר הם מטופלים כמספרים כפולים.
AtraceCollector	`IMetricCollector` שמפעיל את atrace במהלך בדיקה, אוסף את התוצאה ומעדכן את היומן בקריאה.
AtraceRunMetricCollector	האובייקט הזה אוסף את כל הטראסים מתיקיית הבדיקה בתיקייה הנתונה במכשיר הבדיקה, מתעד את תיקיית הבדיקה, מעבד את קובצי הטראס בתיקיית הבדיקה ומאגד את המדדים.
AveragePostProcessor	הטמעה של מעבד נתונים לאחר העיבוד שמחשב את הממוצע של רשימת המדדים.
BaseDeviceMetricCollector	הטמעה בסיסית של `IMetricCollector` שמאפשרת להתחיל ולהפסיק את האיסוף ב-`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` וב-`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BasePostProcessor	הבסיס `IPostProcessor` שכל הטמעה צריכה להרחיב.
BluetoothConnectionLatencyCollector	האספן יחסום הגדרה מוגדרת מראש של מדדי משך הזמן של הנתונים הסטטיסטיים במכשירים, ויאסוף את משך החיבור של Bluetooth לכל פרופיל.
BluetoothConnectionStateCollector	האוסף הזה יאסוף את המדדים של BluetoothConnectionStateChanged ויתעדה את מספר סטטוס החיבור לכל פרופיל.
BluetoothConnectionSuccessRatePostProcessor	הטמעה של מעבד נתונים לאחר העיבוד שמחשב את שיעור ההצלחה של פרופיל Bluetooth אפשר להשתמש ב-metric-key-match כדי לציין מדדים שמכילים מצבי חיבור Bluetooth במערך המספרי. לדוגמה [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	כלי איסוף לצורך הפעלת רישום Snoop של Bluetooth HCI ב-DUT ואיסוף היומן לכל בדיקה.
BugreportCollector	`ITestInvocationListener` של צדדים שלישיים שאוסף דוחות על באגים כשמתרחשים אירועים ניתנים להגדרה, ואז קורא ל-`ITestInvocationListener#testLog` עבור הצאצאים שלו אחרי כל איסוף של דוח על באג.
BugreportzOnFailureCollector	איסוף דוח bugreportz כשמקרה בדיקה נכשל.
BugreportzOnTestCaseFailureCollector	איסוף דוח על באג כשתרחיש בדיקה בהרצה נכשל.
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` שמושך מהמכשיר את מדידות הכיסוי של Clang ומתעדות אותן ביומן כפריטי בדיקה.
CollectingTestListener	`ITestInvocationListener` שיאסוף את כל תוצאות הבדיקה.
CommandStatusHandler	אפליקציית handler עוזרת לעקוב אחרי סטטוס ההפעלה ולעדכן אותה.
ConditionFailureMonitor	בודקים אם יש כשלים בהפעלה.
ConsoleResultReporter	כתב התוצאות ידפיס את תוצאות הבדיקה במסוף.
CountTestCasesCollector	ספירה של מספר תרחישי הבדיקה ודיווח עליהם עבור `IRemoteTest` נתון.
DebugHostLogOnFailureCollector	אוסף שיאסוף את היומנים בצד המארח ויתעדה אותם ביומן כשמתרחשת כשל בתרגיל הבדיקה.
DeviceReleaseReporter	דיווח על השקת מכשירים שמטפל בתקשורת עם תהליך ההורה של המכשירים שרוצים להשיק.
DeviceTraceCollector	אוסף שיתחיל לעקוב באופן עצמאי כשהפעלת בדיקה מתחילה וקובץ מעקב ביומן בסוף.
DeviceUnavailableMonitor	המאזין הזה מנסה לתעד DNAE ברמת מקרה הבדיקה בלבד.
EventsLoggerListener	מאזין שמתעדה ביומן את כל האירועים שהוא מקבל בקובץ
FileProtoResultReporter	כתב אב שמוסיף את `TestRecord` לקובץ.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` שמאזין למפתח מדדים שמגיע מהמכשיר ומושך אותם כקובץ מהמכשיר.
FilePullerLogCollector	יומן של הקובץ שדווח בצד המכשיר.
FilteredResultForwarder	וריאנט של `ResultForwarder` שמאפשר לדווח רק על רשימת היתרים של `TestDescription`.
FormattedGeneratorReporter	כתב שמאפשר ליצור דוחות בפורמט מסוים.
GcovCodeCoverCollector	`BaseDeviceMetricCollector` שמושך את מדידות הכיסוי של gcov מהמכשיר ומתעדה אותן כפריטי בדיקה.
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` שיאחזר את מדידות הכיסוי של הליבה של gcov מניפוי באגים ומחוץ למכשיר, ואז ירשום אותן כפריטי מידע שנוצרו בתהליך פיתוח (Artifact) לבדיקה.
GranularRetriableTestWrapper.StartEndCollector	עוזר/ת בכיתה לזהות נקודות התחלה וסיום חסרות לריצה.
HostStatsdMetricCollector	`IMetricCollector` שאוסף מדדי statsd מצד המארח באמצעות פקודות השירות של statsd.
ICommandScheduler.IScheduledInvocationListener	מאזין לאירועי קריאה כשהקריאה מסתיימת.
ILogSaverListener	מאפשר ל-`ITestInvocationListener` להאזין לאירועים של שמירת קובצי יומנים.
IMetricCollector	הממשק הזה יתווסף כקישוט בדיווח על תוצאות הבדיקות כדי לאסוף מדדים תואמים.
IPostProcessor	עיבוד נתונים לאחר הבדיקה הוא אובייקט של Trade Federation שמאפשר עיבוד של מדדים ורשומות ביומן אחרי הבדיקה ולפני הדיווח על התוצאות.
IShardableListener	`ITestInvocationListener` שאפשר לפיצול.
ISupportGranularResults	ממשק שמציין אם `ITestInvocationListener` תומך בקבלת התוצאות המפורטות או לא.
ITestInvocationListener	מאזין לתוצאות הבדיקה מהפעלת הבדיקה.
ITestSummaryListener	ממשק שמאפשר ל-`ITestInvocationListener` להחליף מידע מוגבל באמצעות סיכומים.
InvocationToJUnitUnitProcesser	מחלקה שמקשיבה לאירועים מסוג `ITestInvocationListener` ומעבירה אותם ל-`TestListener`.
JarHostTest.HostTestListener	האזנה ל-Wrapper שמעביר את כל האירועים מלבד testRunStarted() ו-testRunEnded() ל-listener המוטמע.
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` שיאחזר את מדידות הכיסוי של Java מהמכשיר ותרשום אותן כארטיפקטים של הבדיקה.
JsonHttpTestResultReporter	דיווח על תוצאות שמקודד את תוצאות מדדי הבדיקה ואת ההסתעפות, פרטי המכשיר ל-JSON ושולח את ה-POST לנקודת קצה של שירות HTTP.
LUCIתוצאהReporter	דיווח על תוצאות שמציל את תוצאות הבדיקה שנדרשות ל-ResultDB ול-LUCI בפורמט JSON (go/result-sink) ומתעדה את מיקום הקובץ במסוף.
LastShardDetector	כשמריצים חלוקה לקטעים מקומית, לפעמים רוצים לבצע פעולות מסוימות רק כשהקטע האחרון מגיע ל-`invocationEnded(long)`.
LegacySubprocessResultsReporter	יישום קפוא של מדווח התוצאות של תהליך המשנה שאמור להישאר תואם לגרסאות קודמות של TF/CTS (למשל, 8 ואילך), למרות שינויים במחלקה-העל שלו.
LogSaverResultForwarder	`ResultForwarder` לשמירת יומנים באמצעות שומר הקבצים הגלובלי.
LogcatCrashResultForwarder	האזנה מיוחדת: בכשלים (קריסת תהליך האינסטרומנטציה) הוא ינסה לחלץ מה-Logcat את הקריסה ויוסיף אותה להודעת הכשל שמשויכת לבדיקה.
LogcatOnFailureCollector	Collector שיתעד וירשום ביומן Logcat כשמקרה בדיקה נכשל.
LogcatTimingMetricCollector	אוסף מדדים שאוסף מידע על תזמון (למשל, זמן המעבר של המשתמש) מ-logcat במהלך בדיקה אחת או כמה בדיקות חוזרות, באמצעות דפוסי ביטוי רגולרי נתונים כדי לנתח את אותות ההתחלה והסיום של אירוע משורות logcat.
MetricFilePostProcessor	משמש להעלאת קובץ יומן המדדים שנאסף במהלך הבדיקה וברמת ההרצה.
MetricsXMLResultReporter	MetricsXMLResultReporter כותב מדדי בדיקה ומדדי ריצה לקובץ XML בתיקייה שצוינה בפרמטר metrics-folder בשלב invocationEnded של הבדיקה.
ModuleListener	מאזין שמצורף לכל `IRemoteTest` של כל מודול כדי לאסוף את רשימת התוצאות.
ModuleLogcatCollector	גרסת האוסף של logcat, אבל למודול.
ModuleProtoResultReporter	דיווח על תוצאות שמיועד לדיווח רק על התוצאות ברמת המודול.
NameMangleListener	מאזין proxy לתרגום שמות של שיטות בדיקה, כיתות וחבילות בזמן הדיווח על התוצאות.
PassingTestFileReporter ( PassingTestFileReporter)	`ITestInvocationListener` ששומר בקובץ הבדיקה את רשימת מקרי הבדיקה שעברו בהצלחה.
PerfettoGenericPostProcessor	מעבד פוסט (postor) שמעבד קובץ פרוטו של טקסט/מדד בינארי לצמדי מפתח-ערך, על ידי הרחבה רקורסיבית של הודעות ושדות של פרוטו עם ערכי מחרוזת עד שמוצאים את השדה עם ערך מספרי.
PerfettoPullerMetricCollector	הטמעת בסיס של `FilePullerDeviceMetricCollector` שמאפשרת לשלוף את קובצי Perfetto מהמכשיר ולאסוף ממנו את המדדים.
PrettyTestEventLogger	יומן שמתאים את האירועים ומתעדות אותם כדי להקל על ניפוי הבאגים.
ProtoResultReporter	דיווח על תוצאות יוצר protobuf של `TestRecord` עם כל התוצאות בפנים.
PythonBinaryHostTest.PythonForwarder	מעביר תוצאות כדי להחליף את שם ההרצה בשם הבינארי.
RebootReasonCollector	אוסף שאוסף הפעלה מחדש של המכשיר במהלך הרצת הבדיקה ומדווח עליהן לפי סיבה וספירה.
RemoteTestTimeOutEnforcer	מאזינים שמאפשרים לבדוק את זמן הביצוע של הגדרת בדיקה נתונה ולפסול אותה אם היא חורגת מזמן קצוב מראש.
ReportPassedTests	דיווח בקובץ על מסננים אפשריים להחרגת בדיקה שעברה.
ResultAggregator	שרת העברה מיוחד שמאגד את התוצאות לפי הצורך, על סמך שיטת הניסיון החוזר שנבחרה.
ResultAndLogForwarder	שירות העברה של תוצאות ואירועים ביומן.
ResultForwarder	`ITestInvocationListener` שמעביר את תוצאות ההפעלה לרשימה של מאזינים אחרים.
RetryLogSaverResultForwarder	העברה שמטפלת גם במעבר של הניסיון הנוכחי שאנחנו נמצאים בו.
RetryResultForwarder	תוסף של `ResultForwarder` שתמיד דוחף למספר ניסיון נתון.
RuntimeRestartCollector	אוסף שמאגר חותמות זמן של הפעלות מחדש בסביבת זמן הריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה.
ScreenshotOnFailureCollector	אמצעי איסוף נתונים שצילום מסך יתועד ויירשם ביומן כאשר מקרה בדיקה נכשל.
ShardListener	`ITestInvocationListener` שאוסף תוצאות מפיצול הפעלה (כלומר, חלוקת הפעלה להרצה במספר משאבים במקביל), ומעביר אותן למאזינים אחרים.
ShardMainResultForwarder	`ResultForwarder` שמאחד את התוצאות של הקריאות לבדיקה שמחולקות למקטעים.
ShowmapPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת למשוך את הקבצים של המפה הוויזואלית מהמכשיר ולאסוף ממנו את המדדים.
StatsdBeforeAfterGaugeMetricPostProcessor	מעבד נתונים לאחר האיסוף, שמטפל במדדי מדדים שנאספים בשיטה של 'לפני/אחרי', כלומר:
StatsdEventMetricPostProcessor	מעבד פוסט שממיר מדדי אירועים בדוחות של statsd לצמדי מפתח/ערך, באמצעות הפורמטרים שצוינו במעבד.
StatsdgenerativePostProcessor	מעבד פוסט שממיר דוחות בינאריים של proto statsd לזוגות מפתח/ערך על ידי הרחבת הדוח כמבנה עץ.
StreamProtoResultReporter	הטמעה של `ProtoResultReporter`
SubprocessResultsReporter	הטמעת `ITestInvocationListener` כדי לציין אותו בתור דיווח על תוצאות, והעברה מהתהליך המשני של תוצאות הבדיקות, הפעלות הבדיקות והפעלות הבדיקה.
SuiteresultsReporter	איסוף תוצאות הבדיקה של הרצת חבילה שלמה והצגת התוצאות הסופיות בפלט.
TestRunResultListener	מאזין שמאפשר לקרוא את סטטוס ההרצה הסופית של הבדיקה.
TestTimeoutEnforcer	מאזינים שמאפשרים לבדוק את זמן הביצוע של מקרה בדיקה נתון ולפסול אותו אם הוא חורג מזמן קצוב מראש.
TextResultReporter	דיווח על תוצאות בדיקה שמעביר את התוצאות למדפסת התוצאות בטקסט של JUnit.
TraceCmdCollector	`IMetricCollector` שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ומתעדה אותם ביומן של ההפעלה.
TradeifiedSandboxRunner.StubScheduledInvocationListener	הדמיה של `IScheduledInvocationListener` שלא עושה כלום.
XmlFormattedGeneratorReporter	הטמעה של `FormattedGeneratorReporter` שמעבירה את תוצאות הבדיקה בפורמט xml.
XmlresultReporter	כתיבת תוצאות של JUnit לקובצי XML בפורמט תואם ל-XMLJUnitResultFormatter של Ant.

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

סיכום

שיטות ציבוריות
`default void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` מספקת את נתוני היומן או נתוני ניפוי הבאגים המשויכים מהפעלת הבדיקה.

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

testLog

public 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.