DeviceManager

public class DeviceManager
extends Object implements IDeviceManager

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

खास जानकारी

नेस्टेड क्लास

class DeviceManager.FastbootDevice

यह क्लास, फ़ास्टबूट मोड (Fastboot mode) में मौजूद डिवाइस को दिखाती है. 

कॉन्स्टेंट

String UNKNOWN_DISPLAY_STRING

ऐसी प्रॉपर्टी के लिए डिसप्ले स्ट्रिंग जिनकी जानकारी नहीं है

फ़ील्ड

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

सार्वजनिक कंस्ट्रक्टर

DeviceManager()

DeviceManager को GlobalConfiguration से वापस पाना चाहिए

पब्लिक मेथड

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

IDeviceMonitor जोड़ता है

void addFastbootDevice(DeviceManager.FastbootDevice fastbootDevice)
void addFastbootListener(IDeviceManager.IFastbootListener listener)

यह कुकी, मैनेजर को सूचना देती है कि लिसनर को फ़ास्टबूट की स्थिति में होने वाले बदलावों में दिलचस्पी है.

void addMonitoringTcpFastbootDevice(String serial, String fastbootSerial)

फ़ास्टबूट मॉनिटर में कोई डिवाइस जोड़ें.

ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

टेस्टिंग के लिए ऐसा डिवाइस पाने का अनुरोध करें जो कुछ शर्तों को पूरा करता हो.

ITestDevice allocateDevice(IDeviceSelection options)

टेस्टिंग के लिए ऐसा डिवाइस पाने का अनुरोध करें जो कुछ शर्तों को पूरा करता हो.

ITestDevice allocateDevice()

टेस्टिंग के लिए किसी फ़िज़िकल डिवाइस का अनुरोध करना

ITestDevice connectToTcpDevice(String ipAndPort)

adb-over-tcp की मदद से किसी डिवाइस से कनेक्ट करना

इस तरीके से एक नया डिवाइस असाइन किया जाता है. इसे आखिर में disconnectFromTcpDevice(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()

यह फ़ास्टबूट बाइनरी का इस्तेमाल करने के लिए पाथ दिखाता है.

long getShellCheckCmdTime()

शेल की उपलब्धता की जांच करने वाले कमांड के टाइमआउट को मिलीसेकंड में दिखाता है.

void init(IDeviceSelection globalDeviceFilter, List<IDeviceMonitor> globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

डिवाइस मैनेजर को शुरू करें.

void init(IDeviceSelection globalDeviceFilter, List<IDeviceMonitor> globalDeviceMonitors)

डिवाइस मैनेजर को शुरू करें.

void init()

डिवाइस मैनेजर को शुरू करें.

boolean isEmulator(String serial)

यह पता लगाना कि दिया गया सीरियल नंबर, एम्युलेटर को दिखाता है या नहीं

boolean isFileSystemMountCheckEnabled()

इससे यह पता चलता है कि फ़ाइल सिस्टम को सही तरीके से माउंट किया गया है या नहीं.NativeDeviceStateMonitor

boolean isNullDevice(String serial)

यह पता लगाना कि दिया गया सीरियल नंबर, किसी ऐसे डिवाइस का है जो मौजूद नहीं है

void killEmulator(ITestDevice device)

दिए गए एम्युलेटर को बंद करें.

void launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil, List<String> emulatorArgs)

एम्युलेटर लॉन्च करने के लिए हेल्पर मेथड.

List<DeviceDescriptor> listAllDevices(boolean shortDescriptor)

यह फ़ंक्शन, सभी जाने-पहचाने डिवाइसों के लिए DeviceDescriptors की सूची दिखाता है

List<DeviceDescriptor> listAllDevices()

यह फ़ंक्शन, सभी जाने-पहचाने डिवाइसों के लिए DeviceDescriptors की सूची दिखाता है

ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

यह एक हेल्पर मेथड है. यह दिए गए यूएसबी डिवाइस को adb-over-tcp मोड पर स्विच करता है. इसके बाद, connectToTcpDevice(String) के ज़रिए इससे कनेक्ट होता है.

void removeDeviceMonitor(IDeviceMonitor mon)

इससे पहले से जोड़ी गई IDeviceMonitor हट जाती है.

void removeFastbootListener(IDeviceManager.IFastbootListener listener)

यह मैनेजर को बताता है कि लिसनर को अब फ़ास्टबूट की स्थिति में होने वाले बदलावों में दिलचस्पी नहीं है.

void removeMonitoringTcpFastbootDevice(String serial)

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

ऐसी प्रॉपर्टी के लिए डिसप्ले स्ट्रिंग जिनकी जानकारी नहीं है

कॉन्स्टेंट वैल्यू: "unknown"

फ़ील्ड

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

सार्वजनिक कंस्ट्रक्टर

DeviceManager

public DeviceManager ()

DeviceManager को GlobalConfiguration से वापस पाना चाहिए

पब्लिक मेथड

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

पैरामीटर
stubDevice IDevice

addAvailableNativeDevice

public void addAvailableNativeDevice (IDevice stubDevice)

पैरामीटर
stubDevice IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

IDeviceMonitor जोड़ता है

पैरामीटर
mon IDeviceMonitor

addFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

पैरामीटर
fastbootDevice DeviceManager.FastbootDevice

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

यह कुकी, मैनेजर को सूचना देती है कि लिसनर को फ़ास्टबूट की स्थिति में होने वाले बदलावों में दिलचस्पी है.

फ़िलहाल, IDeviceManager सिर्फ़ फ़ास्टबूट मोड में मौजूद डिवाइसों को मॉनिटर करेगा. ऐसा तब होगा, जब एक या उससे ज़्यादा लिसनर चालू हों.

TODO: यह एक हैक है - कोई बेहतर समाधान ढूंढें

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastbootSerial)

