संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

निष्क्रियडिवाइस

public interface INativeDevice

com.android.tradefed.device.INativeDevice


ddmlib IDevice को एक विश्वसनीय और थोड़ा उच्च स्तरीय API प्रदान करता है।

कॉन्फ़िगर करने योग्य राशि के लिए डिवाइस कमांड का पुन: प्रयास करता है, और उन उपकरणों के लिए डिवाइस पुनर्प्राप्ति इंटरफ़ेस प्रदान करता है जो अनुत्तरदायी हैं।

सारांश

स्थिरांक

int UNKNOWN_API_LEVEL

डिफ़ॉल्ट मान जब API स्तर का पता नहीं लगाया जा सकता है

सार्वजनिक तरीके

abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

जाँच करें कि न्यूनतम समर्थित स्तर दिए जाने पर कोई सुविधा वर्तमान में समर्थित है या नहीं।

abstract void clearLogcat ()

किसी भी संचित लॉगकैट डेटा को हटा देता है।

abstract void deleteFile (String deviceFilePath)

डिवाइस पर फ़ाइल या निर्देशिका को हटाने के लिए सहायक विधि।

abstract boolean deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)

पिछले system_server ProcessInfo के साथ मौजूदा system_server की तुलना करके डिवाइस को सॉफ्ट-रिस्टार्ट किया गया है या नहीं, यह जांचने के लिए हेल्पर विधि।

abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

डिवाइस और उसके ERROR(/TimeUnit) से युग के बाद से UTC समय के बाद से डिवाइस को सॉफ्ट-रीस्टार्ट किया गया है या नहीं, यह जांचने के लिए हेल्पर विधि।

abstract boolean disableAdbRoot ()

एडीबी रूट बंद कर देता है।

abstract boolean doesFileExist (String deviceFilePath)

डिवाइस पर फ़ाइल मौजूद है या नहीं यह निर्धारित करने के लिए सहायक विधि।

abstract boolean enableAdbRoot ()

एडीबी रूट चालू करता है।

abstract String executeAdbCommand (long timeout, String... commandArgs)

हेल्पर विधि जो एक निर्दिष्ट टाइमआउट के साथ सिस्टम कमांड के रूप में एडीबी कमांड निष्पादित करती है।

abstract String executeAdbCommand (String... commandArgs)

हेल्पर विधि जो एक सिस्टम कमांड के रूप में adb कमांड को निष्पादित करती है।

abstract CommandResult executeFastbootCommand (String... commandArgs)

हेल्पर विधि जो 2 मिनट के डिफ़ॉल्ट टाइमआउट के साथ सिस्टम कमांड के रूप में फास्टबूट कमांड को निष्पादित करती है।

abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)

हेल्पर विधि जो सिस्टम कमांड के रूप में फास्टबूट कमांड को निष्पादित करती है।

abstract CommandResult executeLongFastbootCommand ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs)

हेल्पर विधि जो सिस्टम पर्यावरण चर के साथ सिस्टम कमांड के रूप में लंबे समय तक चलने वाले फास्टबूट कमांड को निष्पादित करती है।

abstract CommandResult executeLongFastbootCommand (String... commandArgs)

हेल्पर विधि जो एक सिस्टम कमांड के रूप में लंबे समय तक चलने वाले फास्टबूट कमांड को निष्पादित करती है।

abstract String executeShellCommand (String command)

हेल्पर विधि जो adb शेल कमांड को निष्पादित करती है और आउटपुट को String के रूप में लौटाती है।

abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

कमांड व्यवहार को नियंत्रित करने के लिए अधिक मापदंडों के साथ adb शेल कमांड निष्पादित करता है।

abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

कमांड व्यवहार को नियंत्रित करने के लिए अधिक मापदंडों के साथ adb शेल कमांड निष्पादित करता है।

abstract void executeShellCommand (String command, IShellOutputReceiver receiver)

दिए गए adb shell कमांड को निष्पादित करता है, कमांड विफल होने पर कई बार पुनः प्रयास करता है।

abstract CommandResult executeShellV2Command (String command)

हेल्पर विधि जो adb शेल कमांड को निष्पादित करती है और कमांड स्टेटस आउटपुट, स्टडआउट और CommandResult के साथ ठीक से पॉप्युलेट किए गए कमांड रिसेट के रूप में परिणाम लौटाती है।

abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)

हेल्पर विधि जो एक एडीबी शेल कमांड को निष्पादित करती है और कमांड स्टेटस आउटपुट और CommandResult के साथ ठीक से पॉप्युलेट किए गए कमांड रिसेट के रूप में परिणाम लौटाती है।

abstract CommandResult executeShellV2Command (String command, File pipeAsInput)

हेल्पर विधि जो एक एडीबी शेल कमांड को निष्पादित करती है और कमांड स्टेटस आउटपुट, स्टडआउट और CommandResult के साथ ठीक से पॉप्युलेट किए गए कमांड रिसेट के रूप में परिणाम लौटाती है।

abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

कमांड व्यवहार को नियंत्रित करने के लिए अधिक मापदंडों के साथ adb शेल कमांड निष्पादित करता है।

abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)

कमांड व्यवहार को नियंत्रित करने के लिए अधिक मापदंडों के साथ adb शेल कमांड निष्पादित करता है।

abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

कमांड व्यवहार को नियंत्रित करने के लिए अधिक मापदंडों के साथ adb शेल कमांड निष्पादित करता है।

abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

कमांड व्यवहार को नियंत्रित करने के लिए अधिक मापदंडों के साथ adb शेल कमांड निष्पादित करता है।

abstract CommandResult fastbootWipePartition (String partition)

हेल्पर विधि जो डिवाइस के लिए एक विभाजन को मिटा देती है।

abstract int getApiLevel ()

डिवाइस एपीआई स्तर प्राप्त करें।

abstract String getBasebandVersion ()

इस उपकरण का बेसबैंड (रेडियो) संस्करण प्राप्त करने की सुविधा विधि।

abstract Integer getBattery ()

बैटरी स्तर अनुपलब्ध होने पर डिवाइस का वर्तमान बैटरी स्तर या नल लौटाता है।

abstract boolean getBooleanProperty (String name, boolean defaultValue)

दी गई संपत्ति का बूलियन मान लौटाता है।

abstract getBootHistory ()

हेल्पर विधि बूट इतिहास मानचित्र को बूट समय और बूट कारण के साथ एकत्रित करती है।

abstract getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)

हेल्पर विधि बूट इतिहास मानचित्र को बूट समय और बूट कारण के साथ डिवाइस से युग और निर्दिष्ट समय इकाई के बाद से एकत्रित करती है।

abstract String getBootloaderVersion ()

इस उपकरण का बूटलोडर संस्करण प्राप्त करने की सुविधा विधि।

abstract InputStreamSource getBugreport ()

डिवाइस से एक बग्रेपोर्ट प्राप्त करता है।

abstract InputStreamSource getBugreportz ()

डिवाइस से एक बग्रेपोर्ट्ज़ पुनर्प्राप्त करता है।

abstract String getBuildAlias ()

डिवाइस के वर्तमान में चल रहे निर्माण के उपनाम को पुनः प्राप्त करें।

abstract String getBuildFlavor ()

डिवाइस के लिए बिल्ड फ्लेवर प्राप्त करें।

abstract String getBuildId ()

उस बिल्ड को पुनः प्राप्त करें जो डिवाइस वर्तमान में चल रहा है।

abstract String getBuildSigningKeys ()

डिवाइस छवि पर हस्ताक्षर करने के लिए उपयोग किया जाने वाला कुंजी प्रकार लौटाता है

आमतौर पर Android उपकरणों पर परीक्षण-कुंजी (जैसे AOSP में) या रिलीज़-कुंजी (व्यक्तिगत डिवाइस निर्माताओं द्वारा नियंत्रित) के साथ हस्ताक्षर किए जा सकते हैं।

abstract DeviceDescriptor getCachedDeviceDescriptor ()

यदि डिवाइस आवंटित किया गया है, तो कैश्ड डिवाइस DeviceDescriptor लौटाता है, अन्यथा वर्तमान DeviceDescriptor है।

abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

यदि डिवाइस आवंटित किया गया है, तो कैश्ड डिवाइस DeviceDescriptor लौटाता है, अन्यथा वर्तमान DeviceDescriptor है।

abstract String[] getChildren (String deviceFilePath)

IFileEntry का उपयोग करने का विकल्प जो कभी-कभी अनुमतियों के कारण काम नहीं करेगा।

abstract String getDeviceClass ()

डिवाइस क्लास प्राप्त करें।

abstract long getDeviceDate ()

युग के बाद से मिलीसेकंड में डिवाइस की तारीख लौटाएं।

abstract DeviceDescriptor getDeviceDescriptor ()

वास्तविक डिवाइस ऑब्जेक्ट को पास किए बिना उस पर जानकारी प्राप्त करने के लिए डिवाइस जानकारी से डिवाइस DeviceDescriptor लौटाएं।

abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

वास्तविक डिवाइस ऑब्जेक्ट को पास किए बिना उस पर जानकारी प्राप्त करने के लिए डिवाइस जानकारी से डिवाइस DeviceDescriptor लौटाएं।

abstract TestDeviceState getDeviceState ()

डिवाइस की स्थिति प्राप्त करें।

abstract long getDeviceTimeOffset (Date date)

डिवाइस और किसी दिए गए ERROR(/Date) के बीच समय अंतर प्राप्त करने के लिए सहायक।

abstract InputStreamSource getEmulatorOutput ()

एमुलेटर stdout और stderr . की स्ट्रीम प्राप्त करें

abstract long getExternalStoreFreeSpace ()

डिवाइस बाहरी संग्रहण पर खाली स्थान की मात्रा निर्धारित करने के लिए सहायक विधि।

abstract String getFastbootProductType ()

फास्टबूट मोड में होने पर इस डिवाइस के उत्पाद प्रकार को प्राप्त करने की सुविधा विधि।

abstract String getFastbootProductVariant ()

फास्टबूट मोड में होने पर इस डिवाइस के उत्पाद प्रकार को प्राप्त करने की सुविधा विधि।

abstract String getFastbootSerialNumber ()

फास्टबूट मोड सीरियल नंबर देता है।

abstract String getFastbootVariable (String variableName)

डिवाइस से दिए गए फास्टबूट चर मान को पुनः प्राप्त करें।

abstract IFileEntry getFileEntry (String path)

डिवाइस पर किसी दूरस्थ फ़ाइल का संदर्भ पुनर्प्राप्त करें।

abstract IDevice getIDevice ()

संबंधित ddmlib IDevice का संदर्भ देता है।

abstract long getIntProperty (String name, long defaultValue)

डिवाइस से दी गई संपत्ति का पूर्णांक मान देता है।

abstract long getLastExpectedRebootTimeMillis ()

पिछली बार जब ट्रेडफेड एपीआई ने ईपीओसीएच के बाद से मिलीसेकंड में रिबूट को ट्रिगर किया था, जैसा कि System.currentTimeMillis() द्वारा लौटाया गया था।

abstract int getLaunchApiLevel ()

डिवाइस का पहला लॉन्च किया गया API स्तर प्राप्त करें।

abstract InputStreamSource getLogcat ()

लॉगकैट डेटा की एक स्नैपशॉट स्ट्रीम प्राप्त करता है।

abstract InputStreamSource getLogcat (int maxBytes)

कैप्चर किए गए लॉगकैट डेटा के अंतिम maxBytes की एक स्नैपशॉट स्ट्रीम प्राप्त करता है।

abstract InputStreamSource getLogcatDump ()

डिवाइस के लिए वर्तमान लॉगकैट का डंप प्राप्त करें।

abstract InputStreamSource getLogcatSince (long date)

प्रदान की गई तारीख से शुरू होने वाले कैप्चर किए गए लॉगकैट डेटा की एक स्नैपशॉट स्ट्रीम प्राप्त करता है।

abstract String getMountPoint (String mountName)

एक आरोह बिंदु लौटाता है।

abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

निर्दिष्ट माउंटपॉइंट पथ से संबंधित एक MountPointInfo देता है, या null यदि उस पथ में कुछ भी माउंट नहीं है या अन्यथा माउंटपॉइंट के रूप में / proc / माउंट में प्रकट नहीं होता है।

abstract getMountPointInfo ()

डिवाइस पर /proc/mounts में जानकारी का पार्स किया हुआ संस्करण लौटाता है

abstract long getPartitionFreeSpace (String partition)

डिवाइस विभाजन पर खाली स्थान की मात्रा निर्धारित करने के लिए सहायक विधि।

abstract ProcessInfo getProcessByName (String processName)

हेल्पर विधि "पिडोफ" और "स्टेट" कमांड चलाती है और ProcessInfo ऑब्जेक्ट को पीआईडी ​​​​के साथ लौटाती है और दी गई प्रक्रिया के प्रक्रिया शुरू होने का समय देती है।

abstract String getProcessPid (String process)

कुछ गलत होने पर सेवा का पिड लौटाता है या अशक्त करता है।

abstract String getProductType ()

इस उपकरण का उत्पाद प्रकार प्राप्त करने की सुविधा विधि।

abstract String getProductVariant ()

इस उपकरण का उत्पाद संस्करण प्राप्त करने की सुविधा विधि।

abstract String getProperty (String name)

डिवाइस से दिए गए गुण मान को पुनः प्राप्त करें।

abstract ITestDevice.RecoveryMode getRecoveryMode ()

डिवाइस के लिए उपयोग किया जाने वाला वर्तमान पुनर्प्राप्ति मोड प्राप्त करें।

abstract String getSerialNumber ()

इस उपकरण का क्रमांक प्राप्त करने की सुविधा विधि।

abstract getTombstones ()

उपकरणों से मकबरे की सूची प्राप्त करें और वापस करें।

abstract long getTotalMemory ()

आंतरिक त्रुटि के मामले में बाइट्स या -1 में कुल भौतिक स्मृति आकार देता है

abstract boolean getUseFastbootErase ()

पता करें कि डिवाइस पर किसी पार्टीशन को वाइप करने के लिए फास्टबूट इरेज़ या फास्टबूट फॉर्मेट का उपयोग करना है या नहीं।

abstract boolean isAdbRoot ()
abstract boolean isAdbTcp ()
abstract boolean isAppEnumerationSupported ()

जांचें कि क्या डिवाइस पर प्लेटफॉर्म ऐप एन्यूमरेशन का समर्थन करता है

abstract boolean isDeviceEncrypted ()

यदि डिवाइस एन्क्रिप्ट किया गया है तो वापस आ जाता है।

abstract boolean isDirectory (String deviceFilePath)

यदि डिवाइस पर पथ एक निर्देशिका है, तो सही है, अन्यथा गलत है।

abstract boolean isEncryptionSupported ()

यदि डिवाइस पर एन्क्रिप्शन समर्थित है तो वापस आ जाता है।

abstract boolean isExecutable (String fullPath)

यदि डिवाइस पर फ़ाइल पथ निष्पादन योग्य फ़ाइल है, तो सही है, अन्यथा गलत है।

abstract boolean isHeadless ()

यदि डिवाइस हेडलेस (कोई स्क्रीन नहीं) है, तो सही है, अन्यथा गलत है।

abstract boolean isRuntimePermissionSupported ()

जांचें कि क्या डिवाइस पर प्लेटफॉर्म रनटाइम अनुमति देने का समर्थन करता है

abstract boolean isStateBootloaderOrFastbootd ()

यदि डिवाइस TestDeviceState#FASTBOOT या TestDeviceState.FASTBOOTD में है, तो सही लौटाता है।

abstract boolean logAnrs ( ITestLogger logger)

डिवाइस से ANR एकत्र करता है और लॉग करता है।

abstract boolean logBugreport (String dataName, ITestLogger listener)

एक बग रिपोर्ट लेने और उसे संवाददाताओं को लॉग करने के लिए हेल्पर विधि।

abstract void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)

