IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


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

סיכום

שיעורים מקוננים

interface IDeviceManager.IFastbootListener

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

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

abstract void addDeviceMonitor ( IDeviceMonitor mon)

הוספת IDeviceMonitor

abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

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

abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

הוסף מכשיר לצג fastboot.

abstract ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

בקש מכשיר לבדיקה העומד בקריטריונים מסוימים.

abstract ITestDevice allocateDevice ( IDeviceSelection options)

בקש מכשיר לבדיקה העומד בקריטריונים מסוימים.

abstract ITestDevice allocateDevice ()

בקש מכשיר פיזי לבדיקה

abstract ITestDevice connectToTcpDevice (String ipAndPort)

התחבר למכשיר עם adb-over-tcp

שיטה זו מקצה מכשיר חדש, אשר בסופו של דבר צריך להיות משוחרר באמצעות disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

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

abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

נתק מהמכשיר המחובר ל- adb-over-tcp.

abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)

פלט רשימה המכיל תיאור ידידותי למשתמש מכשירים מוכרים, מדינתם, וערכים נפוצים IDeviceSelection אפשרויות.

abstract CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)

שיטת עזר לביצוע פקודת מעטפת במכשיר זמין.

abstract ITestDevice forceAllocateDevice (String serial)

הקצה מכשיר בכנות, גם אם אינו זמין כעת.

abstract void freeDevice (ITestDevice device, FreeDeviceState state)

החזר מכשיר לבריכה

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

abstract String getAdbPath ()

מחזירה את הנתיב לבינארי adb לשימוש.

abstract String getAdbVersion ()

קבל את גרסת ה- ADB הנמצאת כעת בשימוש על ידי מנהל ההתקנים.

abstract DeviceDescriptor getDeviceDescriptor (String serial)

מחזירה את DeviceDescriptor עם הסידורי הנתון.

abstract String getFastbootPath ()

מחזירה את הנתיב לבינארי fastboot לשימוש.

abstract void init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors)

אתחל את מנהל ההתקנים בעזרת מסנן התקנים.

abstract void init ()

אתחל את מנהל ההתקנים.

abstract boolean isEmulator (String serial)

קבע אם נתון סדרתי מייצג אמולטור

default boolean isFileSystemMountCheckEnabled ()

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

abstract boolean isNullDevice (String serial)

קבע אם הסדרה הנתונה מייצגת התקן null

abstract void killEmulator (ITestDevice device)

כבה את האמולטור הנתון.

abstract void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs)

שיטת עזר להפעלת אמולטור.

abstract listAllDevices ()

מחזירה רשימה של DeviceDescriptors לכל המכשירים המוכרים

abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

שיטה עוזר כי מעביר את התקן ה- USB הניתן ADB-יתר TCP מצב, ולאחר מכן מתחבר אליו באמצעות connectToTcpDevice(String) .

abstract void removeDeviceMonitor ( IDeviceMonitor mon)

מסיר הוסיף בעבר IDeviceMonitor .

abstract void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

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

abstract void restartAdbBridge ()

הפעל מחדש (אם stopAdbBridge() נקרא) ADB גשר ושירותים תלוי חיבורי ADB.

abstract void stopAdbBridge ()

עצור גשר adb ושירותים תלויים בחיבורי adb.

abstract void terminate ()

מפסיק את שירותי ניטור המכשירים ומסיים את ספריית ה- ddm.

abstract void terminateDeviceMonitor ()

עצור את צגי המכשיר.

abstract void terminateDeviceRecovery ()

עוצר את שרשור שחזור המכשיר.

default void terminateHard (String reason)

כמו terminateHard() .

abstract void terminateHard ()

כמו terminate() , אך ניסיונות בכוח לסגור ADB וכן.

abstract boolean waitForFirstDeviceAdded (long timeout)

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

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

addDeviceMonitor

public abstract void addDeviceMonitor (IDeviceMonitor mon)

הוספת IDeviceMonitor

פרמטרים
mon IDeviceMonitor

addFastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

נכון לעכשיו IDeviceManager יהיה רק לנטר מכשירים ב fastboot אם יש אחד או יותר מאזינים פעילים.

TODO: זה קצת פריצה - מצא פתרון טוב יותר

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

הוסף מכשיר לצג fastboot. צג fastboot ישתמש ב- 'fastboot_serial' כדי לתקשר עם המכשיר.

פרמטרים
serial String : את המספר הסידורי של המכשיר.

fastboot_serial String : את המספר הסידורי fastboot המצב של המכשיר.

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

בקש מכשיר לבדיקה העומד בקריטריונים מסוימים.

פרמטרים
options IDeviceSelection : את IDeviceSelection המכשיר אמור לפגוש.

isTemporary boolean : אם לא NullDevice זמני צריכה להיווצר.

החזרות
ITestDevice ITestDevice לבדיקה, או null אם אחד אינו זמין

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options)

בקש מכשיר לבדיקה העומד בקריטריונים מסוימים.

פרמטרים
options IDeviceSelection : את IDeviceSelection המכשיר אמור לפגוש.

החזרות
ITestDevice ITestDevice לבדיקה, או null אם אחד אינו זמין

allocateDevice

public abstract ITestDevice allocateDevice ()

בקש מכשיר פיזי לבדיקה

החזרות
ITestDevice ITestDevice לבדיקה, או null אם אחד אינו זמין

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

התחבר למכשיר עם adb-over-tcp

שיטה זו מקצה מכשיר חדש, אשר בסופו של דבר צריך להיות משוחרר באמצעות disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

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

שים לב כי ביצוע פעולה כגון אתחול מחדש במכשיר מחובר TCP, תנתק את חיבור TCP למכשיר, והתוצאה DeviceNotAvailableException