फ़ास्टबूट मॉनिटर में कोई डिवाइस जोड़ें. फ़ास्टबूट मॉनिटर, डिवाइस से कम्यूनिकेट करने के लिए 'fastboot_serial' का इस्तेमाल करेगा.

पैरामीटर
serial String: डिवाइस का सीरियल नंबर.
fastbootSerial String: डिवाइस का फ़ास्टबूट मोड सीरियल नंबर.

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(ITestDevice) के ज़रिए रिलीज़ किया जाना चाहिए

लौटाया गया ITestDevice ऑनलाइन होगा, लेकिन हो सकता है कि वह काम न करे.

ध्यान दें कि टीसीपी से कनेक्ट किए गए डिवाइस को रीबूट करने जैसी कार्रवाई करने पर, डिवाइस से टीसीपी कनेक्शन टूट जाएगा. इससे DeviceNotAvailableException

पैरामीटर
ipAndPort String: कनेक्ट करने के लिए डिवाइस का ओरिजनल आईपी पता और पोर्ट
रिटर्न
ITestDevice अगर टीसीपी कनेक्शन नहीं बन सका, तो ITestDevice या null

disconnectFromTcpDevice

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

adb-over-tcp से कनेक्ट किए गए डिवाइस से डिसकनेक्ट करें.

इस कमांड से डिवाइस को वापस यूएसबी मोड में स्विच किया जाता है और उसे फ़्री किया जाता है.

पैरामीटर
tcpDevice ITestDevice: यह डिवाइस फ़िलहाल टीसीपी मोड में है. इसे पहले connectToTcpDevice(String) के ज़रिए असाइन किया गया था
रिटर्न
boolean true अगर यूएसबी मोड पर स्विच किया गया है

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

उपयोगकर्ता के लिए आसान भाषा में ब्यौरा दें. इसमें जाने-पहचाने डिवाइसों की सूची, उनकी स्थिति, और आम तौर पर इस्तेमाल किए जाने वाले IDeviceSelection विकल्पों की वैल्यू शामिल हों.