डिवाइस के लॉगकैट में एक संदेश लॉग करें।

abstract void nonBlockingReboot ()

डिवाइस को रीबूट करने के लिए एक आदेश जारी करता है और कमांड पूर्ण होने पर वापस आ जाता है और जब डिवाइस अब एडीबी को दिखाई नहीं देता है।

abstract void postBootSetup ()

प्रत्येक बूट के बाद परीक्षण के लिए डिवाइस को कॉन्फ़िगर करने के लिए निर्देश निष्पादित करें।

default void postInvocationTearDown ()

यह विधि बहिष्कृत है। इसके बजाय postInvocationTearDown(Throwable) का उपयोग करें।

abstract void postInvocationTearDown (Throwable invocationException)

उपकरण विशिष्ट आवश्यक सफाई के लिए अतिरिक्त कदम जो आह्वान के बाद निष्पादित किए जाएंगे।

default void preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes)

डिवाइस विशिष्ट आवश्यक सेटअप के लिए अतिरिक्त चरण जो कि आमंत्रण प्रवाह से पहले डिवाइस पर निष्पादित किए जाएंगे।

abstract boolean pullDir (String deviceFilePath, File localDir)

डिवाइस से निर्देशिका सामग्री को पुनरावर्ती रूप से खींचें।

abstract File pullFile (String remoteFilePath, int userId)

डिवाइस से फ़ाइल पुनर्प्राप्त करता है, इसे स्थानीय अस्थायी ERROR(/File) में संग्रहीत करता है, और उस File को वापस कर देता है।

abstract File pullFile (String remoteFilePath)

डिवाइस से फ़ाइल पुनर्प्राप्त करता है, इसे स्थानीय अस्थायी ERROR(/File) में संग्रहीत करता है, और उस File को वापस कर देता है।

abstract boolean pullFile (String remoteFilePath, File localFile)

डिवाइस से फ़ाइल को पुनर्प्राप्त करता है।

abstract boolean pullFile (String remoteFilePath, File localFile, int userId)

डिवाइस से फ़ाइल को पुनर्प्राप्त करता है।

abstract String pullFileContents (String remoteFilePath)

डिवाइस से फ़ाइल पुनर्प्राप्त करता है, और सामग्री लौटाता है।

abstract File pullFileFromExternal (String remoteFilePath)

डिवाइस के बाहरी संग्रहण से फ़ाइल पुनर्प्राप्त करने के लिए एक सुविधाजनक विधि, इसे स्थानीय अस्थायी ERROR(/File) में संग्रहीत करती है, और उस File का संदर्भ लौटाती है।

abstract boolean pushDir (File localDir, String deviceFilePath, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories)

फ़िल्टर की गई कुछ निर्देशिकाओं को छोड़कर निर्देशिका सामग्री को डिवाइस पर पुनरावर्ती रूप से पुश करें।

abstract boolean pushDir (File localDir, String deviceFilePath)

डिवाइस पर निर्देशिका सामग्री को पुनरावर्ती रूप से पुश करें।

abstract boolean pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)

pushFile(File, String) का प्रकार जो वैकल्पिक रूप से सामग्री प्रदाता की आवश्यकता का मूल्यांकन करने पर विचार कर सकता है।

abstract boolean pushFile (File localFile, String deviceFilePath)

डिवाइस पर फ़ाइल पुश करें।

abstract boolean pushString (String contents, String deviceFilePath)

एक स्ट्रिंग से डिवाइस पर बनाई गई पुश फ़ाइल

abstract void reboot ()

डिवाइस को एडीबी मोड में रीबूट करता है।

abstract void reboot (String reason)

रिबूट के दौरान बने रहने के लिए दिए गए reason के साथ डिवाइस को एडीबी मोड में रीबूट करता है।

abstract void rebootIntoBootloader ()

डिवाइस को बूटलोडर मोड में रीबूट करता है।

abstract void rebootIntoFastbootd ()

डिवाइस को फास्टबूट मोड में रीबूट करता है।

abstract void rebootIntoRecovery ()

डिवाइस को एडीबी रिकवरी मोड में रीबूट करता है।

abstract void rebootIntoSideload (boolean autoReboot)

डिवाइस को एडीबी साइडलोड मोड में रीबूट करता है (ध्यान दें कि यह रिकवरी के तहत एक विशेष मोड है)

डिवाइस साइडलोड मोड में प्रवेश करने तक ब्लॉक करता है

abstract void rebootIntoSideload ()

डिवाइस को एडीबी साइडलोड मोड में रीबूट करता है (ध्यान दें कि यह रिकवरी के तहत एक विशेष मोड है)

डिवाइस साइडलोड मोड में प्रवेश करने तक ब्लॉक करता है

abstract void rebootUntilOnline ()

reboot() का एक विकल्प जो केवल तब तक ब्लॉक करता है जब तक कि डिवाइस ऑनलाइन न हो यानी एडीबी को दिखाई दे।

abstract void rebootUntilOnline (String reason)

reboot() का एक विकल्प जो केवल तब तक ब्लॉक करता है जब तक कि डिवाइस ऑनलाइन न हो यानी एडीबी को दिखाई दे।

abstract void rebootUserspace ()

डिवाइस के केवल यूज़रस्पेस भाग को रीबूट करता है।

abstract void rebootUserspaceUntilOnline ()

rebootUserspace() ()} का एक विकल्प जो केवल तब तक ब्लॉक करता है जब तक कि डिवाइस ऑनलाइन न हो यानी एडीबी को दिखाई दे।

abstract void remountSystemWritable ()

डिवाइस पर सिस्टम विभाजन को लिखने योग्य बनाएं।

abstract void remountVendorWritable ()

डिवाइस पर विक्रेता विभाजन को लिखने योग्य बनाएं।

abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)

पैरामीटर के रूप में पारित एक या अधिक श्रोताओं के साथ ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) करने की सुविधा विधि।

abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)

उपकरण परीक्षण चलाता है, और उपकरण पुनर्प्राप्ति प्रदान करता है।

abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)

ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) के समान लेकिन किसी दिए गए उपयोगकर्ता के लिए परीक्षण चलाता है।

abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)

ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) के समान दिए गए उपयोगकर्ता के लिए।

abstract void setDate (Date date)

डिवाइस पर तारीख सेट करता है

नोट: डिवाइस पर दिनांक सेट करने के लिए रूट की आवश्यकता होती है

abstract void setOptions ( TestDeviceOptions options)

डिवाइस के लिए TestDeviceOptions सेट करें

abstract boolean setProperty (String propKey, String propValue)

डिवाइस पर दिए गए गुण मान को सेट करता है।

abstract void setRecovery ( IDeviceRecovery recovery)

इस डिवाइस के लिए उपयोग करने के लिए IDeviceRecovery सेट करें।

abstract void setRecoveryMode ( ITestDevice.RecoveryMode mode)

डिवाइस के लिए उपयोग करने के लिए वर्तमान पुनर्प्राप्ति मोड सेट करें।

abstract void setUseFastbootErase (boolean useFastbootErase)

सेट करें कि डिवाइस पर किसी पार्टीशन को वाइप करने के लिए फास्टबूट इरेज़ या फास्टबूट फॉर्मेट का उपयोग करना है या नहीं।

abstract void startLogcat ()

बैकग्राउंड में डिवाइस से लॉगकैट आउटपुट कैप्चर करना शुरू करें।

abstract void stopEmulatorOutput ()

एमुलेटर आउटपुट को बंद करें और हटाएं।

abstract void stopLogcat ()

डिवाइस से लॉगकैट आउटपुट कैप्चर करना बंद करें, और वर्तमान में सहेजे गए लॉगकैट डेटा को त्याग दें।

abstract String switchToAdbTcp ()

डिवाइस को एडीबी-ओवर-टीसीपी मोड पर स्विच करें।

abstract boolean switchToAdbUsb ()

यूएसबी मोड पर डिवाइस को एडीबी पर स्विच करें।

abstract boolean syncFiles (File localFileDir, String deviceFilePath)

स्थानीय फ़ाइल निर्देशिका की सामग्री को डिवाइस से इंक्रीमेंटली सिंक करता है।

abstract Bugreport takeBugreport ()

एक बग्रेपोर्ट लें और इसे संभालने के लिए इसे एक Bugreport ऑब्जेक्ट के अंदर लौटा दें।

abstract boolean unlockDevice ()

यदि डिवाइस एन्क्रिप्टेड स्थिति में है तो डिवाइस को अनलॉक करता है।

abstract boolean waitForBootComplete (long timeOut)

डिवाइस का बूट पूरा फ्लैग सेट होने तक ब्लॉक करता है।

abstract boolean waitForDeviceAvailable ()

डिवाइस के उत्तरदायी होने और परीक्षण के लिए उपलब्ध होने की प्रतीक्षा करता है।

abstract boolean waitForDeviceAvailable (long waitTime)

डिवाइस के उत्तरदायी होने और परीक्षण के लिए उपलब्ध होने की प्रतीक्षा करता है।

abstract void waitForDeviceBootloader ()

फास्टबूट के माध्यम से डिवाइस दिखाई देने तक ब्लॉक करता है।

abstract boolean waitForDeviceInRecovery (long waitTime)

डिवाइस के 'adb पुनर्प्राप्ति' स्थिति में होने के लिए ब्लॉक (ध्यान दें कि यह IDeviceRecovery से अलग है)।

abstract boolean waitForDeviceInSideload (long waitTime)

डिवाइस के लिए 'adb sideload' स्थिति में होने के लिए ब्लॉक

abstract boolean waitForDeviceNotAvailable (long waitTime)

डिवाइस के उपलब्ध नहीं होने के लिए ब्लॉक यानी adb . से गायब होना

abstract void waitForDeviceOnline ()

एडीबी के माध्यम से डिवाइस दिखाई देने तक ब्लॉक।

abstract void waitForDeviceOnline (long waitTime)

एडीबी के माध्यम से डिवाइस दिखाई देने तक ब्लॉक।

abstract boolean waitForDeviceShell (long waitTime)

मूल adb शेल कमांड के लिए डिवाइस के उत्तरदायी होने की प्रतीक्षा करता है।

स्थिरांक

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

डिफ़ॉल्ट मान जब API स्तर का पता नहीं लगाया जा सकता है

स्थिर मान: -1 (0xffffffff)

सार्वजनिक तरीके

चेकएपीआई स्तरअगले रिलीज के खिलाफ

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

जाँच करें कि न्यूनतम समर्थित स्तर दिए जाने पर कोई सुविधा वर्तमान में समर्थित है या नहीं। एपीआई स्तर उठाए जाने से पहले, यह विधि अभी तक अप्रकाशित सुविधाओं को ध्यान में रखती है।

मापदंडों
strictMinLevel int : सख्त न्यूनतम संभव स्तर जो सुविधा का समर्थन करता है।

रिटर्न
boolean सच है अगर स्तर समर्थित है। अन्यथा झूठा।

फेंकता
DeviceNotAvailableException

स्पष्ट लॉगकैट

public abstract void clearLogcat ()

किसी भी संचित लॉगकैट डेटा को हटा देता है।

यह उन मामलों के लिए उपयोगी है जब आप यह सुनिश्चित करना चाहते हैं कि ITestDevice#getLogcat() केवल एक निश्चित बिंदु के बाद उत्पादित लॉग डेटा लौटाता है (जैसे कि एक नया डिवाइस निर्माण चमकाने के बाद)।

फ़ाइल को हटाएं

public abstract void deleteFile (String deviceFilePath)

डिवाइस पर फ़ाइल या निर्देशिका को हटाने के लिए सहायक विधि।

मापदंडों
deviceFilePath String : डिवाइस पर फ़ाइल का पूर्ण पथ।

फेंकता
DeviceNotAvailableException

डिवाइससॉफ्ट रीस्टार्ट

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

पिछले system_server ProcessInfo के साथ मौजूदा system_server की तुलना करके डिवाइस को सॉफ्ट-रिस्टार्ट किया गया है या नहीं, यह जांचने के लिए हेल्पर विधि। ProcessInfo प्राप्त करने के लिए ProcessInfo getProcessByName(String) का उपयोग करें।

मापदंडों
prevSystemServerProcess ProcessInfo : पिछली system_server प्रक्रिया ProcessInfo

रिटर्न
boolean true अगर डिवाइस सॉफ्ट-रीस्टार्ट हो गया है

फेंकता
RuntimeException यदि डिवाइस में असामान्य बूट कारण है
DeviceNotAvailableException

deviceSoftRestartedचूंकि

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

डिवाइस और उसके ERROR(/TimeUnit) से युग के बाद से UTC समय के बाद से डिवाइस को सॉफ्ट-रीस्टार्ट किया गया है या नहीं, यह जांचने के लिए हेल्पर विधि। सॉफ्ट-रीस्टार्ट सिस्टम_सर्वर को संदर्भित करता है जो डिवाइस के हार्ड रीबूट के बाहर पुनरारंभ होता है (उदाहरण के लिए: अनुरोधित रीबूट)। Milliseccond में वर्तमान डिवाइस utcEpochTime विधि getDeviceDate() द्वारा प्राप्त किया जा सकता है।

मापदंडों
utcEpochTime long : युग के बाद से दूसरे में डिवाइस का समय।

timeUnit TimeUnit : दिए गए utcEpochTime के लिए टाइम यूनिट TimeUnit

रिटर्न
boolean true अगर डिवाइस सॉफ्ट-रीस्टार्ट हो गया है

फेंकता
RuntimeException यदि डिवाइस में असामान्य बूट कारण है
DeviceNotAvailableException

अक्षमअडबरूट

public abstract boolean disableAdbRoot ()

एडीबी रूट बंद कर देता है।

एडीबी रूट को अक्षम करने से डिवाइस एडीबी से डिस्कनेक्ट हो सकता है। डिवाइस उपलब्ध होने तक यह विधि अवरुद्ध रहेगी।

रिटर्न
boolean सफल होने पर true

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

doFileExist

public abstract boolean doesFileExist (String deviceFilePath)

डिवाइस पर फ़ाइल मौजूद है या नहीं यह निर्धारित करने के लिए सहायक विधि।

मापदंडों
deviceFilePath String : जाँच करने के लिए डिवाइस पर फ़ाइल का निरपेक्ष पथ

रिटर्न
boolean true अगर फ़ाइल मौजूद है, अन्यथा false

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

सक्षम करेंएडबरूट

public abstract boolean enableAdbRoot ()

एडीबी रूट चालू करता है। यदि "सक्षम-रूट" सेटिंग "गलत" है, तो एक संदेश लॉग करेगा और रूट को सक्षम किए बिना वापस आ जाएगा।

एडीबी रूट को सक्षम करने से डिवाइस एडीबी से डिस्कनेक्ट हो सकता है। डिवाइस उपलब्ध होने तक यह विधि अवरुद्ध रहेगी।

रिटर्न
boolean सफल होने पर true

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंएडीबीकमांड

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

हेल्पर विधि जो एक निर्दिष्ट टाइमआउट के साथ सिस्टम कमांड के रूप में एडीबी कमांड निष्पादित करती है।

जहाँ भी संभव हो इसके बजाय executeShellCommand(String) का उपयोग किया जाना चाहिए, क्योंकि यह विधि बेहतर विफलता का पता लगाने और प्रदर्शन प्रदान करती है।

मापदंडों
timeout long : डिवाइस से पहले मिलीसेकंड में समय को अनुत्तरदायी माना जाता है, 0L बिना टाइमआउट के

commandArgs String : adb कमांड और चलाने के लिए तर्क

रिटर्न
String कमांड से स्टडआउट। null अगर आदेश निष्पादित करने में विफल रहा।

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंएडीबीकमांड

public abstract String executeAdbCommand (String... commandArgs)

हेल्पर विधि जो एक सिस्टम कमांड के रूप में adb कमांड को निष्पादित करती है।

जहाँ भी संभव हो इसके बजाय executeShellCommand(String) का उपयोग किया जाना चाहिए, क्योंकि यह विधि बेहतर विफलता का पता लगाने और प्रदर्शन प्रदान करती है।