פרמטרים
ipAndPort String : כתובת ה- IP המקורית והנמל של המכשיר כדי להתחבר

החזרות
ITestDevice ITestDevice או null אם חיבור TCP לא יכול להיווצר

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

נתק מהמכשיר המחובר ל- adb-over-tcp.

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

פרמטרים
tcpDevice ITestDevice : המכשיר כיום TCP מצב, שהוקצו בעבר באמצעות connectToTcpDevice(String)

החזרות
boolean true אם המתג למצב USB היה מוצלח

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

פלט רשימה המכיל תיאור ידידותי למשתמש מכשירים מוכרים, מדינתם, וערכים נפוצים IDeviceSelection אפשרויות.

פרמטרים
printWriter PrintWriter : את ERROR(/PrintWriter) פלט את התיאור

includeStub boolean : בין אם לאו למכשירי בדל תצוגה מדי.

executeCmdOnAvailableDevice

public abstract CommandResult executeCmdOnAvailableDevice (String serial, 
                String command, 
                long timeout, 
                TimeUnit timeUnit)

שיטת עזר לביצוע פקודת מעטפת במכשיר זמין.

פרמטרים
serial String : The סדר המכשיר.

command String : התסריט.

timeout long : משך הזמן עבור הפקודה כדי להשלים.

timeUnit TimeUnit : היחידה עבור פסק זמן.

החזרות
CommandResult CommandResult .

forceAlocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

הקצה מכשיר בכנות, גם אם אינו זמין כעת.

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

פרמטרים
serial String : סדר המכשיר להקצות

החזרות
ITestDevice ITestDevice , או null אם זה לא יכול להיות מוקצה

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

החזר מכשיר לבריכה

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

פרמטרים
device ITestDevice : את ITestDevice כדי בחינם

state FreeDeviceState : את FreeDeviceState . משמש לבקרה אם המכשיר יוחזר למאגר המכשירים הזמין.

getAdbPath

public abstract String getAdbPath ()

מחזירה את הנתיב לבינארי adb לשימוש.

החזרות
String

getAdbVersion

public abstract String getAdbVersion ()

קבל את גרסת ה- ADB הנמצאת כעת בשימוש על ידי מנהל ההתקנים.

החזרות
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

מחזירה את DeviceDescriptor עם הסידורי הנתון.

פרמטרים
serial String : מספר סידורי של המכשיר כדי לקבל

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

getFastbootPath

public abstract String getFastbootPath ()

מחזירה את הנתיב לבינארי fastboot לשימוש.

החזרות
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

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

פרמטרים
globalDeviceFilter IDeviceSelection : מסנן המכשיר

deviceMonitors

init

public abstract void init ()

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

isEmulator

public abstract boolean isEmulator (String serial)

קבע אם נתון סדרתי מייצג אמולטור

פרמטרים
serial String

החזרות
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

החזרות
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

קבע אם הסדרה הנתונה מייצגת התקן null

פרמטרים
serial String

החזרות
boolean

emulator kill

public abstract void killEmulator (ITestDevice device)

כבה את האמולטור הנתון.

חוסם עד שהאמולטור נעלם מ- adb. לא תהיה השפעה אם אמולטור כבר אינו זמין.

פרמטרים
device ITestDevice : את ITestDevice המייצג אמולטור לסגור

זורק
DeviceNotAvailableException אם האמולטור נכשל

אמולטור ההשקה

public abstract void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                 emulatorArgs)

שיטת עזר להפעלת אמולטור.

יפעיל את האמולטור כפי שצוין על ידי המתקשר

פרמטרים
device ITestDevice : לממלא המקום ITestDevice מייצג תקן אמולטור שהוקצה

bootTimeout long : זמן ms לחכות אמולטור כדי אתחול

emulatorArgs : ארגומנטים של שורת הפקודה להפעלת האמולטור

זורק
DeviceNotAvailableException אם האמולטור לא מצליח לאתחל או להיכנס לאינטרנט

listAllDevices

public abstract  listAllDevices ()

מחזירה רשימה של DeviceDescriptors לכל המכשירים המוכרים

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

חבר מחדש את DeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

שיטה עוזר כי מעביר את התקן ה- USB הניתן ADB-יתר TCP מצב, ולאחר מכן מתחבר אליו באמצעות connectToTcpDevice(String) .

פרמטרים
usbDevice ITestDevice : המכשיר כרגע במצב USB

החזרות
ITestDevice הקצתה לאחרונה ITestDevice במצב TCP או null אם חיבור TCP לא יכול להיווצר

זורק
DeviceNotAvailableException אם החיבור עם usbDevice אבד ולא יכול להיות התאושש

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

מסיר הוסיף בעבר IDeviceMonitor . אין לו השפעה אם לא נוספה mon.

פרמטרים
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

restartAdbBridge

public abstract void restartAdbBridge ()

הפעל מחדש (אם stopAdbBridge() נקרא) ADB גשר ושירותים תלוי חיבורי ADB.

stopAdbBridge

public abstract void stopAdbBridge ()

עצור גשר adb ושירותים תלויים בחיבורי adb.

לבטל, לסיים

public abstract void terminate ()

מפסיק את שירותי ניטור המכשירים ומסיים את ספריית ה- ddm.

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

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

עצור את צגי המכשיר.

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

עוצר את שרשור שחזור המכשיר.

לסיים קשה

public void terminateHard (String reason)

כמו terminateHard() .

פרמטרים
reason String : הסיבה אופציונלי נתון לסיום.

לסיים קשה

public abstract void terminateHard ()

כמו terminate() , אך ניסיונות בכוח לסגור ADB וכן.

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

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

פרמטרים
timeout long : זמן לחכות אלפית שני לפני החזרת שווא.

החזרות
boolean