החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

דף זה תורגם על ידי 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, ‏ CodeCoverageCollector, ועוד 83 אחרים.

AggregatePostProcessor	מצבר מדדים שמציג את הערכים הבאים: מינימום, מקסימום, ממוצע, שונות, סטיית תקן, סה"כ, ספירה ואחוזונים (אופציונלי) של מדדים מספריים שנאספו במהלך הפעלות בדיקה מרובות איטרציות, תוך התייחסות אליהם כאל מספרים ממשיים.
AtraceCollector	‫`IMetricCollector` שמופעל במהלך בדיקה, אוסף את התוצאה ומתעד אותה ביומן של הקריאה.
AtraceRunMetricCollector	איסוף העקבות מכל ספריית הבדיקה בספרייה הנתונה ממכשיר הבדיקה, רישום ספריית הבדיקה ועיבוד שלאחר האיסוף של קובצי העקבות בספריית הבדיקה וצבירת המדדים.
AveragePostProcessor	הטמעה של מעבד פוסט שחישב את הממוצע של רשימת המדדים.
BaseDeviceMetricCollector	הטמעה בסיסית של `IMetricCollector` שמאפשרת להתחיל ולהפסיק את האיסוף ב-`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` וב-`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
BasePostProcessor	הבסיס `IPostProcessor` שכל הטמעה צריכה להרחיב.
‫BluetoothConnectionLatencyCollector	הכלי לאיסוף נתונים ישלח למכשירים הגדרה מוגדרת מראש של מדד משך זמן ב-statsd, ויאסוף את משך החיבור ב-Bluetooth לכל פרופיל.
‫BluetoothConnectionStateCollector	הכלי הזה יאסוף מדדים של BluetoothConnectionStateChanged ויתעד את מספר מצב החיבור לכל פרופיל.
BluetoothConnectionSuccessRatePostProcessor	הטמעה של מעבד שאחרי העיבוד שמחשב את שיעור ההצלחה של פרופיל Bluetooth משתמשים ב-metric-key-match כדי לציין מדדים שמכילים מצבי חיבור Bluetooth במערך מספרי. דוגמה [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	כלי איסוף להפעלת רישום Snoop עבור HCI של Bluetooth ב-DUT ולאיסוף היומן לכל בדיקה.
BugreportCollector	רכיב `ITestInvocationListener` מסוג pass-through שאוסף דוחות על באגים כשמתרחשים אירועים שאפשר להגדיר, ואז קורא ל-`ITestInvocationListener.testLog` ברכיבי הצאצא שלו אחרי שכל דוח על באג נאסף.
BugreportzOnFailureCollector	איסוף דוח על באג (bugreportz) כשמקרה בדיקה נכשל.
BugreportzOnTestCaseFailureCollector	איסוף של bugreportz כשמקרה בדיקה בהרצה נכשל.
ClangCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Clang מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
CodeCoverageCollector	`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Java ושל קוד מקורי מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
CollectingTestListener	`ITestInvocationListener` שיאסוף את כל תוצאות הבדיקה.
CommandStatusHandler	רכיב Handler שעוזר לעקוב אחרי הסטטוס של קריאה לפונקציה ולעדכן אותו.
ConditionFailureMonitor	עוקבים אחרי כל הכשלים מהקריאה.
ConsoleResultReporter	כלי לדיווח על תוצאות, להדפסת תוצאות הבדיקה במסוף.
CountTestCasesCollector	לספור ולדווח על מספר המקרים לבדיקה עבור `IRemoteTest` נתון.
DebugHostLogOnFailureCollector	כלי לאיסוף ולרישום של יומני הצד של המארח כשמתרחשת שגיאה בתרחיש בדיקה.
DeviceReleaseReporter	כלי לדיווח על שחרור מכשירים שמטפל בתקשורת עם תהליך האב של המכשירים שצריך לשחרר.
DeviceTraceCollector	כלי לאיסוף נתונים שמתחיל מעקב ב-Perfetto כשמתחילים להריץ בדיקה, ומתעד את קובץ המעקב בסוף.
DeviceUnavailableMonitor	המאזין הזה מנסה לתעד רק DNAE ברמת תרחיש הבדיקה.
EventsLoggerListener	רכיב Listener שמתעד את כל האירועים שהוא מקבל בקובץ
FileProtoResultReporter	כלי ליצירת דוחות בפורמט Proto שמייצא את `TestRecord` לקובץ.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` שמקשיב למפתח המדדים שמגיע מהמכשיר ושולף אותם כקובץ מהמכשיר.
FilePullerLogCollector	כלי לרישום ביומן של הקובץ שדווח בצד המכשיר.
FilteredResultForwarder	וריאציה של `ResultForwarder` שמאפשרת דיווח רק על `TestDescription` שנמצאים ברשימת ההיתרים.
FormattedGeneratorReporter	כלי ליצירת דוחות שמאפשר ליצור דוחות בפורמט מסוים.
GcovCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של gcov מהמכשיר וירשום אותם כארטיפקטים של הבדיקה.
GcovKernelCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של ליבת gcov מ-debugfs ומחוץ למכשיר, ולבסוף ירשום אותם כארטיפקטים של בדיקה.
GranularRetriableTestWrapper.StartEndCollector	כלי עזר לשיעור שיעזור לכם לזהות מקרים שבהם חסרים נתוני התחלה וסיום של ריצה.
HostStatsdMetricCollector	‫`IMetricCollector` שאוסף מדדי statsd מצד המארח באמצעות פקודות של כלי statsd.
ICommandScheduler.IScheduledInvocationListener	‫Listener לאירועי הפעלה כשההפעלה מסתיימת.
ILogSaverListener	מאפשר ל-`ITestInvocationListener` להאזין למצב שבו קובצי יומן נשמרים.
IMetricCollector	הממשק הזה יתווסף כ-decorator כשמדווחים על תוצאות של בדיקות, כדי לאסוף מדדים תואמים.
IPostProcessor	מעבדי פוסט הם אובייקט של Trade Federation שנועד לאפשר עיבוד של מדדים ויומנים אחרי הבדיקות ולפני דיווח התוצאות.
IShardableListener	`ITestInvocationListener` שאפשר לפצל.
ISupportGranularResults	ממשק שמציין אם `ITestInvocationListener` תומך בקבלת תוצאות מפורטות או לא.
ITestInvocationListener	מאזין לתוצאות הבדיקה מהפעלת הבדיקה.
ITestSummaryListener	ממשק שמאפשר ל-`ITestInvocationListener` להחליף מידע מוגבל באמצעות סיכומים.
InvocationProtoResultReporter	הכלי Reporters לאחסון מידע על שמירת נתונים במטמון ברמת ההפעלה ורשימת המודולים שלו
InvocationToJUnitResultForwarder	מחלקה שמקשיבה לאירועים מסוג `ITestInvocationListener` ומעבירה אותם אל `TestListener`.
JarHostTest.HostTestListener	מאזין עוטף שמעביר את כל האירועים, למעט testRunStarted()‎ ו-testRunEnded()‎, אל המאזין המוטמע.
JavaCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Java מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
JsonHttpTestResultReporter	כלי לדיווח על תוצאות שמקודד את תוצאות המדדים של הבדיקה ואת פרטי הענף והמכשיר ל-JSON, ושולח אותם לנקודת קצה של שירות HTTP
LUCIResultReporter	כלי לדיווח על תוצאות ששומר את תוצאות הבדיקה שנדרשות על ידי ResultDB ו-LUCI בפורמט JSON (go/result-sink) ומתעד את מיקום הקובץ במסוף.
LastShardDetector	כשמפעילים חלוקה מקומית, לפעמים רוצים לבצע פעולות מסוימות רק כשמגיעים לשבר האחרון של `invocationEnded(long)`.
LegacySubprocessResultsReporter	הטמעה קפואה של כלי הדיווח על תוצאות תהליכי המשנה, שאמור להישאר תואם לגרסאות קודמות של TF/CTS (למשל 8 ומעלה), למרות שינויים במחלקת העל שלו.
LogSaverResultForwarder	`ResultForwarder` לשמירת יומנים באמצעות הכלי הגלובלי לשמירת קבצים.
LogcatCrashResultForwarder	מאזין מיוחד: במקרה של כשלים (קריסה של תהליך המדידה), המאזין ינסה לחלץ את הקריסה מ-logcat ולהוסיף אותה להודעת הכשל שמשויכת לבדיקה.
LogcatOnFailureCollector	כלי לאיסוף נתונים שיתעד וישמור יומן של logcat אם מקרה הבדיקה ייכשל.
LogcatTimingMetricCollector	כלי לאיסוף מדדים שאוסף נתוני תזמון (למשל זמן המעבר בין משתמשים) מ-logcat במהלך בדיקה אחת או יותר שחוזרות על עצמן, באמצעות דפוסי regex נתונים לניתוח אותות התחלה וסיום של אירוע משורות logcat.
MetricFilePostProcessor	הפרמטר הזה משמש להעלאת קובץ יומן המדדים שנאסף במהלך הבדיקה וברמת ההרצה.
MetricsXMLResultReporter	‫MetricsXMLResultReporter כותב מדדי בדיקה ומדדי הרצה לקובץ XML בתיקייה שצוינה על ידי הפרמטר metrics-folder בשלב invocationEnded של הבדיקה.
ModuleListener	מאזין מצורף לכל `IRemoteTest` של כל מודול כדי לאסוף את רשימת התוצאות.
ModuleLogcatCollector	גרסה של הכלי לאיסוף נתוני logcat, אבל עבור מודול.
ModuleProtoResultReporter	כלי לדיווח על תוצאות שנועד לדווח רק על תוצאות ברמת המודול.
ModuleResultsAndMetricsForwarder	תוסף של `ResultAndLogForwarder` שמוסיף לממצאי הבדיקה מדדים נוספים שקשורים למודול.
NameMangleListener	מאזין פרוקסי לתרגום של שמות שיטות, מחלקות וחבילות של בדיקות בזמן הדיווח על התוצאות.
PassingTestFileReporter	`ITestInvocationListener` ששומר את רשימת מקרי הבדיקה שעברו בהצלחה בקובץ בדיקה
PerfettoFilePullerCollector	כלי לאיסוף נתונים ששולף קובצי מעקב של Perfecto מהמכשיר, דוחס אותם (אופציונלי) ומוסיף אותם ליומני הבדיקה.
PerfettoGenericPostProcessor	מעבד פוסט שמעבד קובץ פרוטו של מדד טקסט/בינארי של perfetto לצמדי מפתח/ערך על ידי הרחבה רקורסיבית של הודעות ושדות פרוטו עם ערכי מחרוזת עד שנתקלים בשדה עם ערך מספרי.
PerfettoPullerMetricCollector	הכיתה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-`PerfettoFilePullerCollector` וב-`ERROR(/PerfettoTracePostProcessor)`.
PerfettoTracePostProcessor	מעבד פוסט שמאחזר קובצי מעקב של Perfecto מיומני הבדיקה ומריץ עליהם את מעבד המעקב כדי ליצור פרוטוקול מדדים של Perfecto.
PrettyTestEventLogger	הכלי Logger מתאים לאירועים ומתעד אותם כדי להקל על ניפוי הבאגים.
ProtoResultReporter	הכלי Result reporter יוצר `TestRecord` protobuf עם כל התוצאות.
PtsBotTest	הרצת בדיקות של PTS-bot.
PythonBinaryHostTest.PythonForwarder	העברת תוצאות כדי להחליף את שם ההרצה בשם הבינארי.
‫RebootReasonCollector	כלי לאיסוף נתונים שאוסף נתונים על הפעלה מחדש של המכשיר במהלך הרצת הבדיקה ומדווח עליהם לפי סיבה ומספר.
RemoteTestTimeOutEnforcer	רכיבי Listener שמאפשרים לבדוק את זמן הביצוע של הגדרת בדיקה מסוימת, ולגרום לכך שהבדיקה תיכשל אם היא חורגת מזמן קצוב מסוים.
ReportPassedTests	דיווח בקובץ על מסננים אפשריים להחרגה של בדיקה שעברה.
ResultAggregator	מעביר מיוחד שמרכז את התוצאות כשצריך, על סמך אסטרטגיית הניסיון החוזר שנבחרה.
ResultAndLogForwarder	מעביר תוצאות ואירועים ביומן.
ResultDBReporter	כלי לדיווח על תוצאות שמעלה את תוצאות הבדיקה ל-ResultDB.
ResultForwarder	‫`ITestInvocationListener` שמעביר את תוצאות ההפעלה לרשימה של מאזינים אחרים.
ResultReporter
RetryLogSaverResultForwarder	העברה שמטפלת גם בהעברת הניסיון הנוכחי שאנחנו נמצאים בו.
RetryResultForwarder	תוסף של `ResultForwarder` שתמיד דוחף למספר ניסיון נתון.
RuntimeRestartCollector	כלי לאיסוף נתונים שאוסף חותמות זמן של הפעלות מחדש של זמן ריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה.
‫ScreenshotOnFailureCollector	כלי לאיסוף נתונים שיצלם צילום מסך וירשום אותו ביומן כשהתרחיש לבדיקה ייכשל.
ShardListener	‫`ITestInvocationListener` שאוסף תוצאות משבר הפעלה (כלומר, פיצול של הפעלה להרצה במקביל בכמה משאבים) ומעביר אותן למאזין אחר.
ShardMainResultForwarder	‫`ResultForwarder` שמשלב את התוצאות של הפעלות בדיקה עם חלוקה למקטעים.
ShowmapPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת לשלוף את קובצי showmap מהמכשיר ולאסוף ממנו את המדדים.
StatsdBeforeAfterGaugeMetricPostProcessor	מעבד פוסט שמעבד מדדים של מדדים שנאספו בגישת 'לפני/אחרי', כלומר
StatsdEventMetricPostProcessor	מעבד פוסט שמעבד מדדי אירועים בדוחות statsd לצמדי מפתח/ערך, באמצעות מעצבי הפורמט שצוינו במעבד.
StatsdGenericPostProcessor	מעבד פוסט שמעבד דוחות statsd של פרוטוקול בינארי לצמדי מפתח/ערך על ידי הרחבת הדוח כמבנה עץ.
StreamProtoResultReporter	הטמעה של `ProtoResultReporter`
SubprocessResultsReporter	מטמיע את `ITestInvocationListener` כדי לציין אותו כ-result_reporter ולהעביר מתהליך המשנה את תוצאות הבדיקות, הרצות הבדיקות והפעלות הבדיקות.
SuiteResultReporter	איסוף תוצאות הבדיקה עבור הפעלה של חבילה שלמה והצגת התוצאות הסופיות.
TestRunResultListener	מאזין שמאפשר לקרוא את הסטטוס הסופי של הרצת הבדיקה.
TestTimeoutEnforcer	רכיבי Listener שמאפשרים לבדוק את זמן הביצוע של תרחיש בדיקה מסוים ולסמן אותו כנכשל אם הוא חורג מזמן קצוב מסוים.
TextResultReporter	כלי לדיווח על תוצאות בדיקה שמעביר את התוצאות למדפיס תוצאות הטקסט של JUnit.
TraceCmdCollector	`IMetricCollector` שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ומתעד אותם ביומן של הקריאה.
TradefedSandboxRunner.StubScheduledInvocationListener	פונקציית placeholder‏ `IScheduledInvocationListener` שלא עושה כלום.
XmlFormattedGeneratorReporter	הטמעה של `FormattedGeneratorReporter` באיזה פורמט התוצאות של החבילה בפורמט xml
XmlResultReporter	כותב תוצאות של JUnit לקובצי XML בפורמט שתואם ל-XMLJUnitResultFormatter של Ant.

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

סיכום

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

‫methods ציבוריים

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 לא יהיה ייחודי לכל הפעלה. כלומר, המטמיעים צריכים להיות מסוגלים לטפל בכמה קריאות עם אותו dataName
`dataType`	‫`LogDataType`: `LogDataType` של הנתונים
`dataStream`	`InputStreamSource`: `InputStreamSource` הנתונים. המטמיעים צריכים לקרוא ל-createInputStream כדי להתחיל לקרוא את הנתונים, ולוודא שהם סוגרים את InputStream שמתקבל בסיום. המתקשרים צריכים לוודא שמקור הנתונים נשאר נוכח ונגיש עד שהשיטה testLog מסתיימת.