मापदंडों
commandArgs String : adb कमांड और चलाने के लिए तर्क

रिटर्न
String कमांड से स्टडआउट। null अगर आदेश निष्पादित करने में विफल रहा।

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंफास्टबूटकमांड

public abstract CommandResult executeFastbootCommand (String... commandArgs)

हेल्पर विधि जो 2 मिनट के डिफ़ॉल्ट टाइमआउट के साथ सिस्टम कमांड के रूप में फास्टबूट कमांड को निष्पादित करती है।

डिवाइस के पहले से ही फास्टबूट मोड में होने पर उपयोग किए जाने की उम्मीद है।

मापदंडों
commandArgs String : फास्टबूट कमांड और चलाने के लिए तर्क

रिटर्न
CommandResult CommandResult जिसमें कमांड का आउटपुट होता है

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंफास्टबूटकमांड

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

हेल्पर विधि जो सिस्टम कमांड के रूप में फास्टबूट कमांड को निष्पादित करती है।

डिवाइस के पहले से ही फास्टबूट मोड में होने पर उपयोग किए जाने की उम्मीद है।

मापदंडों
timeout long : आदेश समाप्त होने से पहले मिलीसेकंड में समय

commandArgs String : फास्टबूट कमांड और चलाने के लिए तर्क

रिटर्न
CommandResult CommandResult जिसमें कमांड का आउटपुट होता है

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंलॉन्गफास्टबूटकमांड

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

हेल्पर विधि जो सिस्टम पर्यावरण चर के साथ सिस्टम कमांड के रूप में लंबे समय तक चलने वाले फास्टबूट कमांड को निष्पादित करती है।

निष्पादित करने के लिए समान है executeFastbootCommand(String) एक लंबे समय के उपयोग को छोड़कर।

मापदंडों
envVarMap : सिस्टम पर्यावरण चर जो फास्टबूट कमांड के साथ चलता है

commandArgs String : फास्टबूट कमांड और चलाने के लिए तर्क

रिटर्न
CommandResult CommandResult जिसमें कमांड का आउटपुट होता है

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंलॉन्गफास्टबूटकमांड

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

हेल्पर विधि जो एक सिस्टम कमांड के रूप में लंबे समय तक चलने वाले फास्टबूट कमांड को निष्पादित करती है।

निष्पादित करने के लिए समान है executeFastbootCommand(String) एक लंबे समय के उपयोग को छोड़कर।

मापदंडों
commandArgs String : फास्टबूट कमांड और चलाने के लिए तर्क

रिटर्न
CommandResult CommandResult जिसमें कमांड का आउटपुट होता है

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंशेलकमांड

public abstract String executeShellCommand (String command)

हेल्पर विधि जो adb शेल कमांड को निष्पादित करती है और आउटपुट को String के रूप में लौटाती है।

मापदंडों
command String : adb शेल कमांड चलाने के लिए

रिटर्न
String शेल आउटपुट

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंशेलकमांड

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

कमांड व्यवहार को नियंत्रित करने के लिए अधिक मापदंडों के साथ adb शेल कमांड निष्पादित करता है।

मापदंडों
command String : adb शेल कमांड चलाने के लिए

receiver IShellOutputReceiver : IShellOutputReceiver शेल आउटपुट को निर्देशित करने के लिए।

maxTimeToOutputShellResponse long : अधिकतम समय जिसके दौरान कमांड को किसी भी प्रतिक्रिया को आउटपुट नहीं करने की अनुमति है; समय में निर्दिष्ट इकाई timeUnit

timeUnit TimeUnit : maxTimeToOutputShellResponse के लिए इकाई

retryAttempts int : किसी अपवाद के कारण विफल होने पर कमांड को पुनः प्रयास करने की अधिकतम संख्या। यदि पुन: प्रयास सफलता के बिना किए जाते हैं, तो retryAttempts को फेंक दिया जाएगा।

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंशेलकमांड

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

कमांड व्यवहार को नियंत्रित करने के लिए अधिक मापदंडों के साथ adb शेल कमांड निष्पादित करता है।

मापदंडों
command String : adb शेल कमांड चलाने के लिए

receiver IShellOutputReceiver : IShellOutputReceiver शेल आउटपुट को निर्देशित करने के लिए।

maxTimeoutForCommand long : कमांड को पूरा करने के लिए अधिकतम टाइमआउट; समय में निर्दिष्ट इकाई timeUnit

maxTimeToOutputShellResponse long : अधिकतम समय जिसके दौरान कमांड को किसी भी प्रतिक्रिया को आउटपुट नहीं करने की अनुमति है; समय में निर्दिष्ट इकाई timeUnit

timeUnit TimeUnit : maxTimeToOutputShellResponse के लिए इकाई

retryAttempts int : किसी अपवाद के कारण विफल होने पर कमांड को पुनः प्रयास करने की अधिकतम संख्या। यदि पुन: प्रयास सफलता के बिना किए जाते हैं, तो retryAttempts को फेंक दिया जाएगा।

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंशेलकमांड

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

दिए गए adb shell कमांड को निष्पादित करता है, कमांड विफल होने पर कई बार पुनः प्रयास करता है।

डिफ़ॉल्ट मानों के साथ executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) का एक सरल रूप।

मापदंडों
command String : adb शेल कमांड चलाने के लिए

receiver IShellOutputReceiver : IShellOutputReceiver शेल आउटपुट को निर्देशित करने के लिए।

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंशेलV2कमांड

public abstract CommandResult executeShellV2Command (String command)

हेल्पर विधि जो adb शेल कमांड को निष्पादित करती है और कमांड स्टेटस आउटपुट, स्टडआउट और CommandResult के साथ ठीक से पॉप्युलेट किए गए कमांड रिसेट के रूप में परिणाम लौटाती है।

मापदंडों
command String : वह कमांड जिसे चलाया जाना चाहिए।

रिटर्न
CommandResult CommandResult में परिणाम।

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंशेलV2कमांड

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

हेल्पर विधि जो एक एडीबी शेल कमांड को निष्पादित करती है और कमांड स्टेटस आउटपुट और CommandResult के साथ ठीक से पॉप्युलेट किए गए कमांड रिसेट के रूप में परिणाम लौटाती है। stdout निर्दिष्ट स्ट्रीम को निर्देशित किया जाता है।

मापदंडों
command String : वह कमांड जिसे चलाया जाना चाहिए।

pipeToOutput OutputStream : ERROR(/OutputStream) जहां एसटीडी आउटपुट रीडायरेक्ट किया जाएगा, या शून्य।

रिटर्न
CommandResult CommandResult में परिणाम।

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंशेलV2कमांड

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

हेल्पर विधि जो एक एडीबी शेल कमांड को निष्पादित करती है और कमांड स्टेटस आउटपुट, स्टडआउट और CommandResult के साथ ठीक से पॉप्युलेट किए गए कमांड रिसेट के रूप में परिणाम लौटाती है।

मापदंडों
command String : वह कमांड जिसे चलाया जाना चाहिए।

pipeAsInput File : एक ERROR(/File) जिसे कमांड में इनपुट के रूप में पाइप किया जाएगा, या अशक्त।

रिटर्न
CommandResult CommandResult में परिणाम।

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

निष्पादित करेंशेलV2कमांड

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

कमांड व्यवहार को नियंत्रित करने के लिए अधिक मापदंडों के साथ adb शेल कमांड निष्पादित करता है।

मापदंडों
command String : adb शेल कमांड चलाने के लिए

maxTimeoutForCommand long : कमांड को पूरा करने के लिए अधिकतम टाइमआउट; समय में निर्दिष्ट इकाई timeUnit

timeUnit TimeUnit : maxTimeToOutputShellResponse के लिए इकाई

retryAttempts int : किसी अपवाद के कारण विफल होने पर कमांड को पुनः प्रयास करने की अधिकतम संख्या। यदि पुन: प्रयास सफलता के बिना किए जाते हैं, तो retryAttempts को फेंक दिया जाएगा।

रिटर्न
CommandResult

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

यह सभी देखें:

निष्पादित करेंशेलV2कमांड

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

कमांड व्यवहार को नियंत्रित करने के लिए अधिक मापदंडों के साथ adb शेल कमांड निष्पादित करता है।

मापदंडों
command String : adb शेल कमांड चलाने के लिए

maxTimeoutForCommand long : कमांड को पूरा करने के लिए अधिकतम टाइमआउट; समय में निर्दिष्ट इकाई timeUnit

timeUnit TimeUnit : maxTimeToOutputShellResponse के लिए इकाई

रिटर्न
CommandResult

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

यह सभी देखें:

निष्पादित करेंशेलV2कमांड

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

कमांड व्यवहार को नियंत्रित करने के लिए अधिक मापदंडों के साथ adb शेल कमांड निष्पादित करता है।

मापदंडों
command String : adb शेल कमांड चलाने के लिए

pipeAsInput File : एक ERROR(/File) जिसे कमांड में इनपुट के रूप में पाइप किया जाएगा, या अशक्त।

pipeToOutput OutputStream : ERROR(/OutputStream) जहां एसटीडी आउटपुट रीडायरेक्ट किया जाएगा, या शून्य।

maxTimeoutForCommand long : कमांड को पूरा करने के लिए अधिकतम टाइमआउट; समय में निर्दिष्ट इकाई timeUnit

timeUnit TimeUnit : maxTimeToOutputShellResponse के लिए इकाई

retryAttempts int : किसी अपवाद के कारण विफल होने पर कमांड को पुनः प्रयास करने की अधिकतम संख्या। यदि पुन: प्रयास सफलता के बिना किए जाते हैं, तो retryAttempts को फेंक दिया जाएगा।

रिटर्न
CommandResult

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

यह सभी देखें:

निष्पादित करेंशेलV2कमांड

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

कमांड व्यवहार को नियंत्रित करने के लिए अधिक मापदंडों के साथ adb शेल कमांड निष्पादित करता है।

मापदंडों
command String : adb शेल कमांड चलाने के लिए

pipeAsInput File : एक ERROR(/File) जिसे कमांड में इनपुट के रूप में पाइप किया जाएगा, या अशक्त।

pipeToOutput OutputStream : ERROR(/OutputStream) जहां एसटीडी आउटपुट रीडायरेक्ट किया जाएगा, या शून्य।

pipeToError OutputStream : ERROR(/OutputStream) जहां एसटीडी त्रुटि को पुनर्निर्देशित किया जाएगा, या शून्य।

maxTimeoutForCommand long : कमांड को पूरा करने के लिए अधिकतम टाइमआउट; समय में निर्दिष्ट इकाई timeUnit

timeUnit TimeUnit : maxTimeToOutputShellResponse के लिए इकाई

retryAttempts int : किसी अपवाद के कारण विफल होने पर कमांड को पुनः प्रयास करने की अधिकतम संख्या। यदि पुन: प्रयास सफलता के बिना किए जाते हैं, तो retryAttempts को फेंक दिया जाएगा।

रिटर्न
CommandResult

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

यह सभी देखें:

फास्टबूटवाइपपार्टिशन

public abstract CommandResult fastbootWipePartition (String partition)

हेल्पर विधि जो डिवाइस के लिए एक विभाजन को मिटा देती है।

यदि getUseFastbootErase() true , तो विभाजन को मिटाने के लिए फास्टबूट मिटा का उपयोग किया जाएगा। अगली बार डिवाइस बूट होने पर डिवाइस को एक फाइल सिस्टम बनाना चाहिए। अन्यथा, फास्टबूट प्रारूप का उपयोग किया जाता है जो डिवाइस पर एक नया फाइल सिस्टम बनाएगा।

डिवाइस के पहले से ही फास्टबूट मोड में होने पर उपयोग किए जाने की उम्मीद है।

मापदंडों
partition String : वाइप करने के लिए विभाजन

रिटर्न
CommandResult CommandResult जिसमें कमांड का आउटपुट होता है

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

प्राप्त करें

public abstract int getApiLevel ()

डिवाइस एपीआई स्तर प्राप्त करें। डिफ़ॉल्ट रूप से UNKNOWN_API_LEVEL

रिटर्न
int डिवाइस के एपीआई स्तर को इंगित करने वाला एक पूर्णांक

फेंकता
DeviceNotAvailableException

बेसबैंडसंस्करण प्राप्त करें

public abstract String getBasebandVersion ()

इस उपकरण का बेसबैंड (रेडियो) संस्करण प्राप्त करने की सुविधा विधि। रेडियो संस्करण प्राप्त करना उपकरण विशिष्ट है, इसलिए हो सकता है कि यह सभी उपकरणों के लिए सही जानकारी न लौटाए। यह विधि सही संस्करण जानकारी वापस करने के लिए gsm.version.baseband प्रॉपर्टी पर निर्भर करती है। यह कुछ सीडीएमए उपकरणों के लिए सटीक नहीं है और यहां लौटाया गया संस्करण फास्टबूट से रिपोर्ट किए गए संस्करण से मेल नहीं खा सकता है और सीडीएमए रेडियो के संस्करण को वापस नहीं कर सकता है। TL; DR यह विधि केवल सटीक संस्करण की रिपोर्ट करती है यदि gsm.version.baseband गुण fastboot getvar version-baseband द्वारा लौटाए गए संस्करण के समान है।

रिटर्न
String String बेसबैंड संस्करण या null यदि इसे निर्धारित नहीं किया जा सकता है (डिवाइस में कोई रेडियो नहीं है या संस्करण स्ट्रिंग को पढ़ा नहीं जा सकता है)

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

बैटरी प्राप्त करें

public abstract Integer getBattery ()

बैटरी स्तर अनुपलब्ध होने पर डिवाइस का वर्तमान बैटरी स्तर या नल लौटाता है।

रिटर्न
Integer

प्राप्त बूलियनप्रॉपर्टी

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

दी गई संपत्ति का बूलियन मान लौटाता है।

मापदंडों
name String : संपत्ति का नाम

defaultValue boolean : यदि संपत्ति खाली है या मौजूद नहीं है, तो वापस जाने के लिए डिफ़ॉल्ट मान।

रिटर्न
boolean true अगर संपत्ति का मूल्य "1" , "y" , "yes" , "on" , या "true" , तो false अगर संपत्ति का मूल्य "0" , "n" , "no" , "off" , "false" , या defaultValue अन्यथा।

फेंकता
DeviceNotAvailableException

GetBootHistory

public abstract  getBootHistory ()

हेल्पर विधि बूट इतिहास मानचित्र को बूट समय और बूट कारण के साथ एकत्रित करती है।

रिटर्न
बूट समय का नक्शा (युग के बाद से सेकंड में यूटीसी समय) और बूट कारण

फेंकता
DeviceNotAvailableException

getBootHistoryचूंकि

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

हेल्पर विधि बूट इतिहास मानचित्र को बूट समय और बूट कारण के साथ डिवाइस से युग और निर्दिष्ट समय इकाई के बाद से एकत्रित करती है। मिलीसेकंड में वर्तमान डिवाइस utcEpochTime विधि getDeviceDate() द्वारा प्राप्त किया जा सकता है।

मापदंडों
utcEpochTime long : युग के बाद से डिवाइस का समय।

timeUnit TimeUnit यूनिट: टाइम यूनिट TimeUnit यूनिट।

रिटर्न
बूट समय का नक्शा (युग के बाद से सेकंड में यूटीसी समय) और बूट कारण

फेंकता
DeviceNotAvailableException

बूटलोडर संस्करण प्राप्त करें

public abstract String getBootloaderVersion ()

इस उपकरण का बूटलोडर संस्करण प्राप्त करने की सुविधा विधि।

डिवाइस की वर्तमान स्थिति से बूटलोडर संस्करण को पुनः प्राप्त करने का प्रयास करेगा। (अर्थात यदि डिवाइस फास्टबूट मोड में है, तो यह फास्टबूट से संस्करण को पुनः प्राप्त करने का प्रयास करेगा)

