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

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

IDeviceActionReceiver

public interface IDeviceActionReceiver

com.android.tradefed.device.IDeviceActionReceiver

מחלקות משנה לא ישירות ידועות

‫AtraceCollector,‏ AtraceRunMetricCollector,‏ BaseDeviceMetricCollector,‏ BluetoothConnectionLatencyCollector,‏ BluetoothConnectionStateCollector,‏ BluetoothHciSnoopLogCollector,‏ BugreportzOnFailureCollector,‏ BugreportzOnTestCaseFailureCollector,‏ ClangCodeCoverageCollector,‏ CodeCoverageCollector,‏ CountTestCasesCollector,‏ DebugHostLogOnFailureCollector,‏ DeviceTraceCollector,‏ FilePullerDeviceMetricCollector,‏ FilePullerLogCollector ועוד 14 אחרים.

‫AtraceCollector	‫`IMetricCollector` שמופעל במהלך בדיקה, אוסף את התוצאה ומתעד אותה ביומן של הקריאה.
AtraceRunMetricCollector	איסוף העקבות מכל ספריית הבדיקה בספרייה הנתונה ממכשיר הבדיקה, רישום ספריית הבדיקה ועיבוד שלאחר האיסוף של קובצי העקבות בספריית הבדיקה וצבירת המדדים.
BaseDeviceMetricCollector	הטמעה בסיסית של `IMetricCollector` שמאפשרת להתחיל ולהפסיק את האיסוף ב-`onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` וב-`ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))`.
‫BluetoothConnectionLatencyCollector	הכלי לאיסוף נתונים ישלח למכשירים הגדרה מוגדרת מראש של מדד משך זמן ב-statsd, ויאסוף את משך החיבור ב-Bluetooth לכל פרופיל.
‫BluetoothConnectionStateCollector	הכלי הזה יאסוף מדדים של BluetoothConnectionStateChanged ויתעד את מספר מצב החיבור לכל פרופיל.
BluetoothHciSnoopLogCollector	כלי איסוף להפעלת רישום Snoop עבור HCI של Bluetooth ב-DUT ולאיסוף היומן לכל בדיקה.
BugreportzOnFailureCollector	איסוף דוח על באג (bugreportz) כשמקרה בדיקה נכשל.
BugreportzOnTestCaseFailureCollector	איסוף של bugreportz כשמקרה בדיקה בהרצה נכשל.
ClangCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Clang מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
CodeCoverageCollector	`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Java ושל קוד מקורי מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
CountTestCasesCollector	ספירה ודיווח של מספר המקרים לבדיקה עבור `IRemoteTest` נתון.
DebugHostLogOnFailureCollector	כלי לאיסוף ולרישום של יומני הצד של המארח כשמתרחשת שגיאה בתרחיש בדיקה.
DeviceTraceCollector	כלי לאיסוף נתונים שמתחיל מעקב ב-Perfetto כשמתחילים להריץ בדיקה, ומתעד את קובץ המעקב בסוף.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` שמקשיב למפתח המדדים שמגיע מהמכשיר ושולף אותם כקובץ מהמכשיר.
FilePullerLogCollector	כלי לרישום ביומן של הקובץ שדווח בצד המכשיר.
GcovCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של gcov מהמכשיר וירשום אותם כארטיפקטים של הבדיקה.
GcovKernelCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של ליבת gcov מ-debugfs ומחוץ למכשיר, ולבסוף ירשום אותם כארטיפקטים של בדיקה.
HostStatsdMetricCollector	‫`IMetricCollector` שאוסף מדדי statsd מצד המארח באמצעות פקודות של כלי statsd.
JavaCodeCoverageCollector	‫`BaseDeviceMetricCollector` שימשוך את נתוני הכיסוי של Java מהמכשיר וירשום אותם כארטיפקטים של בדיקה.
LogcatOnFailureCollector	כלי לאיסוף נתונים שיאסוף ויתעד logcat אם מקרה בדיקה ייכשל.
LogcatTimingMetricCollector	כלי לאיסוף מדדים שאוסף נתוני תזמון (למשל, זמן המעבר בין משתמשים) מ-logcat במהלך בדיקה אחת או יותר שחוזרות על עצמן, באמצעות דפוסי ביטוי רגולרי שמוגדרים מראש כדי לנתח אותות התחלה וסיום של אירוע משורות logcat.
ModuleLogcatCollector	גרסה של הכלי לאיסוף נתוני logcat, אבל עבור מודול.
PerfettoFilePullerCollector	כלי לאיסוף נתונים ששולף קובצי מעקב של Perfecto מהמכשיר, דוחס אותם (אופציונלי) ומוסיף אותם ליומני הבדיקה.
PerfettoPullerMetricCollector	הכיתה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-`PerfettoFilePullerCollector` וב-`ERROR(/PerfettoTracePostProcessor)`.
‫RebootReasonCollector	כלי לאיסוף נתונים שאוסף נתונים על הפעלה מחדש של המכשיר במהלך הרצת הבדיקה ומדווח עליהם לפי סיבה ומספר.
RuntimeRestartCollector	כלי לאיסוף נתונים שאוסף חותמות זמן של הפעלות מחדש של זמן ריצה (קריסות של שרת המערכת) במהלך הרצת הבדיקה, אם יש כאלה.
‫ScreenshotOnFailureCollector	כלי לאיסוף נתונים שיצלם צילום מסך וירשום אותו ביומן כשהתרחיש לבדיקה ייכשל.
ShowmapPullerMetricCollector	הטמעה בסיסית של `FilePullerDeviceMetricCollector` שמאפשרת לשלוף את קובצי showmap מהמכשיר ולאסוף ממנו את המדדים.
TraceCmdCollector	`IMetricCollector` שאוסף עקבות במהלך הבדיקה באמצעות trace-cmd, ומתעד אותם ביומן של הקריאה.

מספק API לקבלת אירועים במכשיר.

הערה: בשלב הזה, האפשרות הזו נתמכת רק עבור כלי איסוף מדדים.

סיכום

‫methods ציבוריים
`default boolean`	`isDisabledReceiver()` האם `IDeviceActionReceiver` מושבת או לא.
`abstract void`	`rebootEnded(ITestDevice device)` קבלת התראה כשההפעלה מחדש מסתיימת במכשיר.
`abstract void`	`rebootStarted(ITestDevice device)` מקבל התראה כשההפעלה מחדש מתחילה במכשיר.
`abstract void`	`setDisableReceiver(boolean isDisabled)` ההגדרה הזו קובעת אם להשבית את `IDeviceActionReceiver`.

‫methods ציבוריים

isDisabledReceiver

public boolean isDisabledReceiver ()

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

החזרות
`boolean`	הפונקציה מחזירה את הערך True אם ההגדרה מושבתת, אחרת היא מחזירה את הערך False.

rebootEnded

public abstract void rebootEnded (ITestDevice device)

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

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

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

זריקות
`DeviceNotAvailableException`

rebootStarted

public abstract void rebootStarted (ITestDevice device)

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

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

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

זריקות
`DeviceNotAvailableException`

setDisableReceiver

public abstract void setDisableReceiver (boolean isDisabled)

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

פרמטרים
`isDisabled`	`boolean`