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)

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

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

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

abstract void init(IDeviceSelection globalDeviceFilter, deviceMonitors)

डिवाइस फ़िल्टर की मदद से, डिवाइस मैनेजर को शुरू करें.

abstract void init()

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

abstract boolean isEmulator(String serial)

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

default boolean isFileSystemMountCheckEnabled()

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

abstract boolean isNullDevice(String serial)

यह पता लगाना कि दिया गया सीरियल नंबर, शून्य डिवाइस को दिखाता है या नहीं

abstract void killEmulator(ITestDevice device)

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

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

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

abstract listAllDevices(boolean shortDescriptor)

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

abstract listAllDevices()

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

abstract ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

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

abstract void removeDeviceMonitor(IDeviceMonitor mon)

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

abstract void removeFastbootListener(IDeviceManager.IFastbootListener listener)

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

default void removeMonitoringTcpFastbootDevice(String serial)
abstract void restartAdbBridge()

अगर stopAdbBridge() को कॉल किया गया था, तो adb ब्रिज और सेवाएं 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 सिर्फ़ फ़ास्टबूट मोड में मौजूद डिवाइसों को मॉनिटर करेगा. ऐसा तब होगा, जब एक या उससे ज़्यादा लिसनर चालू हों.

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

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

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

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

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 ऑनलाइन होगा, लेकिन हो सकता है कि वह काम न करे.

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

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

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

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

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

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: डिवाइस का सीरियल नंबर.
command String: शेल कमांड.
timeout long: निर्देश को पूरा होने में लगने वाला समय.
timeUnit TimeUnit: टाइम आउट की यूनिट.
रिटर्न
CommandResult CommandResult.

forceAllocateDevice

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

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

रिटर्न
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)

यह पता लगाना कि दिया गया सीरियल नंबर, शून्य डिवाइस को दिखाता है या नहीं

पैरामीटर
serial String

रिटर्न
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

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

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

पैरामीटर
device ITestDevice: एम्युलेटर को बंद करने के लिए ITestDevice
थ्रो
DeviceNotAvailableException अगर एम्युलेटर बंद नहीं होता है

launchEmulator

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

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

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

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

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

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

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

listAllDevices

public abstract  listAllDevices ()

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

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

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

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

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

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

पैरामीटर
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

removeMonitoringTcpFastbootDevice

public void removeMonitoringTcpFastbootDevice (String serial)

पैरामीटर
serial String

restartAdbBridge

public abstract void restartAdbBridge ()

अगर stopAdbBridge() को कॉल किया गया था, तो adb ब्रिज और सेवाएं adb कनेक्शन पर निर्भर करती हैं. इसलिए, adb ब्रिज और सेवाओं को रीस्टार्ट करें.

stopAdbBridge

public abstract void stopAdbBridge ()

adb ब्रिज और सेवाएं बंद करें. ये सेवाएं, adb कनेक्शन पर निर्भर करती हैं.

गेम काे बंद कराे

public abstract void terminate ()

यह डिवाइस की परफ़ॉर्मेंस पर नज़र रखने वाली सेवाओं को बंद कर देता है. साथ ही, ddm लाइब्रेरी को खत्म कर देता है.

ऐप्लिकेशन बंद होने पर, इसे कॉल किया जाना चाहिए.

यह भी देखें:

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

डिवाइस मॉनिटर करना बंद करें.

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

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

terminateHard

public void terminateHard (String reason)

जैसे, terminateHard().

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

terminateHard

public abstract void terminateHard ()

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

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

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

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