रिटर्न
String String बूटलोडर संस्करण या null यदि यह नहीं पाया जा सकता है

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

बगरेपोर्ट प्राप्त करें

public abstract InputStreamSource getBugreport ()

डिवाइस से एक बग रिपोर्ट प्राप्त करता है।

इसके कार्यान्वयन की गारंटी है कि बिना sdcard (या जहां sdcard अभी तक माउंट नहीं किया गया है) के बिना डिवाइस पर काम करना जारी रखना है।

रिटर्न
InputStreamSource एक InputStreamSource जो मांग पर बग्रेपोर्ट सामग्री का उत्पादन करेगा। विफलता के मामले में, InputStreamSource एक खाली ERROR(/InputStream) उत्पन्न करेगा।

गेटबग्रेपोर्ट्ज़

public abstract InputStreamSource getBugreportz ()

डिवाइस से एक बग्रेपोर्ट्ज़ पुनर्प्राप्त करता है। ज़िप प्रारूप बग्रेपोर्ट में मुख्य बग्रेपोर्ट और अन्य लॉग फ़ाइलें होती हैं जो डिबगिंग के लिए उपयोगी होती हैं।

केवल 'adb संस्करण' के लिए समर्थित > 1.0.36

रिटर्न
InputStreamSource InputStreamSource वाली ज़िप फ़ाइल का एक इनपुटस्ट्रीम स्रोत, विफलता के मामले में शून्य लौटाता है।

गेटबिल्डअलियास

public abstract String getBuildAlias ()

डिवाइस के वर्तमान में चल रहे निर्माण के उपनाम को पुनः प्राप्त करें।

बिल्ड उपनाम आमतौर पर बिल्ड आईडी (आमतौर पर नेक्सस बिल्ड के लिए एक संख्या) की तुलना में अधिक पठनीय स्ट्रिंग है। उदाहरण के लिए, अंतिम Android 4.2 रिलीज़ में बिल्ड उपनाम JDQ39 है, और बिल्ड आईडी 573038

रिटर्न
String बिल्ड उपनाम या आईडी बनाने के लिए वापस आना अगर इसे पुनर्प्राप्त नहीं किया जा सका

फेंकता
DeviceNotAvailableException

बिल्ड फ्लेवर प्राप्त करें

public abstract String getBuildFlavor ()

डिवाइस के लिए बिल्ड फ्लेवर प्राप्त करें।

रिटर्न
String निर्माण स्वाद या शून्य अगर इसे पुनर्प्राप्त नहीं किया जा सका

फेंकता
DeviceNotAvailableException

गेटबिल्ड आईडी

public abstract String getBuildId ()

उस बिल्ड को पुनः प्राप्त करें जो डिवाइस वर्तमान में चल रहा है।

रिटर्न
String बिल्ड आईडी या IBuildInfo#UNKNOWN_BUILD_ID अगर इसे पुनर्प्राप्त नहीं किया जा सका

फेंकता
DeviceNotAvailableException

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

डिवाइस छवि पर हस्ताक्षर करने के लिए उपयोग किया जाने वाला कुंजी प्रकार लौटाता है

आमतौर पर Android उपकरणों पर परीक्षण-कुंजी (जैसे AOSP में) या रिलीज़-कुंजी (व्यक्तिगत डिवाइस निर्माताओं द्वारा नियंत्रित) के साथ हस्ताक्षर किए जा सकते हैं।

रिटर्न
String यदि हस्ताक्षर कुंजी पाई जाती है, तो शून्य अन्यथा।

फेंकता
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

यदि डिवाइस आवंटित किया गया है, तो कैश्ड डिवाइस DeviceDescriptor लौटाता है, अन्यथा वर्तमान DeviceDescriptor है।

रिटर्न
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

यदि डिवाइस आवंटित किया गया है, तो कैश्ड डिवाइस DeviceDescriptor लौटाता है, अन्यथा वर्तमान DeviceDescriptor है।

मापदंडों
shortDescriptor boolean : डिस्क्रिप्टर को न्यूनतम जानकारी तक सीमित करना है या नहीं

रिटर्न
DeviceDescriptor

बच्चे प्राप्त करें

public abstract String[] getChildren (String deviceFilePath)

IFileEntry का उपयोग करने का विकल्प जो कभी-कभी अनुमतियों के कारण काम नहीं करेगा।

मापदंडों
deviceFilePath String : डिवाइस पर पथ है जहां खोज करना है

रिटर्न
String[] डिवाइस पर पथ में सभी फ़ाइल युक्त स्ट्रिंग की सरणी।

फेंकता
DeviceNotAvailableException

getDeviceClass

public abstract String getDeviceClass ()

डिवाइस क्लास प्राप्त करें।

रिटर्न
String String डिवाइस वर्ग।

getDeviceDate

public abstract long getDeviceDate ()

युग के बाद से मिलीसेकंड में डिवाइस की तारीख लौटाएं।

रिटर्न
long युग प्रारूप में डिवाइस की तारीख।

फेंकता
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

वास्तविक डिवाइस ऑब्जेक्ट को पास किए बिना उस पर जानकारी प्राप्त करने के लिए डिवाइस जानकारी से डिवाइस DeviceDescriptor लौटाएं।

रिटर्न
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

वास्तविक डिवाइस ऑब्जेक्ट को पास किए बिना उस पर जानकारी प्राप्त करने के लिए डिवाइस जानकारी से डिवाइस DeviceDescriptor लौटाएं।

मापदंडों
shortDescriptor boolean : डिस्क्रिप्टर को न्यूनतम जानकारी तक सीमित करना है या नहीं

रिटर्न
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

डिवाइस की स्थिति प्राप्त करें।

रिटर्न
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

डिवाइस और किसी दिए गए ERROR(/Date) के बीच समय अंतर प्राप्त करने के लिए सहायक। युग के समय का आंतरिक रूप से उपयोग करें।

मापदंडों
date Date

रिटर्न
long मिलीसेकंड में अंतर

फेंकता
DeviceNotAvailableException

एमुलेटर आउटपुट प्राप्त करें

public abstract InputStreamSource getEmulatorOutput ()

एमुलेटर stdout और stderr . की स्ट्रीम प्राप्त करें

रिटर्न
InputStreamSource एमुलेटर आउटपुट

प्राप्त करेंExternalStoreफ्रीस्पेस

public abstract long getExternalStoreFreeSpace ()

डिवाइस बाहरी संग्रहण पर खाली स्थान की मात्रा निर्धारित करने के लिए सहायक विधि।

रिटर्न
long KB . में खाली जगह की मात्रा

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

getFastbootProductType

public abstract String getFastbootProductType ()

फास्टबूट मोड में होने पर इस डिवाइस के उत्पाद प्रकार को प्राप्त करने की सुविधा विधि।

इस विधि का उपयोग केवल तभी किया जाना चाहिए जब डिवाइस फास्टबूट में होना चाहिए। इस मामले में जेनेरिक getProductType() विधि की तुलना में इसका थोड़ा सुरक्षित संस्करण है, क्योंकि ITestDevice डिवाइस को फास्टबूट में पुनर्प्राप्त करना जानता है यदि डिवाइस गलत स्थिति में है या अनुत्तरदायी है।

रिटर्न
String String उत्पाद प्रकार का नाम या null यदि यह निर्धारित नहीं किया जा सकता है

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

फास्टबूट मोड में होने पर इस डिवाइस के उत्पाद प्रकार को प्राप्त करने की सुविधा विधि।

इस विधि का उपयोग केवल तभी किया जाना चाहिए जब डिवाइस फास्टबूट में होना चाहिए। इस मामले में जेनेरिक getProductType() विधि की तुलना में इसका थोड़ा सुरक्षित संस्करण है, क्योंकि ITestDevice डिवाइस को फास्टबूट में पुनर्प्राप्त करना जानता है यदि डिवाइस गलत स्थिति में है या अनुत्तरदायी है।

रिटर्न
String String उत्पाद प्रकार का नाम या null यदि यह निर्धारित नहीं किया जा सकता है

फेंकता
DeviceNotAvailableException यदि डिवाइस के साथ कनेक्शन खो गया है और उसे पुनर्प्राप्त नहीं किया जा सकता है।

GetFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

फास्टबूट मोड सीरियल नंबर देता है।

रिटर्न
String

फास्टबूट वैरिएबल प्राप्त करें

public abstract String getFastbootVariable (String variableName)

डिवाइस से दिए गए फास्टबूट चर मान को पुनः प्राप्त करें।

मापदंडों
variableName String : चर नाम

रिटर्न
String संपत्ति मूल्य या null अगर यह अस्तित्व में नहीं है

फेंकता
असमर्थित ऑपरेशन अपवाद
DeviceNotAvailableException

गेटफाइलएंट्री

public abstract IFileEntry getFileEntry (String path)

डिवाइस पर किसी दूरस्थ फ़ाइल का संदर्भ पुनर्प्राप्त करें।

मापदंडों
path String : पुनर्प्राप्त करने के लिए फ़ाइल पथ। '/' के सापेक्ष एक निरपेक्ष पथ या पथ हो सकता है। (अर्थात "/ सिस्टम" और "सिस्टम" सिंटैक्स दोनों समर्थित हैं)

रिटर्न
IFileEntry IFileEntry या null यदि दिए गए path पर फ़ाइल नहीं मिल सकती है

फेंकता
DeviceNotAvailableException

getIdevice

public abstract IDevice getIDevice ()

संबंधित ddmlib IDevice का संदर्भ देता है।

हर बार डिवाइस के डिस्कनेक्ट होने और adb से फिर से कनेक्ट होने पर DDMS द्वारा एक नया IDevice आवंटित किया जा सकता है। इस प्रकार कॉल करने वालों को IDevice का संदर्भ नहीं रखना चाहिए, क्योंकि वह संदर्भ बासी हो सकता है।

रिटर्न
IDevice IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

डिवाइस से दी गई संपत्ति का पूर्णांक मान देता है।

मापदंडों
name String : संपत्ति का नाम

defaultValue long : यदि संपत्ति खाली है या मौजूद नहीं है, तो वापस जाने के लिए डिफ़ॉल्ट मान।

रिटर्न
long संपत्ति मूल्य या defaultValue वैल्यू अगर संपत्ति खाली है, मौजूद नहीं है, या उसके पास पूर्णांक मान नहीं है।

फेंकता
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

पिछली बार जब ट्रेडफेड एपीआई ने ईपीओसीएच के बाद से मिलीसेकंड में रिबूट को ट्रिगर किया था, जैसा कि System.currentTimeMillis() द्वारा लौटाया गया था।

रिटर्न
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

डिवाइस का पहला लॉन्च किया गया API स्तर प्राप्त करें। डिफ़ॉल्ट रूप से UNKNOWN_API_LEVEL

रिटर्न
int डिवाइस के पहले लॉन्च किए गए एपीआई स्तर को इंगित करने वाला एक पूर्णांक

फेंकता
DeviceNotAvailableException

लॉगकैट प्राप्त करें

public abstract InputStreamSource getLogcat ()

लॉगकैट डेटा की एक स्नैपशॉट स्ट्रीम प्राप्त करता है।

