מנהל התקן

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Object
com.android.tradefed.device.DeviceManager


סיכום

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

class DeviceManager.FastbootDevice

ייצוג של מכשיר במצב Fastboot.

שדות

public static final String UNKNOWN_DISPLAY_STRING

מחרוזת תצוגה עבור נכסים לא ידועים

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

בוני ציבור

DeviceManager ()

DeviceManager אמור להיגזר מן GlobalConfiguration

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

void addAvailableDevice (IDevice stubDevice)
void addDeviceMonitor ( IDeviceMonitor mon)

הוספת IDeviceMonitor

void addFastbootListener ( IDeviceManager.IFastbootListener listener)

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

void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

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

ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

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

ITestDevice allocateDevice ( IDeviceSelection options)

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

ITestDevice allocateDevice ()

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

ITestDevice connectToTcpDevice (String ipAndPort)

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

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

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

boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

void displayDevicesInfo (PrintWriter stream, boolean includeStub)

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

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

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

String executeGlobalAdbCommand (String... cmdArgs)

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

ITestDevice forceAllocateDevice (String serial)

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

void freeDevice (ITestDevice device, FreeDeviceState deviceState)

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

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

String getAdbPath ()

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

String getAdbVersion ()

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

DeviceDescriptor getDeviceDescriptor (String serial)

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

String getFastbootPath ()

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

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

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

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

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

void init ()

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

boolean isEmulator (String serial)

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

boolean isFileSystemMountCheckEnabled ()

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

boolean isNullDevice (String serial)

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

void killEmulator (ITestDevice device)

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

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

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

listAllDevices ()

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

ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

void removeDeviceMonitor ( IDeviceMonitor mon)

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

void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

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

void restartAdbBridge ()

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

void stopAdbBridge ()

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

void terminate ()

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

void terminateDeviceMonitor ()

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

void terminateDeviceRecovery ()

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

void terminateHard (String reason)

כמו terminateHard() .

void terminateHard ()

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

boolean waitForFirstDeviceAdded (long timeout)

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

שדות

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

מחרוזת תצוגה עבור נכסים לא ידועים

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

בוני ציבור

מנהל התקן

public DeviceManager ()

DeviceManager אמור להיגזר מן GlobalConfiguration

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

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

פרמטרים
stubDevice IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

הוספת IDeviceMonitor

פרמטרים
mon IDeviceMonitor

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

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

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

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

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

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

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

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

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

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

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options)

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

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

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

allocateDevice

public ITestDevice allocateDevice ()

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

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

connectToTcpDevice

public 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 boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

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

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

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

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

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

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

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

executeCmdOnAvailableDevice

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

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

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

command String : התסריט.

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

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

החזרות
CommandResult CommandResult .

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

בצע פקודת adb שאינה ממוקדת למכשיר מסוים, למשל. 'adb connect'

החזרות
String פלט std אם הפקודה מצליח null אחרת.

forceAlocateDevice

public ITestDevice forceAllocateDevice (String serial)

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

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

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

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

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

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

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

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

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

getAdbPath

public String getAdbPath ()

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

החזרות
String

getAdbVersion

public String getAdbVersion ()

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

החזרות
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

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

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

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

getFastbootPath

public String getFastbootPath ()

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

החזרות
String

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

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

פרמטרים
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

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

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

globalDeviceMonitors

init

public void init ()

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

isEmulator

public boolean isEmulator (String serial)

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

פרמטרים
serial String

החזרות
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

החזרות
boolean

isNullDevice

public boolean isNullDevice (String serial)

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

פרמטרים
serial String

החזרות
boolean

emulator kill

public void killEmulator (ITestDevice device)

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

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

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

זורק
DeviceNotAvailableException

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

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

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

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

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

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

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

זורק
DeviceNotAvailableException

listAllDevices

public  listAllDevices ()

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

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

חבר מחדש את DeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

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

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

זורק
DeviceNotAvailableException

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

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

פרמטרים
mon IDeviceMonitor

removeFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

restartAdbBridge

public void restartAdbBridge ()

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

stopAdbBridge

public void stopAdbBridge ()

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

לבטל, לסיים

public void terminate ()

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

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

terminateDeviceMonitor

public void terminateDeviceMonitor ()

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

terminateDeviceRecovery

public void terminateDeviceRecovery ()

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

לסיים קשה

public void terminateHard (String reason)

כמו terminateHard() .

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

לסיים קשה

public void terminateHard ()

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

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

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

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

החזרות
boolean