पैरामीटर
stream PrintWriter: वह PrintWriter जिसमें ब्यौरा आउटपुट करना है
includeStub boolean: स्टब डिवाइसों को भी दिखाना है या नहीं.

executeCmdOnAvailableDevice

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

यह उपलब्ध डिवाइस पर शेल कमांड चलाने का हेल्पर तरीका है.

पैरामीटर
serial String: डिवाइस का सीरियल नंबर.
command String: शेल कमांड.
timeout long: कमांड को पूरा होने में लगने वाला समय.
timeUnit TimeUnit: टाइम आउट के लिए यूनिट.
रिटर्न
CommandResult CommandResult.

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

किसी ऐसे डिवाइस के लिए adb कमांड लागू करें जिसे टारगेट नहीं किया गया है. उदाहरण के लिए, 'adb connect'

रिटर्न
String अगर कमांड काम करती है, तो std आउटपुट. अगर ऐसा नहीं होता है, तो शून्य.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

डिवाइस को गलत तरीके से असाइन करना, भले ही वह फ़िलहाल उपलब्ध न हो.

अगर डिवाइस पहले से ही किसी को असाइन किया गया है, तो इस सेटिंग का कोई असर नहीं होगा.

पैरामीटर
serial String: डिवाइस का सीरियल नंबर
रिटर्न
ITestDevice ITestDevice या अगर इसे असाइन नहीं किया जा सका, तो null

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

डिवाइस को पूल में वापस लाना

ऐसे डिवाइस को वापस करने की कोशिशों को अनदेखा किया जाएगा जिसे पहले कभी असाइन नहीं किया गया था.

पैरामीटर
device ITestDevice: ITestDevice को मुफ़्त में
deviceState FreeDeviceState: the 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 ()

यह फ़ास्टबूट बाइनरी का इस्तेमाल करने के लिए पाथ दिखाता है.

रिटर्न
String

getShellCheckCmdTime

public long getShellCheckCmdTime ()

शेल की उपलब्धता की जांच करने वाले कमांड के टाइमआउट को मिलीसेकंड में दिखाता है.

रिटर्न
long

init

public void init (IDeviceSelection globalDeviceFilter, 
                List<IDeviceMonitor> globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

डिवाइस मैनेजर को शुरू करें. किसी भी अन्य तरीके को कॉल करने से पहले, इसे सिर्फ़ एक बार कॉल किया जाना चाहिए.

पैरामीटर
globalDeviceFilter IDeviceSelection

globalDeviceMonitors List

deviceFactory IManagedTestDeviceFactory

init

public void init (IDeviceSelection globalDeviceFilter, 
                List<IDeviceMonitor> globalDeviceMonitors)

डिवाइस मैनेजर को शुरू करें. किसी भी अन्य तरीके को कॉल करने से पहले, इसे सिर्फ़ एक बार कॉल किया जाना चाहिए.

पैरामीटर
globalDeviceFilter IDeviceSelection: डिवाइस फ़िल्टर
globalDeviceMonitors List

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)

यह पता लगाना कि दिया गया सीरियल नंबर, किसी ऐसे डिवाइस का है जो मौजूद नहीं है

पैरामीटर
serial String

रिटर्न
boolean

killEmulator

public void killEmulator (ITestDevice device)

दिए गए एम्युलेटर को बंद करें.

यह तब तक ब्लॉक रहता है, जब तक एम्युलेटर, adb से हट नहीं जाता. अगर एम्युलेटर पहले से उपलब्ध नहीं है, तो इसका कोई असर नहीं पड़ेगा.

पैरामीटर
device ITestDevice: एम्युलेटर को शट डाउन करने के लिए ITestDevice
थ्रो
DeviceNotAvailableException

launchEmulator