दो मोड में काम करता है:

  • यदि लॉगकैट वर्तमान में पृष्ठभूमि में कैप्चर किया जा रहा है, तो बैकग्राउंड लॉगकैट कैप्चर की वर्तमान सामग्री के TestDeviceOptions.getMaxLogcatDataSize() बाइट्स पर वापस आ जाएगा।
  • अन्यथा, यदि डिवाइस वर्तमान में प्रतिसाद दे रहा है, तो लॉगकैट डेटा का एक स्थिर डंप लौटाएगा

    रिटर्न
    InputStreamSource

  • लॉगकैट प्राप्त करें

    public abstract InputStreamSource getLogcat (int maxBytes)

    कैप्चर किए गए लॉगकैट डेटा के अंतिम maxBytes की एक स्नैपशॉट स्ट्रीम प्राप्त करता है।

    उन मामलों के लिए उपयोगी जब आप संपूर्ण getLogcat() स्नैपशॉट प्राप्त करने के संभावित बड़े डिस्क स्थान दंड के बिना कैप्चर किए गए लॉगकैट डेटा के लगातार स्नैपशॉट कैप्चर करना चाहते हैं।

    मापदंडों
    maxBytes int : the maximum amount of data to return. Should be an amount that can comfortably fit in memory

    रिटर्न
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

    Get a dump of the current logcat for device. Unlike getLogcat() , this method will always return a static dump of the logcat.

    Has the disadvantage that nothing will be returned if device is not reachable.

    रिटर्न
    InputStreamSource a InputStreamSource of the logcat data. An empty stream is returned if fail to capture logcat data.

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

    Grabs a snapshot stream of captured logcat data starting the date provided. The time on the device should be used getDeviceDate() .

    मापदंडों
    date long : in millisecond since epoch format of when to start the snapshot until present. (can be be obtained using 'date +%s')

    रिटर्न
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

    Returns a mount point.

    Queries the device directly if the cached info in IDevice is not available.

    TODO: move this behavior to IDevice#getMountPoint(String)

    मापदंडों
    mountName String : the name of the mount point

    रिटर्न
    String the mount point or null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Returns a MountPointInfo corresponding to the specified mountpoint path, or null if that path has nothing mounted or otherwise does not appear in /proc/mounts as a mountpoint.

    मापदंडों
    mountpoint String

    रिटर्न
    ITestDevice.MountPointInfo A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts"

    फेंकता
    DeviceNotAvailableException

    getMountPointInfo

    public abstract  getMountPointInfo ()

    Returns a parsed version of the information in /proc/mounts on the device

    रिटर्न
    A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts"

    फेंकता
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

    Helper method to determine amount of free space on device partition.

    मापदंडों
    partition String

    रिटर्न
    long the amount of free space in KB

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

    Helper method runs the "pidof" and "stat" command and returns ProcessInfo object with PID and process start time of the given process.

    मापदंडों
    processName String : the proces name String.

    रिटर्न
    ProcessInfo ProcessInfo of given processName

    फेंकता
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    Returns the pid of the service or null if something went wrong.

    मापदंडों
    process String : The proces name String.

    रिटर्न
    String

    फेंकता
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

    Convenience method to get the product type of this device.

    This method will work if device is in either adb or fastboot mode.

    रिटर्न
    String the String product type name. Will not be null

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered, or if product type can not be determined

    getProductVariant

    public abstract String getProductVariant ()

    Convenience method to get the product variant of this device.

    This method will work if device is in either adb or fastboot mode.

    रिटर्न
    String the String product variant name or null if it cannot be determined

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    getProperty

    public abstract String getProperty (String name)

    Retrieve the given property value from the device.

    मापदंडों
    name String : the property name

    रिटर्न
    String the property value or null if it does not exist

    फेंकता
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

    Get the current recovery mode used for the device.

    रिटर्न
    ITestDevice.RecoveryMode the current recovery mode used for the device.

    getSerialNumber

    public abstract String getSerialNumber ()

    Convenience method to get serial number of this device.

    रिटर्न
    String the String serial number

    getTombstones

    public abstract  getTombstones ()

    Fetch and return the list of tombstones from the devices. Requires root.

    method is best-effort so if one tombstone fails to be pulled for any reason it will be missing from the list. Only a DeviceNotAvailableException will terminate the method early.

    रिटर्न
    A list of tombstone files, empty if no tombstone.

    फेंकता
    DeviceNotAvailableException

    getTotalMemory

    public abstract long getTotalMemory ()

    Returns total physical memory size in bytes or -1 in case of internal error

    रिटर्न
    long

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

    Get whether to use fastboot erase or fastboot format to wipe a partition on the device.

    रिटर्न
    boolean true if fastboot erase will be used or false if fastboot format will be used.

    isAdbRoot

    public abstract boolean isAdbRoot ()

    रिटर्न
    boolean true if device currently has adb root, false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    isAdbTcp

    public abstract boolean isAdbTcp ()

    रिटर्न
    boolean true if device is connected to adb-over-tcp, false otherwise.

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

    Check whether platform on device supports app enumeration

    रिटर्न
    boolean True if app enumeration is supported, false otherwise

    फेंकता
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Returns if the device is encrypted.

    रिटर्न
    boolean true if the device is encrypted.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

    Return True if the path on the device is a directory, false otherwise.

    मापदंडों
    deviceFilePath String

    रिटर्न
    boolean

    फेंकता
    DeviceNotAvailableException

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

    Returns if encryption is supported on the device.

    रिटर्न
    boolean true if the device supports encryption.

    फेंकता
    DeviceNotAvailableException

    isExecutable

    public abstract boolean isExecutable (String fullPath)

    Returns True if the file path on the device is an executable file, false otherwise.

    मापदंडों
    fullPath String

    रिटर्न
    boolean

    फेंकता
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

    Return true if the device is headless (no screen), false otherwise.

    रिटर्न
    boolean

    फेंकता
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

    Check whether platform on device supports runtime permission granting

    रिटर्न
    boolean True if runtime permission are supported, false otherwise.

    फेंकता
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    Returns true if device is in TestDeviceState#FASTBOOT or TestDeviceState.FASTBOOTD .

    रिटर्न
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Collects and log ANRs from the device.

    मापदंडों
    logger ITestLogger : an ITestLogger to log the ANRs.

    रिटर्न
    boolean True if the logging was successful, false otherwise.

    फेंकता
    DeviceNotAvailableException

    logBugreport

    public abstract boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Helper method to take a bugreport and log it to the reporters.

    मापदंडों
    dataName String : name under which the bugreport will be reported.

    listener ITestLogger : an ITestLogger to log the bugreport.

    रिटर्न
    boolean True if the logging was successful, false otherwise.

    logOnDevice

    public abstract void logOnDevice (String tag, 
                    Log.LogLevel level, 
                    String format, 
                    Object... args)

    Log a message in the logcat of the device. This is a safe call that will not throw even if the logging fails.

    मापदंडों
    tag String : The tag under which we log our message in the logcat.

    level Log.LogLevel : The debug level of the message in the logcat.

    format String : The message format.

    args Object : the args to be replaced via String.format().

    nonBlockingReboot

    public abstract void nonBlockingReboot ()

    Issues a command to reboot device and returns on command complete and when device is no longer visible to adb.

    फेंकता
    DeviceNotAvailableException

    postBootSetup

    public abstract void postBootSetup ()

    Perform instructions to configure device for testing that after every boot.

    Should be called after device is fully booted/available

    In normal circumstances this method doesn't need to be called explicitly, as implementations should perform these steps automatically when performing a reboot.

    Where it may need to be called is when device reboots due to other events (eg when a fastboot update command has completed)

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    postInvocationTearDown

    public void postInvocationTearDown ()

    This method is deprecated.
    Use postInvocationTearDown(Throwable) instead.

    Extra steps for device specific required clean up that will be executed after the invocation is done.

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

    Extra steps for device specific required clean up that will be executed after the invocation is done.

    मापदंडों
    invocationException Throwable : if any, the final exception raised by the invocation failure.

    preInvocationSetup

    public void preInvocationSetup (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.

    मापदंडों
    info IBuildInfo : The IBuildInfo of the device.

    attributes MultiMap : The attributes stored in the invocation context

    फेंकता
    com.android.tradefed.targetprep.TargetSetupError
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

    Recursively pull directory contents from device.

    मापदंडों
    deviceFilePath String : the absolute file path of the remote source

    localDir File : the local directory to pull files into

    रिटर्न
    boolean true if file was pulled successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    मापदंडों
    remoteFilePath String : the absolute path to file on device.

    userId int : The user id to pull from

    रिटर्न
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract File pullFile (String remoteFilePath)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    मापदंडों
    remoteFilePath String : the absolute path to file on device.

    रिटर्न
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

    Retrieves a file off device.

    मापदंडों
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    रिटर्न
    boolean true if file was retrieved successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile, 
                    int userId)

    Retrieves a file off device.

    मापदंडों
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    userId int : The user id to pull from

    रिटर्न
    boolean true if file was retrieved successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

    Retrieves a file off device, and returns the contents.

    मापदंडों
    remoteFilePath String : the absolute path to file on device.

    रिटर्न
    String A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    फेंकता
    DeviceNotAvailableException

    pullFileFromExternal

    public abstract File pullFileFromExternal (String remoteFilePath)

    A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

    मापदंडों
    remoteFilePath String : the path to file on device, relative to the device's external storage mountpoint

    रिटर्न
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                     excludedDirectories)

    Recursively push directory contents to device while excluding some directories that are filtered.

    मापदंडों
    localDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    excludedDirectories : Set of excluded directories names that shouldn't be pushed.

    रिटर्न
    boolean true if file was pushed successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

    Recursively push directory contents to device.

    मापदंडों
    localDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    रिटर्न
    boolean true if file was pushed successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    boolean evaluateContentProviderNeeded)

    Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

    मापदंडों
    localFile File : the local file to push

    deviceFilePath String : the remote destination absolute file path

    evaluateContentProviderNeeded boolean : whether to check if we need the content provider

    रिटर्न
    boolean true if file was pushed successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    Push a file to device. By default using a content provider.

    मापदंडों
    localFile File : the local file to push

    deviceFilePath String : the remote destination absolute file path

    रिटर्न
    boolean true if file was pushed successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

    Push file created from a string to device

    मापदंडों
    contents String : the contents of the file to push

    deviceFilePath String : the remote destination absolute file path

    रिटर्न
    boolean true if string was pushed successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    reboot

    public abstract void reboot ()

    Reboots the device into adb mode.

    Blocks until device becomes available.

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    reboot

    public abstract void reboot (String reason)

    Reboots the device into adb mode with given reason to be persisted across reboot.

    Blocks until device becomes available.

    Last reboot reason can be obtained by querying sys.boot.reason propety.

    मापदंडों
    reason String : a reason for this reboot, or null if no reason is specified.

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    Blocks until device is in bootloader mode.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    rebootIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Reboots the device into fastbootd mode.

    Blocks until device is in fastbootd mode.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    rebootIntoRecovery

    public abstract void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    Blocks until device enters recovery

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    rebootIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    मापदंडों
    autoReboot boolean : whether to automatically reboot the device after sideload

    फेंकता
    DeviceNotAvailableException if device is not in sideload after reboot

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    फेंकता
    DeviceNotAvailableException if device is not in sideload after reboot

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    rebootUntilOnline

    public abstract void rebootUntilOnline (String reason)

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    मापदंडों
    reason String : a reason for this reboot, or null if no reason is specified.

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    See also:

    rebootUserspace

    public abstract void rebootUserspace ()

    Reboots only userspace part of device.

    Blocks until device becomes available.

    WARNING. Userspace reboot is currently under active development, use it on your own risk.

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    rebootUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

    An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    remountSystemWritable

    public abstract void remountSystemWritable ()

    Make the system partition on the device writable. May reboot the device.

    फेंकता
    DeviceNotAvailableException

    remountVendorWritable

    public abstract void remountVendorWritable ()

    Make the vendor partition on the device writable. May reboot the device.

    फेंकता
    DeviceNotAvailableException

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                    ITestLifeCycleReceiver... listeners)

    Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

    मापदंडों
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners ITestLifeCycleReceiver : the test result listener(s)

    रिटर्न
    boolean true if test command completed. false if it failed to complete, but recovery succeeded

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Runs instrumentation tests, and provides device recovery.

    If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

    If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

    मापदंडों
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners : the test result listeners

    रिटर्न
    boolean true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

    runInstrumentationTestsAsUser

    public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                    ITestLifeCycleReceiver... listeners)

    Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

    मापदंडों
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    रिटर्न
    boolean

    फेंकता
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                     listeners)

    Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

    मापदंडों
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    रिटर्न
    boolean

    फेंकता
    DeviceNotAvailableException

    setDate

    public abstract void setDate (Date date)

    Sets the date on device

    Note: setting date on device requires root

    मापदंडों
    date Date : specify a particular date; will use host date if null

    फेंकता
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Set the TestDeviceOptions for the device

    मापदंडों
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

    Sets the given property value on the device. Requires adb root is true.

    मापदंडों
    propKey String : The key targeted to be set.

    propValue String : The property value to be set.

    रिटर्न
    boolean returns True if the setprop command was successful, False otherwise.

    फेंकता
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

    मापदंडों
    recovery IDeviceRecovery : the IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Set the current recovery mode to use for the device.

    Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

    मापदंडों
    mode ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not.

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

    मापदंडों
    useFastbootErase boolean : true if fastboot erase should be used or false if fastboot format should be used.

    startLogcat

    public abstract void startLogcat ()

    Start capturing logcat output from device in the background.

    Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

    When the device is no longer in use, stopLogcat() must be called.

    startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Close and delete the emulator output.

    stopLogcat

    public abstract void stopLogcat ()

    Stop capturing logcat output from device, and discard currently saved logcat data.

    Will have no effect if logcat output is not being captured.

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

    Switch device to adb-over-tcp mode.

    रिटर्न
    String the tcp serial number or null if device could not be switched

    फेंकता
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

    रिटर्न
    boolean true if switch was successful, false otherwise.

    फेंकता
    DeviceNotAvailableException

    syncFiles

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Incrementally syncs the contents of a local file directory to device.

    Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

    Hidden files (with names starting with ".") will be ignored.

    Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

    मापदंडों
    localFileDir File : the local file directory containing files to recursively push.

    deviceFilePath String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

    रिटर्न
    boolean true if files were synced successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    takeBugreport

    public abstract Bugreport takeBugreport ()

    Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue.

    File referenced in the Bugreport object need to be cleaned via Bugreport#close() .

    रिटर्न
    Bugreport

    unlockDevice

    public abstract boolean unlockDevice ()

    Unlocks the device if the device is in an encrypted state.

    This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

    रिटर्न
    boolean true if successful or if the device is unencrypted.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.
    UnsupportedOperationException if encryption is not supported on the device.

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

    Blocks until the device's boot complete flag is set.

    मापदंडों
    timeOut long : time in msecs to wait for the flag to be set

    रिटर्न
    boolean true if device's boot complete flag is set within the timeout

    फेंकता
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable ()

    Waits for the device to be responsive and available for testing. Uses default timeout.

    रिटर्न
    boolean True if device is available, False if recovery is disabled and unavailable.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

    Waits for the device to be responsive and available for testing.

    मापदंडों
    waitTime long : the time in ms to wait

    रिटर्न
    boolean True if device is available, False if recovery is disabled and unavailable.

    फेंकता
    DeviceNotAvailableException if device is still unresponsive after waitTime expires.

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

    Blocks until device is visible via fastboot. Use default timeout.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

    मापदंडों
    waitTime long : the time in ms to wait

    रिटर्न
    boolean true if device boots into recovery before time expires. false otherwise

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Blocks for the device to be in the 'adb sideload' state

    मापदंडों
    waitTime long : the time in ms to wait

    रिटर्न
    boolean true if device boots into sideload before time expires. false otherwise

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Blocks for the device to be not available ie missing from adb

    मापदंडों
    waitTime long : the time in ms to wait

    रिटर्न
    boolean true if device becomes not available before time expires. false otherwise

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

    Blocks until device is visible via adb. Uses default timeout

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

    Blocks until device is visible via adb.

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    मापदंडों
    waitTime long : the time in ms to wait

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

    Waits for device to be responsive to a basic adb shell command.

    मापदंडों
    waitTime long : the time in ms to wait

    रिटर्न
    boolean true if device becomes responsive before waitTime elapses.

    ,

    INativeDevice

    public interface INativeDevice

    com.android.tradefed.device.INativeDevice


    Provides an reliable and slightly higher level API to a ddmlib IDevice .

    Retries device commands for a configurable amount, and provides a device recovery interface for devices which are unresponsive.

    सारांश

    Constants

    int UNKNOWN_API_LEVEL

    Default value when API Level cannot be detected

    सार्वजनिक तरीके

    abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

    Check whether or not a feature is currently supported given a minimally supported level.

    abstract void clearLogcat ()

    Deletes any accumulated logcat data.

    abstract void deleteFile (String deviceFilePath)

    Helper method to delete a file or directory on the device.

    abstract boolean deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)

    Helper method to check if device soft-restarted by comparing current system_server with previous system_server ProcessInfo .

    abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

    Helper method to check whether device soft-restarted since the UTC time since epoch from device and its ERROR(/TimeUnit) .

    abstract boolean disableAdbRoot ()

    Turns off adb root.

    abstract boolean doesFileExist (String deviceFilePath)

    Helper method to determine if file on device exists.

    abstract boolean enableAdbRoot ()

    Turns on adb root.

    abstract String executeAdbCommand (long timeout, String... commandArgs)

    Helper method which executes a adb command as a system command with a specified timeout.

    abstract String executeAdbCommand (String... commandArgs)

    Helper method which executes a adb command as a system command.

    abstract CommandResult executeFastbootCommand (String... commandArgs)

    Helper method which executes a fastboot command as a system command with a default timeout of 2 minutes.

    abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)

    Helper method which executes a fastboot command as a system command.

    abstract CommandResult executeLongFastbootCommand ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs)

    Helper method which executes a long running fastboot command as a system command with system environment variables.

    abstract CommandResult executeLongFastbootCommand (String... commandArgs)

    Helper method which executes a long running fastboot command as a system command.

    abstract String executeShellCommand (String command)

    Helper method which executes a adb shell command and returns output as a String .

    abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

    Executes a adb shell command, with more parameters to control command behavior.

    abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)

    Executes a adb shell command, with more parameters to control command behavior.

    abstract void executeShellCommand (String command, IShellOutputReceiver receiver)

    Executes the given adb shell command, retrying multiple times if command fails.

    abstract CommandResult executeShellV2Command (String command)

    Helper method which executes a adb shell command and returns the results as a CommandResult properly populated with the command status output, stdout and stderr.

    abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)

    Helper method which executes an adb shell command and returns the results as a CommandResult properly populated with the command status output and stderr.

    abstract CommandResult executeShellV2Command (String command, File pipeAsInput)

    Helper method which executes an adb shell command and returns the results as a CommandResult properly populated with the command status output, stdout and stderr.

    abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

    Executes a adb shell command, with more parameters to control command behavior.

    abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)

    Executes a adb shell command, with more parameters to control command behavior.

    abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

    Executes a adb shell command, with more parameters to control command behavior.

    abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

    Executes a adb shell command, with more parameters to control command behavior.

    abstract CommandResult fastbootWipePartition (String partition)

    Helper method which wipes a partition for the device.

    abstract int getApiLevel ()

    Get the device API Level.

    abstract String getBasebandVersion ()

    Convenience method to get baseband (radio) version of this device.

    abstract Integer getBattery ()

    Returns the current battery level of a device or Null if battery level unavailable.

    abstract boolean getBooleanProperty (String name, boolean defaultValue)

    Returns boolean value of the given property.

    abstract getBootHistory ()

    Helper method collects the boot history map with boot time and boot reason.

    abstract getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)

    Helper method collects the boot history map with boot time and boot reason since the given time since epoch from device and the time unit specified.

    abstract String getBootloaderVersion ()

    Convenience method to get the bootloader version of this device.

    abstract InputStreamSource getBugreport ()

    Retrieves a bugreport from the device.

    abstract InputStreamSource getBugreportz ()

    Retrieves a bugreportz from the device.

    abstract String getBuildAlias ()

    Retrieve the alias of the build that the device is currently running.

    abstract String getBuildFlavor ()

    Retrieve the build flavor for the device.

    abstract String getBuildId ()

    Retrieve the build the device is currently running.

    abstract String getBuildSigningKeys ()

    Returns the key type used to sign the device image

    Typically Android devices may be signed with test-keys (like in AOSP) or release-keys (controlled by individual device manufacturers)

    abstract DeviceDescriptor getCachedDeviceDescriptor ()

    Returns a cached DeviceDescriptor if the device is allocated, otherwise returns the current DeviceDescriptor .

    abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

    Returns a cached DeviceDescriptor if the device is allocated, otherwise returns the current DeviceDescriptor .

    abstract String[] getChildren (String deviceFilePath)

    Alternative to using IFileEntry that sometimes won't work because of permissions.

    abstract String getDeviceClass ()

    Get the device class.

    abstract long getDeviceDate ()

    Return the date of the device in millisecond since epoch.

    abstract DeviceDescriptor getDeviceDescriptor ()

    Return a DeviceDescriptor from the device information to get info on it without passing the actual device object.

    abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

    Return a DeviceDescriptor from the device information to get info on it without passing the actual device object.

    abstract TestDeviceState getDeviceState ()

    Get the device's state.

    abstract long getDeviceTimeOffset (Date date)

    Helper to get the time difference between the device and a given ERROR(/Date) .

    abstract InputStreamSource getEmulatorOutput ()

    Get the stream of emulator stdout and stderr

    abstract long getExternalStoreFreeSpace ()

    Helper method to determine amount of free space on device external storage.

    abstract String getFastbootProductType ()

    Convenience method to get the product type of this device when its in fastboot mode.

    abstract String getFastbootProductVariant ()

    Convenience method to get the product type of this device when its in fastboot mode.

    abstract String getFastbootSerialNumber ()

    Returns the fastboot mode serial number.

    abstract String getFastbootVariable (String variableName)

    Retrieve the given fastboot variable value from the device.

    abstract IFileEntry getFileEntry (String path)

    Retrieve a reference to a remote file on device.

    abstract IDevice getIDevice ()

    Returns a reference to the associated ddmlib IDevice .

    abstract long getIntProperty (String name, long defaultValue)

    Returns integer value of the given property from the device.

    abstract long getLastExpectedRebootTimeMillis ()

    Returns the last time Tradefed APIs triggered a reboot in milliseconds since EPOCH as returned by System.currentTimeMillis() .

    abstract int getLaunchApiLevel ()

    Get the device's first launched API Level.

    abstract InputStreamSource getLogcat ()

    Grabs a snapshot stream of the logcat data.

    abstract InputStreamSource getLogcat (int maxBytes)

    Grabs a snapshot stream of the last maxBytes of captured logcat data.

    abstract InputStreamSource getLogcatDump ()

    Get a dump of the current logcat for device.

    abstract InputStreamSource getLogcatSince (long date)

    Grabs a snapshot stream of captured logcat data starting the date provided.

    abstract String getMountPoint (String mountName)

    Returns a mount point.

    abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Returns a MountPointInfo corresponding to the specified mountpoint path, or null if that path has nothing mounted or otherwise does not appear in /proc/mounts as a mountpoint.

    abstract getMountPointInfo ()

    Returns a parsed version of the information in /proc/mounts on the device

    abstract long getPartitionFreeSpace (String partition)

    Helper method to determine amount of free space on device partition.

    abstract ProcessInfo getProcessByName (String processName)

    Helper method runs the "pidof" and "stat" command and returns ProcessInfo object with PID and process start time of the given process.

    abstract String getProcessPid (String process)

    Returns the pid of the service or null if something went wrong.

    abstract String getProductType ()

    Convenience method to get the product type of this device.

    abstract String getProductVariant ()

    Convenience method to get the product variant of this device.

    abstract String getProperty (String name)

    Retrieve the given property value from the device.

    abstract ITestDevice.RecoveryMode getRecoveryMode ()

    Get the current recovery mode used for the device.

    abstract String getSerialNumber ()

    Convenience method to get serial number of this device.

    abstract getTombstones ()

    Fetch and return the list of tombstones from the devices.

    abstract long getTotalMemory ()

    Returns total physical memory size in bytes or -1 in case of internal error

    abstract boolean getUseFastbootErase ()

    Get whether to use fastboot erase or fastboot format to wipe a partition on the device.

    abstract boolean isAdbRoot ()
    abstract boolean isAdbTcp ()
    abstract boolean isAppEnumerationSupported ()

    Check whether platform on device supports app enumeration

    abstract boolean isDeviceEncrypted ()

    Returns if the device is encrypted.

    abstract boolean isDirectory (String deviceFilePath)

    Return True if the path on the device is a directory, false otherwise.

    abstract boolean isEncryptionSupported ()

    Returns if encryption is supported on the device.

    abstract boolean isExecutable (String fullPath)

    Returns True if the file path on the device is an executable file, false otherwise.

    abstract boolean isHeadless ()

    Return true if the device is headless (no screen), false otherwise.

    abstract boolean isRuntimePermissionSupported ()

    Check whether platform on device supports runtime permission granting

    abstract boolean isStateBootloaderOrFastbootd ()

    Returns true if device is in TestDeviceState#FASTBOOT or TestDeviceState.FASTBOOTD .

    abstract boolean logAnrs ( ITestLogger logger)

    Collects and log ANRs from the device.

    abstract boolean logBugreport (String dataName, ITestLogger listener)

    Helper method to take a bugreport and log it to the reporters.

    abstract void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)

    Log a message in the logcat of the device.

    abstract void nonBlockingReboot ()

    Issues a command to reboot device and returns on command complete and when device is no longer visible to adb.

    abstract void postBootSetup ()

    Perform instructions to configure device for testing that after every boot.

    default void postInvocationTearDown ()

    This method is deprecated. Use postInvocationTearDown(Throwable) instead.

    abstract void postInvocationTearDown (Throwable invocationException)

    Extra steps for device specific required clean up that will be executed after the invocation is done.

    default void preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes)

    Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.

    abstract boolean pullDir (String deviceFilePath, File localDir)

    Recursively pull directory contents from device.

    abstract File pullFile (String remoteFilePath, int userId)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    abstract File pullFile (String remoteFilePath)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    abstract boolean pullFile (String remoteFilePath, File localFile)

    Retrieves a file off device.

    abstract boolean pullFile (String remoteFilePath, File localFile, int userId)

    Retrieves a file off device.

    abstract String pullFileContents (String remoteFilePath)

    Retrieves a file off device, and returns the contents.

    abstract File pullFileFromExternal (String remoteFilePath)

    A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

    abstract boolean pushDir (File localDir, String deviceFilePath, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories)

    Recursively push directory contents to device while excluding some directories that are filtered.

    abstract boolean pushDir (File localDir, String deviceFilePath)

    Recursively push directory contents to device.

    abstract boolean pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)

    Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

    abstract boolean pushFile (File localFile, String deviceFilePath)

    Push a file to device.

    abstract boolean pushString (String contents, String deviceFilePath)

    Push file created from a string to device

    abstract void reboot ()

    Reboots the device into adb mode.

    abstract void reboot (String reason)

    Reboots the device into adb mode with given reason to be persisted across reboot.

    abstract void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    abstract void rebootIntoFastbootd ()

    Reboots the device into fastbootd mode.

    abstract void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    abstract void rebootIntoSideload (boolean autoReboot)

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    abstract void rebootIntoSideload ()

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    abstract void rebootUntilOnline ()

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    abstract void rebootUntilOnline (String reason)

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    abstract void rebootUserspace ()

    Reboots only userspace part of device.

    abstract void rebootUserspaceUntilOnline ()

    An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

    abstract void remountSystemWritable ()

    Make the system partition on the device writable.

    abstract void remountVendorWritable ()

    Make the vendor partition on the device writable.

    abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)

    Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

    abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)

    Runs instrumentation tests, and provides device recovery.

    abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)

    Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

    abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)

    Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

    abstract void setDate (Date date)

    Sets the date on device

    Note: setting date on device requires root

    abstract void setOptions ( TestDeviceOptions options)

    Set the TestDeviceOptions for the device

    abstract boolean setProperty (String propKey, String propValue)

    Sets the given property value on the device.

    abstract void setRecovery ( IDeviceRecovery recovery)

    Set the IDeviceRecovery to use for this device.

    abstract void setRecoveryMode ( ITestDevice.RecoveryMode mode)

    Set the current recovery mode to use for the device.

    abstract void setUseFastbootErase (boolean useFastbootErase)

    Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

    abstract void startLogcat ()

    Start capturing logcat output from device in the background.

    abstract void stopEmulatorOutput ()

    Close and delete the emulator output.

    abstract void stopLogcat ()

    Stop capturing logcat output from device, and discard currently saved logcat data.

    abstract String switchToAdbTcp ()

    Switch device to adb-over-tcp mode.

    abstract boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

    abstract boolean syncFiles (File localFileDir, String deviceFilePath)

    Incrementally syncs the contents of a local file directory to device.

    abstract Bugreport takeBugreport ()

    Take a bugreport and returns it inside a Bugreport object to handle it.

    abstract boolean unlockDevice ()

    Unlocks the device if the device is in an encrypted state.

    abstract boolean waitForBootComplete (long timeOut)

    Blocks until the device's boot complete flag is set.

    abstract boolean waitForDeviceAvailable ()

    Waits for the device to be responsive and available for testing.

    abstract boolean waitForDeviceAvailable (long waitTime)

    Waits for the device to be responsive and available for testing.

    abstract void waitForDeviceBootloader ()

    Blocks until device is visible via fastboot.

    abstract boolean waitForDeviceInRecovery (long waitTime)

    Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

    abstract boolean waitForDeviceInSideload (long waitTime)

    Blocks for the device to be in the 'adb sideload' state

    abstract boolean waitForDeviceNotAvailable (long waitTime)

    Blocks for the device to be not available ie missing from adb

    abstract void waitForDeviceOnline ()

    Blocks until device is visible via adb.

    abstract void waitForDeviceOnline (long waitTime)

    Blocks until device is visible via adb.

    abstract boolean waitForDeviceShell (long waitTime)

    Waits for device to be responsive to a basic adb shell command.

    Constants

    UNKNOWN_API_LEVEL

    public static final int UNKNOWN_API_LEVEL

    Default value when API Level cannot be detected

    Constant Value: -1 (0xffffffff)

    सार्वजनिक तरीके

    checkApiLevelAgainstNextRelease

    public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

    Check whether or not a feature is currently supported given a minimally supported level. This method takes into account unreleased features yet, before API level is raised.

    मापदंडों
    strictMinLevel int : The strict min possible level that supports the feature.

    रिटर्न
    boolean True if the level is supported. False otherwise.

    फेंकता
    DeviceNotAvailableException

    clearLogcat

    public abstract void clearLogcat ()

    Deletes any accumulated logcat data.

    This is useful for cases when you want to ensure ITestDevice#getLogcat() only returns log data produced after a certain point (such as after flashing a new device build, etc).

    deleteFile

    public abstract void deleteFile (String deviceFilePath)

    Helper method to delete a file or directory on the device.

    मापदंडों
    deviceFilePath String : The absolute path of the file on the device.

    फेंकता
    DeviceNotAvailableException

    deviceSoftRestarted

    public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

    Helper method to check if device soft-restarted by comparing current system_server with previous system_server ProcessInfo . Use getProcessByName(String) to get ProcessInfo .

    मापदंडों
    prevSystemServerProcess ProcessInfo : the previous system_server process ProcessInfo .

    रिटर्न
    boolean true if device soft-restarted

    फेंकता
    RuntimeException if device has abnormal boot reason
    DeviceNotAvailableException

    deviceSoftRestartedSince

    public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                    TimeUnit timeUnit)

    Helper method to check whether device soft-restarted since the UTC time since epoch from device and its ERROR(/TimeUnit) . Soft-Restart refers to system_server restarted outside of a device hard reboot (for example: requested reboot). The current device utcEpochTime in Milliseccond can be obtained by method getDeviceDate() .

    मापदंडों
    utcEpochTime long : the device time in second since epoch.

    timeUnit TimeUnit : the time unit TimeUnit for the given utcEpochTime.

    रिटर्न
    boolean true if device soft-restarted

    फेंकता
    RuntimeException if device has abnormal boot reason
    DeviceNotAvailableException

    disableAdbRoot

    public abstract boolean disableAdbRoot ()

    Turns off adb root.

    Disabling adb root may cause device to disconnect from adb. This method will block until device is available.

    रिटर्न
    boolean true if successful.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    doesFileExist

    public abstract boolean doesFileExist (String deviceFilePath)

    Helper method to determine if file on device exists.

    मापदंडों
    deviceFilePath String : the absolute path of file on device to check

    रिटर्न
    boolean true if file exists, false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    enableAdbRoot

    public abstract boolean enableAdbRoot ()

    Turns on adb root. If the "enable-root" setting is "false", will log a message and return without enabling root.

    Enabling adb root may cause device to disconnect from adb. This method will block until device is available.

    रिटर्न
    boolean true if successful.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeAdbCommand

    public abstract String executeAdbCommand (long timeout, 
                    String... commandArgs)

    Helper method which executes a adb command as a system command with a specified timeout.

    executeShellCommand(String) should be used instead wherever possible, as that method provides better failure detection and performance.

    मापदंडों
    timeout long : the time in milliseconds before the device is considered unresponsive, 0L for no timeout

    commandArgs String : the adb command and arguments to run

    रिटर्न
    String the stdout from command. null if command failed to execute.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeAdbCommand

    public abstract String executeAdbCommand (String... commandArgs)

    Helper method which executes a adb command as a system command.

    executeShellCommand(String) should be used instead wherever possible, as that method provides better failure detection and performance.

    मापदंडों
    commandArgs String : the adb command and arguments to run

    रिटर्न
    String the stdout from command. null if command failed to execute.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeFastbootCommand

    public abstract CommandResult executeFastbootCommand (String... commandArgs)

    Helper method which executes a fastboot command as a system command with a default timeout of 2 minutes.

    Expected to be used when device is already in fastboot mode.

    मापदंडों
    commandArgs String : the fastboot command and arguments to run

    रिटर्न
    CommandResult the CommandResult containing output of command

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeFastbootCommand

    public abstract CommandResult executeFastbootCommand (long timeout, 
                    String... commandArgs)

    Helper method which executes a fastboot command as a system command.

    Expected to be used when device is already in fastboot mode.

    मापदंडों
    timeout long : the time in milliseconds before the command expire

    commandArgs String : the fastboot command and arguments to run

    रिटर्न
    CommandResult the CommandResult containing output of command

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeLongFastbootCommand

    public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                    String... commandArgs)

    Helper method which executes a long running fastboot command as a system command with system environment variables.

    Identical to executeFastbootCommand(String) except uses a longer timeout.

    मापदंडों
    envVarMap : the system environment variables that the fastboot command run with

    commandArgs String : the fastboot command and arguments to run

    रिटर्न
    CommandResult the CommandResult containing output of command

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeLongFastbootCommand

    public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

    Helper method which executes a long running fastboot command as a system command.

    Identical to executeFastbootCommand(String) except uses a longer timeout.

    मापदंडों
    commandArgs String : the fastboot command and arguments to run

    रिटर्न
    CommandResult the CommandResult containing output of command

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeShellCommand

    public abstract String executeShellCommand (String command)

    Helper method which executes a adb shell command and returns output as a String .

    मापदंडों
    command String : the adb shell command to run

    रिटर्न
    String the shell output

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeShellCommand

    public abstract void executeShellCommand (String command, 
                    IShellOutputReceiver receiver, 
                    long maxTimeToOutputShellResponse, 
                    TimeUnit timeUnit, 
                    int retryAttempts)

    Executes a adb shell command, with more parameters to control command behavior.

    मापदंडों
    command String : the adb shell command to run

    receiver IShellOutputReceiver : the IShellOutputReceiver to direct shell output to.

    maxTimeToOutputShellResponse long : the maximum amount of time during which the command is allowed to not output any response; unit as specified in timeUnit

    timeUnit TimeUnit : unit for maxTimeToOutputShellResponse

    retryAttempts int : the maximum number of times to retry command if it fails due to a exception. DeviceNotResponsiveException will be thrown if retryAttempts are performed without success.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeShellCommand

    public abstract void executeShellCommand (String command, 
                    IShellOutputReceiver receiver, 
                    long maxTimeoutForCommand, 
                    long maxTimeToOutputShellResponse, 
                    TimeUnit timeUnit, 
                    int retryAttempts)

    Executes a adb shell command, with more parameters to control command behavior.

    मापदंडों
    command String : the adb shell command to run

    receiver IShellOutputReceiver : the IShellOutputReceiver to direct shell output to.

    maxTimeoutForCommand long : the maximum timeout for the command to complete; unit as specified in timeUnit

    maxTimeToOutputShellResponse long : the maximum amount of time during which the command is allowed to not output any response; unit as specified in timeUnit

    timeUnit TimeUnit : unit for maxTimeToOutputShellResponse

    retryAttempts int : the maximum number of times to retry command if it fails due to a exception. DeviceNotResponsiveException will be thrown if retryAttempts are performed without success.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeShellCommand

    public abstract void executeShellCommand (String command, 
                    IShellOutputReceiver receiver)

    Executes the given adb shell command, retrying multiple times if command fails.

    A simpler form of executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) with default values.

    मापदंडों
    command String : the adb shell command to run

    receiver IShellOutputReceiver : the IShellOutputReceiver to direct shell output to.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeShellV2Command

    public abstract CommandResult executeShellV2Command (String command)

    Helper method which executes a adb shell command and returns the results as a CommandResult properly populated with the command status output, stdout and stderr.

    मापदंडों
    command String : The command that should be run.

    रिटर्न
    CommandResult The result in CommandResult .

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeShellV2Command

    public abstract CommandResult executeShellV2Command (String command, 
                    OutputStream pipeToOutput)

    Helper method which executes an adb shell command and returns the results as a CommandResult properly populated with the command status output and stderr. stdout is directed to the specified stream.

    मापदंडों
    command String : The command that should be run.

    pipeToOutput OutputStream : ERROR(/OutputStream) where the std output will be redirected, or null.

    रिटर्न
    CommandResult The result in CommandResult .

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeShellV2Command

    public abstract CommandResult executeShellV2Command (String command, 
                    File pipeAsInput)

    Helper method which executes an adb shell command and returns the results as a CommandResult properly populated with the command status output, stdout and stderr.

    मापदंडों
    command String : The command that should be run.

    pipeAsInput File : A ERROR(/File) that will be piped as input to the command, or null.

    रिटर्न
    CommandResult The result in CommandResult .

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeShellV2Command

    public abstract CommandResult executeShellV2Command (String command, 
                    long maxTimeoutForCommand, 
                    TimeUnit timeUnit, 
                    int retryAttempts)

    Executes a adb shell command, with more parameters to control command behavior.

    मापदंडों
    command String : the adb shell command to run

    maxTimeoutForCommand long : the maximum timeout for the command to complete; unit as specified in timeUnit

    timeUnit TimeUnit : unit for maxTimeToOutputShellResponse

    retryAttempts int : the maximum number of times to retry command if it fails due to a exception. DeviceNotResponsiveException will be thrown if retryAttempts are performed without success.

    रिटर्न
    CommandResult

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeShellV2Command

    public abstract CommandResult executeShellV2Command (String command, 
                    long maxTimeoutForCommand, 
                    TimeUnit timeUnit)

    Executes a adb shell command, with more parameters to control command behavior.

    मापदंडों
    command String : the adb shell command to run

    maxTimeoutForCommand long : the maximum timeout for the command to complete; unit as specified in timeUnit

    timeUnit TimeUnit : unit for maxTimeToOutputShellResponse

    रिटर्न
    CommandResult

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeShellV2Command

    public abstract CommandResult executeShellV2Command (String command, 
                    File pipeAsInput, 
                    OutputStream pipeToOutput, 
                    long maxTimeoutForCommand, 
                    TimeUnit timeUnit, 
                    int retryAttempts)

    Executes a adb shell command, with more parameters to control command behavior.

    मापदंडों
    command String : the adb shell command to run

    pipeAsInput File : A ERROR(/File) that will be piped as input to the command, or null.

    pipeToOutput OutputStream : ERROR(/OutputStream) where the std output will be redirected, or null.

    maxTimeoutForCommand long : the maximum timeout for the command to complete; unit as specified in timeUnit

    timeUnit TimeUnit : unit for maxTimeToOutputShellResponse

    retryAttempts int : the maximum number of times to retry command if it fails due to a exception. DeviceNotResponsiveException will be thrown if retryAttempts are performed without success.

    रिटर्न
    CommandResult

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    executeShellV2Command

    public abstract CommandResult executeShellV2Command (String command, 
                    File pipeAsInput, 
                    OutputStream pipeToOutput, 
                    OutputStream pipeToError, 
                    long maxTimeoutForCommand, 
                    TimeUnit timeUnit, 
                    int retryAttempts)

    Executes a adb shell command, with more parameters to control command behavior.

    मापदंडों
    command String : the adb shell command to run

    pipeAsInput File : A ERROR(/File) that will be piped as input to the command, or null.

    pipeToOutput OutputStream : ERROR(/OutputStream) where the std output will be redirected, or null.

    pipeToError OutputStream : ERROR(/OutputStream) where the std error will be redirected, or null.

    maxTimeoutForCommand long : the maximum timeout for the command to complete; unit as specified in timeUnit

    timeUnit TimeUnit : unit for maxTimeToOutputShellResponse

    retryAttempts int : the maximum number of times to retry command if it fails due to a exception. DeviceNotResponsiveException will be thrown if retryAttempts are performed without success.

    रिटर्न
    CommandResult

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    fastbootWipePartition

    public abstract CommandResult fastbootWipePartition (String partition)

    Helper method which wipes a partition for the device.

    If getUseFastbootErase() is true , then fastboot erase will be used to wipe the partition. The device must then create a filesystem the next time the device boots. Otherwise, fastboot format is used which will create a new filesystem on the device.

    Expected to be used when device is already in fastboot mode.

    मापदंडों
    partition String : the partition to wipe

    रिटर्न
    CommandResult the CommandResult containing output of command

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    getApiLevel

    public abstract int getApiLevel ()

    Get the device API Level. Defaults to UNKNOWN_API_LEVEL .

    रिटर्न
    int an integer indicating the API Level of device

    फेंकता
    DeviceNotAvailableException

    getBasebandVersion

    public abstract String getBasebandVersion ()

    Convenience method to get baseband (radio) version of this device. Getting the radio version is device specific, so it might not return the correct information for all devices. This method relies on the gsm.version.baseband propery to return the correct version information. This is not accurate for some CDMA devices and the version returned here might not match the version reported from fastboot and might not return the version for the CDMA radio. TL;DR this method only reports accurate version if the gsm.version.baseband property is the same as the version returned by fastboot getvar version-baseband .

    रिटर्न
    String the String baseband version or null if it cannot be determined (device has no radio or version string cannot be read)

    फेंकता
    DeviceNotAvailableException if the connection with the device is lost and cannot be recovered.

    getBattery

    public abstract Integer getBattery ()

    Returns the current battery level of a device or Null if battery level unavailable.

    रिटर्न
    Integer

    getBooleanProperty

    public abstract boolean getBooleanProperty (String name, 
                    boolean defaultValue)

    Returns boolean value of the given property.

    मापदंडों
    name String : the property name

    defaultValue boolean : default value to return if property is empty or doesn't exist.

    रिटर्न
    boolean true if the property has value "1" , "y" , "yes" , "on" , or "true" , false if the property has value of "0" , "n" , "no" , "off" , "false" , or defaultValue otherwise.

    फेंकता
    DeviceNotAvailableException

    getBootHistory

    public abstract  getBootHistory ()

    Helper method collects the boot history map with boot time and boot reason.

    रिटर्न
    Map of boot time (UTC time in second since Epoch) and boot reason

    फेंकता
    DeviceNotAvailableException

    getBootHistorySince

    public abstract  getBootHistorySince (long utcEpochTime, 
                    TimeUnit timeUnit)

    Helper method collects the boot history map with boot time and boot reason since the given time since epoch from device and the time unit specified. The current device utcEpochTime in Millisecond can be obtained by method getDeviceDate() .

    मापदंडों
    utcEpochTime long : the device time since Epoch.

    timeUnit TimeUnit : the time unit TimeUnit .

    रिटर्न
    Map of boot time (UTC time in second since Epoch) and boot reason

    फेंकता
    DeviceNotAvailableException

    getBootloaderVersion

    public abstract String getBootloaderVersion ()

    Convenience method to get the bootloader version of this device.

    Will attempt to retrieve bootloader version from the device's current state. (ie if device is in fastboot mode, it will attempt to retrieve version from fastboot)

    रिटर्न
    String the String bootloader version or null if it cannot be found

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    getBugreport

    public abstract InputStreamSource getBugreport ()

    Retrieves a bugreport from the device.

    The implementation of this is guaranteed to continue to work on a device without an sdcard (or where the sdcard is not yet mounted).

    रिटर्न
    InputStreamSource An InputStreamSource which will produce the bugreport contents on demand. In case of failure, the InputStreamSource will produce an empty ERROR(/InputStream) .

    getBugreportz

    public abstract InputStreamSource getBugreportz ()

    Retrieves a bugreportz from the device. Zip format bugreport contains the main bugreport and other log files that are useful for debugging.

    Only supported for 'adb version' > 1.0.36

    रिटर्न
    InputStreamSource a InputStreamSource of the zip file containing the bugreportz, return null in case of failure.

    getBuildAlias

    public abstract String getBuildAlias ()

    Retrieve the alias of the build that the device is currently running.

    Build alias is usually a more readable string than build id (typically a number for Nexus builds). For example, final Android 4.2 release has build alias JDQ39, and build id 573038

    रिटर्न
    String the build alias or fall back to build id if it could not be retrieved

    फेंकता
    DeviceNotAvailableException

    getBuildFlavor

    public abstract String getBuildFlavor ()

    Retrieve the build flavor for the device.

    रिटर्न
    String the build flavor or null if it could not be retrieved

    फेंकता
    DeviceNotAvailableException

    getBuildId

    public abstract String getBuildId ()

    Retrieve the build the device is currently running.

    रिटर्न
    String the build id or IBuildInfo#UNKNOWN_BUILD_ID if it could not be retrieved

    फेंकता
    DeviceNotAvailableException

    getBuildSigningKeys

    public abstract String getBuildSigningKeys ()

    Returns the key type used to sign the device image

    Typically Android devices may be signed with test-keys (like in AOSP) or release-keys (controlled by individual device manufacturers)

    रिटर्न
    String The signing key if found, null otherwise.

    फेंकता
    DeviceNotAvailableException

    getCachedDeviceDescriptor

    public abstract DeviceDescriptor getCachedDeviceDescriptor ()

    Returns a cached DeviceDescriptor if the device is allocated, otherwise returns the current DeviceDescriptor .

    रिटर्न
    DeviceDescriptor

    getCachedDeviceDescriptor

    public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

    Returns a cached DeviceDescriptor if the device is allocated, otherwise returns the current DeviceDescriptor .

    मापदंडों
    shortDescriptor boolean : Whether or not to limit descriptor to bare minimum info

    रिटर्न
    DeviceDescriptor

    getChildren

    public abstract String[] getChildren (String deviceFilePath)

    Alternative to using IFileEntry that sometimes won't work because of permissions.

    मापदंडों
    deviceFilePath String : is the path on the device where to do the search

    रिटर्न
    String[] Array of string containing all the file in a path on the device.

    फेंकता
    DeviceNotAvailableException

    getDeviceClass

    public abstract String getDeviceClass ()

    Get the device class.

    रिटर्न
    String the String device class.

    getDeviceDate

    public abstract long getDeviceDate ()

    Return the date of the device in millisecond since epoch.

    रिटर्न
    long the date of the device in epoch format.

    फेंकता
    DeviceNotAvailableException

    getDeviceDescriptor

    public abstract DeviceDescriptor getDeviceDescriptor ()

    Return a DeviceDescriptor from the device information to get info on it without passing the actual device object.

    रिटर्न
    DeviceDescriptor

    getDeviceDescriptor

    public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

    Return a DeviceDescriptor from the device information to get info on it without passing the actual device object.

    मापदंडों
    shortDescriptor boolean : Whether or not to limit descriptor to bare minimum info

    रिटर्न
    DeviceDescriptor

    getDeviceState

    public abstract TestDeviceState getDeviceState ()

    Get the device's state.

    रिटर्न
    TestDeviceState

    getDeviceTimeOffset

    public abstract long getDeviceTimeOffset (Date date)

    Helper to get the time difference between the device and a given ERROR(/Date) . Use Epoch time internally.

    मापदंडों
    date Date

    रिटर्न
    long the difference in milliseconds

    फेंकता
    DeviceNotAvailableException

    getEmulatorOutput

    public abstract InputStreamSource getEmulatorOutput ()

    Get the stream of emulator stdout and stderr

    रिटर्न
    InputStreamSource emulator output

    getExternalStoreFreeSpace

    public abstract long getExternalStoreFreeSpace ()

    Helper method to determine amount of free space on device external storage.

    रिटर्न
    long the amount of free space in KB

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    getFastbootProductType

    public abstract String getFastbootProductType ()

    Convenience method to get the product type of this device when its in fastboot mode.

    This method should only be used if device should be in fastboot. Its a bit safer variant than the generic getProductType() method in this case, because ITestDevice will know to recover device into fastboot if device is in incorrect state or is unresponsive.

    रिटर्न
    String the String product type name or null if it cannot be determined

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    getFastbootProductVariant

    public abstract String getFastbootProductVariant ()

    Convenience method to get the product type of this device when its in fastboot mode.

    This method should only be used if device should be in fastboot. Its a bit safer variant than the generic getProductType() method in this case, because ITestDevice will know to recover device into fastboot if device is in incorrect state or is unresponsive.

    रिटर्न
    String the String product type name or null if it cannot be determined

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    getFastbootSerialNumber

    public abstract String getFastbootSerialNumber ()

    Returns the fastboot mode serial number.

    रिटर्न
    String

    getFastbootVariable

    public abstract String getFastbootVariable (String variableName)

    Retrieve the given fastboot variable value from the device.

    मापदंडों
    variableName String : the variable name

    रिटर्न
    String the property value or null if it does not exist

    फेंकता
    UnsupportedOperationException
    DeviceNotAvailableException

    getFileEntry

    public abstract IFileEntry getFileEntry (String path)

    Retrieve a reference to a remote file on device.

    मापदंडों
    path String : the file path to retrieve. Can be an absolute path or path relative to '/'. (ie both "/system" and "system" syntax is supported)

    रिटर्न
    IFileEntry the IFileEntry or null if file at given path cannot be found

    फेंकता
    DeviceNotAvailableException

    getIDevice

    public abstract IDevice getIDevice ()

    Returns a reference to the associated ddmlib IDevice .

    A new IDevice may be allocated by DDMS each time the device disconnects and reconnects from adb. Thus callers should not keep a reference to the IDevice , because that reference may become stale.

    रिटर्न
    IDevice the IDevice

    getIntProperty

    public abstract long getIntProperty (String name, 
                    long defaultValue)

    Returns integer value of the given property from the device.

    मापदंडों
    name String : the property name

    defaultValue long : default value to return if property is empty or doesn't exist.

    रिटर्न
    long the property value or defaultValue if the property is empty, doesn't exist, or doesn't have an integer value.

    फेंकता
    DeviceNotAvailableException

    getLastExpectedRebootTimeMillis

    public abstract long getLastExpectedRebootTimeMillis ()

    Returns the last time Tradefed APIs triggered a reboot in milliseconds since EPOCH as returned by System.currentTimeMillis() .

    रिटर्न
    long

    getLaunchApiLevel

    public abstract int getLaunchApiLevel ()

    Get the device's first launched API Level. Defaults to UNKNOWN_API_LEVEL .

    रिटर्न
    int an integer indicating the first launched API Level of device

    फेंकता
    DeviceNotAvailableException

    getLogcat

    public abstract InputStreamSource getLogcat ()

    Grabs a snapshot stream of the logcat data.

    Works in two modes:

  • If the logcat is currently being captured in the background, will return up to TestDeviceOptions.getMaxLogcatDataSize() bytes of the current contents of the background logcat capture
  • Otherwise, will return a static dump of the logcat data if device is currently responding

    रिटर्न
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

    Grabs a snapshot stream of the last maxBytes of captured logcat data.

    Useful for cases when you want to capture frequent snapshots of the captured logcat data without incurring the potentially big disk space penalty of getting the entire getLogcat() snapshot.

    मापदंडों
    maxBytes int : the maximum amount of data to return. Should be an amount that can comfortably fit in memory

    रिटर्न
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

    Get a dump of the current logcat for device. Unlike getLogcat() , this method will always return a static dump of the logcat.

    Has the disadvantage that nothing will be returned if device is not reachable.

    रिटर्न
    InputStreamSource a InputStreamSource of the logcat data. An empty stream is returned if fail to capture logcat data.

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

    Grabs a snapshot stream of captured logcat data starting the date provided. The time on the device should be used getDeviceDate() .

    मापदंडों
    date long : in millisecond since epoch format of when to start the snapshot until present. (can be be obtained using 'date +%s')

    रिटर्न
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

    Returns a mount point.

    Queries the device directly if the cached info in IDevice is not available.

    TODO: move this behavior to IDevice#getMountPoint(String)

    मापदंडों
    mountName String : the name of the mount point

    रिटर्न
    String the mount point or null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Returns a MountPointInfo corresponding to the specified mountpoint path, or null if that path has nothing mounted or otherwise does not appear in /proc/mounts as a mountpoint.

    मापदंडों
    mountpoint String

    रिटर्न
    ITestDevice.MountPointInfo A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts"

    फेंकता
    DeviceNotAvailableException

    getMountPointInfo

    public abstract  getMountPointInfo ()

    Returns a parsed version of the information in /proc/mounts on the device

    रिटर्न
    A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts"

    फेंकता
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

    Helper method to determine amount of free space on device partition.

    मापदंडों
    partition String

    रिटर्न
    long the amount of free space in KB

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

    Helper method runs the "pidof" and "stat" command and returns ProcessInfo object with PID and process start time of the given process.

    मापदंडों
    processName String : the proces name String.

    रिटर्न
    ProcessInfo ProcessInfo of given processName

    फेंकता
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    Returns the pid of the service or null if something went wrong.

    मापदंडों
    process String : The proces name String.

    रिटर्न
    String

    फेंकता
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

    Convenience method to get the product type of this device.

    This method will work if device is in either adb or fastboot mode.

    रिटर्न
    String the String product type name. Will not be null

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered, or if product type can not be determined

    getProductVariant

    public abstract String getProductVariant ()

    Convenience method to get the product variant of this device.

    This method will work if device is in either adb or fastboot mode.

    रिटर्न
    String the String product variant name or null if it cannot be determined

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    getProperty

    public abstract String getProperty (String name)

    Retrieve the given property value from the device.

    मापदंडों
    name String : the property name

    रिटर्न
    String the property value or null if it does not exist

    फेंकता
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

    Get the current recovery mode used for the device.

    रिटर्न
    ITestDevice.RecoveryMode the current recovery mode used for the device.

    getSerialNumber

    public abstract String getSerialNumber ()

    Convenience method to get serial number of this device.

    रिटर्न
    String the String serial number

    getTombstones

    public abstract  getTombstones ()

    Fetch and return the list of tombstones from the devices. Requires root.

    method is best-effort so if one tombstone fails to be pulled for any reason it will be missing from the list. Only a DeviceNotAvailableException will terminate the method early.

    रिटर्न
    A list of tombstone files, empty if no tombstone.

    फेंकता
    DeviceNotAvailableException

    getTotalMemory

    public abstract long getTotalMemory ()

    Returns total physical memory size in bytes or -1 in case of internal error

    रिटर्न
    long

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

    Get whether to use fastboot erase or fastboot format to wipe a partition on the device.

    रिटर्न
    boolean true if fastboot erase will be used or false if fastboot format will be used.

    isAdbRoot

    public abstract boolean isAdbRoot ()

    रिटर्न
    boolean true if device currently has adb root, false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    isAdbTcp

    public abstract boolean isAdbTcp ()

    रिटर्न
    boolean true if device is connected to adb-over-tcp, false otherwise.

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

    Check whether platform on device supports app enumeration

    रिटर्न
    boolean True if app enumeration is supported, false otherwise

    फेंकता
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Returns if the device is encrypted.

    रिटर्न
    boolean true if the device is encrypted.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

    Return True if the path on the device is a directory, false otherwise.

    मापदंडों
    deviceFilePath String

    रिटर्न
    boolean

    फेंकता
    DeviceNotAvailableException

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

    Returns if encryption is supported on the device.

    रिटर्न
    boolean true if the device supports encryption.

    फेंकता
    DeviceNotAvailableException

    isExecutable

    public abstract boolean isExecutable (String fullPath)

    Returns True if the file path on the device is an executable file, false otherwise.

    मापदंडों
    fullPath String

    रिटर्न
    boolean

    फेंकता
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

    Return true if the device is headless (no screen), false otherwise.

    रिटर्न
    boolean

    फेंकता
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

    Check whether platform on device supports runtime permission granting

    रिटर्न
    boolean True if runtime permission are supported, false otherwise.

    फेंकता
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    Returns true if device is in TestDeviceState#FASTBOOT or TestDeviceState.FASTBOOTD .

    रिटर्न
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Collects and log ANRs from the device.

    मापदंडों
    logger ITestLogger : an ITestLogger to log the ANRs.

    रिटर्न
    boolean True if the logging was successful, false otherwise.

    फेंकता
    DeviceNotAvailableException

    logBugreport

    public abstract boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Helper method to take a bugreport and log it to the reporters.

    मापदंडों
    dataName String : name under which the bugreport will be reported.

    listener ITestLogger : an ITestLogger to log the bugreport.

    रिटर्न
    boolean True if the logging was successful, false otherwise.

    logOnDevice

    public abstract void logOnDevice (String tag, 
                    Log.LogLevel level, 
                    String format, 
                    Object... args)

    Log a message in the logcat of the device. This is a safe call that will not throw even if the logging fails.

    मापदंडों
    tag String : The tag under which we log our message in the logcat.

    level Log.LogLevel : The debug level of the message in the logcat.

    format String : The message format.

    args Object : the args to be replaced via String.format().

    nonBlockingReboot

    public abstract void nonBlockingReboot ()

    Issues a command to reboot device and returns on command complete and when device is no longer visible to adb.

    फेंकता
    DeviceNotAvailableException

    postBootSetup

    public abstract void postBootSetup ()

    Perform instructions to configure device for testing that after every boot.

    Should be called after device is fully booted/available

    In normal circumstances this method doesn't need to be called explicitly, as implementations should perform these steps automatically when performing a reboot.

    Where it may need to be called is when device reboots due to other events (eg when a fastboot update command has completed)

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    postInvocationTearDown

    public void postInvocationTearDown ()

    This method is deprecated.
    Use postInvocationTearDown(Throwable) instead.

    Extra steps for device specific required clean up that will be executed after the invocation is done.

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

    Extra steps for device specific required clean up that will be executed after the invocation is done.

    मापदंडों
    invocationException Throwable : if any, the final exception raised by the invocation failure.

    preInvocationSetup

    public void preInvocationSetup (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.

    मापदंडों
    info IBuildInfo : The IBuildInfo of the device.

    attributes MultiMap : The attributes stored in the invocation context

    फेंकता
    com.android.tradefed.targetprep.TargetSetupError
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

    Recursively pull directory contents from device.

    मापदंडों
    deviceFilePath String : the absolute file path of the remote source

    localDir File : the local directory to pull files into

    रिटर्न
    boolean true if file was pulled successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    मापदंडों
    remoteFilePath String : the absolute path to file on device.

    userId int : The user id to pull from

    रिटर्न
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract File pullFile (String remoteFilePath)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    मापदंडों
    remoteFilePath String : the absolute path to file on device.

    रिटर्न
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

    Retrieves a file off device.

    मापदंडों
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    रिटर्न
    boolean true if file was retrieved successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile, 
                    int userId)

    Retrieves a file off device.

    मापदंडों
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    userId int : The user id to pull from

    रिटर्न
    boolean true if file was retrieved successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

    Retrieves a file off device, and returns the contents.

    मापदंडों
    remoteFilePath String : the absolute path to file on device.

    रिटर्न
    String A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    फेंकता
    DeviceNotAvailableException

    pullFileFromExternal

    public abstract File pullFileFromExternal (String remoteFilePath)

    A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

    मापदंडों
    remoteFilePath String : the path to file on device, relative to the device's external storage mountpoint

    रिटर्न
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                     excludedDirectories)

    Recursively push directory contents to device while excluding some directories that are filtered.

    मापदंडों
    localDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    excludedDirectories : Set of excluded directories names that shouldn't be pushed.

    रिटर्न
    boolean true if file was pushed successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

    Recursively push directory contents to device.

    मापदंडों
    localDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    रिटर्न
    boolean true if file was pushed successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    boolean evaluateContentProviderNeeded)

    Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

    मापदंडों
    localFile File : the local file to push

    deviceFilePath String : the remote destination absolute file path

    evaluateContentProviderNeeded boolean : whether to check if we need the content provider

    रिटर्न
    boolean true if file was pushed successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    Push a file to device. By default using a content provider.

    मापदंडों
    localFile File : the local file to push

    deviceFilePath String : the remote destination absolute file path

    रिटर्न
    boolean true if file was pushed successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

    Push file created from a string to device

    मापदंडों
    contents String : the contents of the file to push

    deviceFilePath String : the remote destination absolute file path

    रिटर्न
    boolean true if string was pushed successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    reboot

    public abstract void reboot ()

    Reboots the device into adb mode.

    Blocks until device becomes available.

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    reboot

    public abstract void reboot (String reason)

    Reboots the device into adb mode with given reason to be persisted across reboot.

    Blocks until device becomes available.

    Last reboot reason can be obtained by querying sys.boot.reason propety.

    मापदंडों
    reason String : a reason for this reboot, or null if no reason is specified.

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    Blocks until device is in bootloader mode.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    rebootIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Reboots the device into fastbootd mode.

    Blocks until device is in fastbootd mode.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    rebootIntoRecovery

    public abstract void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    Blocks until device enters recovery

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    rebootIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    मापदंडों
    autoReboot boolean : whether to automatically reboot the device after sideload

    फेंकता
    DeviceNotAvailableException if device is not in sideload after reboot

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    फेंकता
    DeviceNotAvailableException if device is not in sideload after reboot

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    rebootUntilOnline

    public abstract void rebootUntilOnline (String reason)

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    मापदंडों
    reason String : a reason for this reboot, or null if no reason is specified.

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    See also:

    rebootUserspace

    public abstract void rebootUserspace ()

    Reboots only userspace part of device.

    Blocks until device becomes available.

    WARNING. Userspace reboot is currently under active development, use it on your own risk.

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    rebootUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

    An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

    फेंकता
    DeviceNotAvailableException if device is not available after reboot

    remountSystemWritable

    public abstract void remountSystemWritable ()

    Make the system partition on the device writable. May reboot the device.

    फेंकता
    DeviceNotAvailableException

    remountVendorWritable

    public abstract void remountVendorWritable ()

    Make the vendor partition on the device writable. May reboot the device.

    फेंकता
    DeviceNotAvailableException

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                    ITestLifeCycleReceiver... listeners)

    Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

    मापदंडों
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners ITestLifeCycleReceiver : the test result listener(s)

    रिटर्न
    boolean true if test command completed. false if it failed to complete, but recovery succeeded

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Runs instrumentation tests, and provides device recovery.

    If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

    If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

    मापदंडों
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners : the test result listeners

    रिटर्न
    boolean true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

    runInstrumentationTestsAsUser

    public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                    ITestLifeCycleReceiver... listeners)

    Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

    मापदंडों
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    रिटर्न
    boolean

    फेंकता
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                     listeners)

    Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

    मापदंडों
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    रिटर्न
    boolean

    फेंकता
    DeviceNotAvailableException

    setDate

    public abstract void setDate (Date date)

    Sets the date on device

    Note: setting date on device requires root

    मापदंडों
    date Date : specify a particular date; will use host date if null

    फेंकता
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Set the TestDeviceOptions for the device

    मापदंडों
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

    Sets the given property value on the device. Requires adb root is true.

    मापदंडों
    propKey String : The key targeted to be set.

    propValue String : The property value to be set.

    रिटर्न
    boolean returns True if the setprop command was successful, False otherwise.

    फेंकता
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

    Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

    मापदंडों
    recovery IDeviceRecovery : the IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Set the current recovery mode to use for the device.

    Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

    मापदंडों
    mode ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not.

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

    मापदंडों
    useFastbootErase boolean : true if fastboot erase should be used or false if fastboot format should be used.

    startLogcat

    public abstract void startLogcat ()

    Start capturing logcat output from device in the background.

    Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

    When the device is no longer in use, stopLogcat() must be called.

    startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Close and delete the emulator output.

    stopLogcat

    public abstract void stopLogcat ()

    Stop capturing logcat output from device, and discard currently saved logcat data.

    Will have no effect if logcat output is not being captured.

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

    Switch device to adb-over-tcp mode.

    रिटर्न
    String the tcp serial number or null if device could not be switched

    फेंकता
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

    रिटर्न
    boolean true if switch was successful, false otherwise.

    फेंकता
    DeviceNotAvailableException

    syncFiles

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Incrementally syncs the contents of a local file directory to device.

    Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

    Hidden files (with names starting with ".") will be ignored.

    Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

    मापदंडों
    localFileDir File : the local file directory containing files to recursively push.

    deviceFilePath String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

    रिटर्न
    boolean true if files were synced successfully. false otherwise.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    takeBugreport

    public abstract Bugreport takeBugreport ()

    Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue.

    File referenced in the Bugreport object need to be cleaned via Bugreport#close() .

    रिटर्न
    Bugreport

    unlockDevice

    public abstract boolean unlockDevice ()

    Unlocks the device if the device is in an encrypted state.

    This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

    रिटर्न
    boolean true if successful or if the device is unencrypted.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.
    UnsupportedOperationException if encryption is not supported on the device.

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

    Blocks until the device's boot complete flag is set.

    मापदंडों
    timeOut long : time in msecs to wait for the flag to be set

    रिटर्न
    boolean true if device's boot complete flag is set within the timeout

    फेंकता
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable ()

    Waits for the device to be responsive and available for testing. Uses default timeout.

    रिटर्न
    boolean True if device is available, False if recovery is disabled and unavailable.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

    Waits for the device to be responsive and available for testing.

    मापदंडों
    waitTime long : the time in ms to wait

    रिटर्न
    boolean True if device is available, False if recovery is disabled and unavailable.

    फेंकता
    DeviceNotAvailableException if device is still unresponsive after waitTime expires.

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

    Blocks until device is visible via fastboot. Use default timeout.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

    Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

    मापदंडों
    waitTime long : the time in ms to wait

    रिटर्न
    boolean true if device boots into recovery before time expires. false otherwise

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

    Blocks for the device to be in the 'adb sideload' state

    मापदंडों
    waitTime long : the time in ms to wait

    रिटर्न
    boolean true if device boots into sideload before time expires. false otherwise

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Blocks for the device to be not available ie missing from adb

    मापदंडों
    waitTime long : the time in ms to wait

    रिटर्न
    boolean true if device becomes not available before time expires. false otherwise

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

    Blocks until device is visible via adb. Uses default timeout

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

    Blocks until device is visible via adb.

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    मापदंडों
    waitTime long : the time in ms to wait

    फेंकता
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

    Waits for device to be responsive to a basic adb shell command.

    मापदंडों
    waitTime long : the time in ms to wait

    रिटर्न
    boolean true if device becomes responsive before waitTime elapses.