public void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                List<String> emulatorArgs)

एम्युलेटर लॉन्च करने के लिए हेल्पर मेथड.

यह एम्युलेटर को कॉल करने वाले व्यक्ति की बताई गई जानकारी के मुताबिक लॉन्च करेगा

पैरामीटर
device ITestDevice: यह प्लेसहोल्डर ITestDevice, असाइन किए गए एम्युलेटर डिवाइस को दिखाता है
bootTimeout long: एम्युलेटर के बूट होने का इंतज़ार करने का समय (मिलीसेकंड में)
emulatorArgs List: एम्युलेटर लॉन्च करने के लिए कमांड लाइन आर्ग्युमेंट
थ्रो
DeviceNotAvailableException

listAllDevices

public List<DeviceDescriptor> listAllDevices (boolean shortDescriptor)

यह फ़ंक्शन, सभी जाने-पहचाने डिवाइसों के लिए DeviceDescriptors की सूची दिखाता है

पैरामीटर
shortDescriptor boolean: क्या डिस्क्रिप्टर को कम से कम जानकारी तक सीमित करना है
रिटर्न
List<DeviceDescriptor> सभी जाने-पहचाने डिवाइसों के लिए DeviceDescriptor की सूची

listAllDevices

public List<DeviceDescriptor> listAllDevices ()

यह फ़ंक्शन, सभी जाने-पहचाने डिवाइसों के लिए DeviceDescriptors की सूची दिखाता है

रिटर्न
List<DeviceDescriptor> सभी जाने-पहचाने डिवाइसों के लिए DeviceDescriptor की सूची

reconnectDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

यह एक हेल्पर मेथड है. यह दिए गए यूएसबी डिवाइस को adb-over-tcp मोड पर स्विच करता है. इसके बाद, connectToTcpDevice(String) के ज़रिए इससे कनेक्ट होता है.

पैरामीटर
usbDevice ITestDevice: यूएसबी मोड में मौजूद डिवाइस
रिटर्न
ITestDevice टीसीपी मोड में नया असाइन किया गया ITestDevice या टीसीपी कनेक्शन नहीं बन पाने पर null
थ्रो
DeviceNotAvailableException

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

इससे पहले से जोड़ी गई IDeviceMonitor हट जाती है. अगर महीने की जानकारी नहीं जोड़ी गई है, तो इसका कोई असर नहीं होगा.

पैरामीटर
mon IDeviceMonitor

removeFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

यह मैनेजर को बताता है कि लिसनर को अब फ़ास्टबूट की स्थिति में होने वाले बदलावों में दिलचस्पी नहीं है.

removeMonitoringTcpFastbootDevice

public void removeMonitoringTcpFastbootDevice (String serial)

पैरामीटर
serial String

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 ()

यह कुकी, डिवाइस को वापस पाने से जुड़े थ्रेड को बंद करती है.

terminateHard

public void terminateHard (String reason)

terminateHard() के गाने.

पैरामीटर
reason String: खाता बंद करने की वजह बताना ज़रूरी नहीं है.

terminateHard

public void terminateHard ()

यह terminate() की तरह ही है, लेकिन यह adb को भी बंद करने की कोशिश करता है.

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

जब तक पहला फ़िज़िकल डिवाइस कनेक्ट नहीं हो जाता, तब तक इंतज़ार करें. अगर कोई डिवाइस पहले कनेक्ट किया गया था, तो यह सीधे तौर पर True दिखाता है. अगर कोई डिवाइस नहीं जोड़ा गया है, तो टाइम आउट होने के बाद यह फ़ंक्शन 'गलत' वैल्यू दिखाता है.

पैरामीटर
timeout long: यह फ़ंक्शन, मिलीसेकंड में इंतज़ार करने का समय बताता है. इसके बाद, यह फ़ंक्शन 'गलत है' वैल्यू दिखाता है.
रिटर्न
boolean