ตั้งแต่ปี 2026 เป็นต้นไป เราจะเผยแพร่ซอร์สโค้ดไปยัง AOSP ในไตรมาสที่ 2 และ 4 เพื่อให้สอดคล้องกับโมเดลการพัฒนาแบบ Trunk Stable และรับประกันความเสถียรของแพลตฟอร์มสำหรับระบบนิเวศ หากต้องการสร้างและมีส่วนร่วมใน AOSP ให้ใช้ android-latest-release android-latest-release สาขา Manifest จะอ้างอิงถึงรุ่นล่าสุดที่พุชไปยัง AOSP เสมอ ดูข้อมูลเพิ่มเติมได้ที่การเปลี่ยนแปลงใน AOSP

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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

คลาสย่อยโดยตรงที่ทราบ

TestDevice

TestDevice การติดตั้งใช้งาน ITestDevice สำหรับอุปกรณ์ Android แบบฟูลสแต็ก

คลาสย่อยทางอ้อมที่ทราบ

LocalAndroidVirtualDevice, ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	คลาสสำหรับอุปกรณ์เสมือนในเครื่องที่ทำงานบนโฮสต์ TradeFed
ManagedRemoteDevice	อุปกรณ์ที่ทำงานภายในเครื่องเสมือนซึ่งเราจัดการจากระยะไกลผ่านอินสแตนซ์ Tradefed ภายใน VM
NestedRemoteDevice	การแสดงอุปกรณ์ที่ทำงานภายใน VM ของ Cuttlefish ระยะไกล
RemoteAndroidDevice	การติดตั้งใช้งาน `ITestDevice` สำหรับอุปกรณ์ Android แบบฟูลสแต็กที่เชื่อมต่อผ่าน adb connect
RemoteAndroidVirtualDevice	ขยาย`RemoteAndroidDevice`ลักษณะการทำงานสำหรับอุปกรณ์ Android แบบฟูลสแต็กที่ทำงานใน Google Compute Engine (GCE)

การติดตั้งใช้งานเริ่มต้นของITestDeviceอุปกรณ์ Android ที่ไม่ใช่แบบฟูลสแต็ก

สรุป

คลาสที่ซ้อนกัน
`class`	`NativeDevice.AdbAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` สำหรับเรียกใช้คำสั่ง OS "adb ...."
`class`	`NativeDevice.AdbShellAction`
`class`	`NativeDevice.RebootDeviceAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` สำหรับการรีบูตอุปกรณ์

ค่าคงที่
`String`	`DEBUGFS_PATH`
`int`	`INVALID_USER_ID` ค่าที่แสดงสำหรับรหัสผู้ใช้ที่ไม่ถูกต้อง/ไม่พบ: UserHandle กำหนดค่า -10000
`long`	`MAX_HOST_DEVICE_TIME_OFFSET`
`int`	`MAX_RETRY_ATTEMPTS` จำนวนครั้งเริ่มต้นที่พยายามลองส่งคำสั่งอีกครั้ง
`String`	`SD_CARD`
`String`	`STORAGE_EMULATED`

ทุ่ง
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

เครื่องมือสร้างสาธารณะ
`NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)` สร้าง `TestDevice`

เมธอดสาธารณะ
`String`	`adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)` ติดตั้งแพ็กเกจ Android ในอุปกรณ์ด้วยคำสั่ง adb
`String`	`adbInstallPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` ติดตั้งแพ็กเกจ Android ในอุปกรณ์ด้วยคำสั่ง adb
`void`	`batchPrefetchStartupBuildProps()` การเพิ่มประสิทธิภาพขนาดเล็ก (ประมาณ 400 มิลลิวินาที) โดยการดึงข้อมูลพร็อพทั้งหมดที่เราต้องการล่วงหน้าแทนที่จะเรียกใช้ "adb getprop" สำหรับแต่ละรายการ
`boolean`	`canSwitchToHeadlessSystemUser()` แสดงว่าอนุญาตให้เปลี่ยนไปใช้ผู้ใช้ SYSTEM แบบไม่มีส่วนหัวหรือไม่
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` ตรวจสอบว่าระบบรองรับฟีเจอร์ในปัจจุบันหรือไม่ โดยพิจารณาจากระดับที่รองรับขั้นต่ำ
`boolean`	`checkConnectivity()` ตรวจสอบว่าอุปกรณ์มีการเชื่อมต่อเครือข่าย
`boolean`	`clearErrorDialogs()` พยายามปิดกล่องโต้ตอบข้อผิดพลาดที่แสดงอยู่ใน UI ของอุปกรณ์
`void`	`clearLastConnectedWifiNetwork()` ล้างเครือข่าย Wi-Fi ที่เชื่อมต่อล่าสุด
`void`	`clearLogcat()` ลบข้อมูล Logcat ที่สะสมไว้
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)` รูปแบบของ `connectToWifiNetwork(String,String)` ที่จะเชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ ไม่มีการเชื่อมต่อเครือข่ายในขณะนี้
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk)` รูปแบบของ `connectToWifiNetwork(String,String)` ที่จะเชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ ไม่มีการเชื่อมต่อเครือข่ายในขณะนี้
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)` เชื่อมต่อกับเครือข่าย Wi-Fi
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk)` เชื่อมต่อกับเครือข่าย Wi-Fi
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk, boolean scanSsid)` เชื่อมต่อกับเครือข่าย Wi-Fi
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk)` เชื่อมต่อกับเครือข่าย Wi-Fi
`int`	`createUser(String name, boolean guest, boolean ephemeral)` สร้างผู้ใช้ที่มีชื่อที่ระบุและ Flag ที่ระบุ
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` สร้างผู้ใช้ที่มีชื่อที่ระบุและ Flag ที่ระบุ
`int`	`createUser(String name)` สร้างผู้ใช้ที่มีชื่อที่ระบุและค่าสถานะเริ่มต้นเป็น 0
`int`	`createUserNoThrow(String name)` สร้างผู้ใช้ที่มีชื่อที่ระบุและค่าสถานะเริ่มต้นเป็น 0
`DeviceInspectionResult`	`debugDeviceNotAvailable()` ตรวจสอบอุปกรณ์และแสดงข้อมูลโดยละเอียดเมื่ออุปกรณ์ไม่พร้อมใช้งาน
`void`	`deleteFile(String deviceFilePath, int userId)` เมธอดช่วยในการลบไฟล์หรือไดเรกทอรีในอุปกรณ์
`void`	`deleteFile(String deviceFilePath)` เมธอดช่วยในการลบไฟล์หรือไดเรกทอรีในอุปกรณ์
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` นำ `IDeviceActionReceiver` ที่ลงทะเบียนออก
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` เมธอดช่วยในการตรวจสอบว่าอุปกรณ์รีสตาร์ทแบบซอฟต์หรือไม่โดยการเปรียบเทียบ system_server ปัจจุบันกับ system_server ก่อนหน้า `ProcessInfo`
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` เมธอด Helper เพื่อตรวจสอบว่าอุปกรณ์รีสตาร์ทแบบซอฟต์หรือไม่นับตั้งแต่เวลา UTC ตั้งแต่ Epoch จาก อุปกรณ์และ `TimeUnit`
`boolean`	`disableAdbRoot()` ปิดรูท adb
`void`	`disableKeyguard()` พยายามปิดใช้ Keyguard
`boolean`	`disableNetworkMonitor()` ปิดใช้การตรวจสอบเครือข่ายในอุปกรณ์
`boolean`	`disconnectFromWifi()` ยกเลิกการเชื่อมต่อจากเครือข่าย Wi-Fi
`boolean`	`doesFileExist(String deviceFilePath, int userId)` เมธอดตัวช่วยเพื่อตรวจสอบว่ามีไฟล์ในอุปกรณ์สำหรับผู้ใช้ที่ระบุหรือไม่
`boolean`	`doesFileExist(String deviceFilePath)` เมธอด Helper เพื่อตรวจสอบว่ามีไฟล์ในอุปกรณ์หรือไม่
`File`	`dumpHeap(String process, String devicePath)` พยายามดัมพ์ฮีปจาก system_server
`boolean`	`enableAdbRoot()` เปิดรูท adb
`boolean`	`enableNetworkMonitor()` เปิดใช้การตรวจสอบเครือข่ายในอุปกรณ์
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา
`String`	`executeAdbCommand(String... cmdArgs)` เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบ
`String`	`executeAdbCommand(long timeout, Map<String, String> envMap, String... cmdArgs)` เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา
`CommandResult`	`executeAdbV2Command(String... cmdArgs)` เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบ
`CommandResult`	`executeAdbV2Command(long timeout, String... cmdArgs)` เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา
`CommandResult`	`executeAdbV2Command(long timeout, Map<String, String> envMap, String... cmdArgs)` เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา
`CommandResult`	`executeAdbV2Command(long timeout, Map<String, String> envMap, int retryAttempts, String... cmdArgs)` เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` เมธอดช่วยที่เรียกใช้คำสั่ง fastboot เป็นคำสั่งของระบบโดยมีระยะหมดเวลาเริ่มต้น 2 นาที
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` เมธอดตัวช่วยที่เรียกใช้คำสั่ง fastboot เป็นคำสั่งของระบบ
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` เมธอดช่วยที่เรียกใช้คำสั่ง fastboot ที่ทำงานเป็นเวลานานในฐานะคำสั่งของระบบ
`CommandResult`	`executeLongFastbootCommand(Map<String, String> envVarMap, String... cmdArgs)` เมธอด Helper ซึ่งเรียกใช้คำสั่ง fastboot ที่ทำงานเป็นเวลานานในฐานะคำสั่งของระบบที่มีตัวแปรสภาพแวดล้อมของระบบ
`String`	`executeShellCommand(String command)` เมธอดช่วยที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น `String`
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` เรียกใช้คำสั่ง adb shell ที่ระบุ โดยจะลองอีกหลายครั้งหากคำสั่งล้มเหลว
`CommandResult`	`executeShellV2Command(String cmd)` เมธอด Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น `CommandResult` ที่มีเอาต์พุตสถานะคำสั่ง, stdout และ stderr อย่างถูกต้อง
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` เมธอด Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น `CommandResult` ที่มีเอาต์พุตสถานะคำสั่ง, stdout และ stderr อย่างถูกต้อง
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
`CommandResult`	`executeShellV2Command(String cmd, OutputStream pipeToOutput)` เมธอด Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น `CommandResult` ที่มีเอาต์พุตสถานะคำสั่งและ stderr อย่างถูกต้อง
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
`CommandResult`	`executeShellV2Command(String cmd, IShellOutputReceiver receiver)` เมธอด Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น `CommandResult` ที่มีเอาต์พุตสถานะคำสั่ง, stdout และ stderr อย่างถูกต้อง
`CommandResult`	`fastbootOemRamdumpNow()` วิธีการช่วยที่เรียกใช้ ramdump จากโหมด fastboot
`CommandResult`	`fastbootWipePartition(String partition)` วิธีการช่วยล้างพาร์ติชันสำหรับอุปกรณ์
`Set<ITestDevice.ApexInfo>`	`getActiveApexes()` ดึงข้อมูลเกี่ยวกับ APEX ที่เปิดใช้งานในอุปกรณ์
`String`	`getAdbPath()` แสดงเส้นทางของไบนารี adb ที่ใช้อยู่
`Map<String, String>`	`getAllSettings(String namespace)` แสดงผลคู่คีย์-ค่าของเนมสเปซที่ขอ
`DeviceAllocationState`	`getAllocationState()` แสดงผลสถานะการจัดสรรปัจจุบันของอุปกรณ์
`String`	`getAndroidId(int userId)` ค้นหาและแสดงผล android-id ที่เชื่อมโยงกับ userId หรือแสดงผล null หากไม่พบ
`Map<Integer, String>`	`getAndroidIds()` สร้างแผนที่ของรหัส Android ที่พบซึ่งตรงกับรหัสผู้ใช้
`int`	`getApiLevel()` รับระดับ API ของอุปกรณ์
`int`	`getApiLevelFull()` คล้ายกับ `getApiLevel()` แต่จะแสดงผลเวอร์ชันเต็ม
`PackageInfo`	`getAppPackageInfo(String packageName)` ดึงข้อมูลเกี่ยวกับแพ็กเกจที่ติดตั้งในอุปกรณ์
`List<PackageInfo>`	`getAppPackageInfos()` ดึงข้อมูลของแพ็กเกจที่ติดตั้งในอุปกรณ์
`String`	`getBasebandVersion()` วิธีการที่สะดวกในการรับเวอร์ชันเบสแบนด์ (วิทยุ) ของอุปกรณ์นี้
`Integer`	`getBattery()` แสดงระดับแบตเตอรี่ปัจจุบันของอุปกรณ์หรือ Null หากระดับแบตเตอรี่ไม่พร้อมใช้งาน
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` แสดงค่าบูลีนของพร็อพเพอร์ตี้ที่ระบุ
`Map<Long, String>`	`getBootHistory()` เมธอด Helper จะรวบรวมแผนที่ประวัติการบูตพร้อมเวลาและเหตุผลในการบูต
`Map<Long, String>`	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` เมธอด Helper จะรวบรวมแผนที่ประวัติการเปิดเครื่องพร้อมเวลาเปิดเครื่องและเหตุผลในการเปิดเครื่องตั้งแต่เวลาที่ระบุ นับตั้งแต่ Epoch จากอุปกรณ์และหน่วยเวลาที่ระบุ
`String`	`getBootloaderVersion()` วิธีที่สะดวกในการดูเวอร์ชัน Bootloader ของอุปกรณ์นี้
`InputStreamSource`	`getBugreport()` เรียกข้อมูลรายงานข้อบกพร่องจากอุปกรณ์
`InputStreamSource`	`getBugreportz()` เรียกข้อมูล bugreportz จากอุปกรณ์
`String`	`getBuildAlias()` ดึงข้อมูลชื่อแทนของบิลด์ที่อุปกรณ์กำลังใช้อยู่
`String`	`getBuildFlavor()` ดึงข้อมูลรสชาติของบิลด์สำหรับอุปกรณ์
`String`	`getBuildId()` เรียกข้อมูลบิลด์ที่อุปกรณ์ใช้อยู่ในปัจจุบัน
`String`	`getBuildSigningKeys()` แสดงประเภทคีย์ที่ใช้ลงนามในอิมเมจของอุปกรณ์ โดยปกติแล้ว อุปกรณ์ Android อาจได้รับการลงนามด้วยคีย์ทดสอบ (เช่น ใน AOSP) หรือคีย์รุ่น (ควบคุมโดยผู้ผลิตอุปกรณ์แต่ละราย)
`DeviceDescriptor`	`getCachedDeviceDescriptor()` แสดงผล `DeviceDescriptor` ที่แคชไว้หากมีการจัดสรรอุปกรณ์ มิเช่นนั้นจะแสดงผล `DeviceDescriptor` ปัจจุบัน
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` แสดงผล `DeviceDescriptor` ที่แคชไว้หากมีการจัดสรรอุปกรณ์ มิเช่นนั้นจะแสดงผล `DeviceDescriptor` ปัจจุบัน
`String[]`	`getChildren(String path)` ทางเลือกแทนการใช้ `IFileEntry` ซึ่งบางครั้งอาจใช้งานไม่ได้เนื่องจากสิทธิ์
`AbstractConnection`	`getConnection()` การเชื่อมต่อปัจจุบันที่เชื่อมโยงกับอุปกรณ์
`ContentProviderHandler`	`getContentProvider(int userId)` แสดง `ContentProviderHandler` หรือค่าว่างหากไม่มี
`DeviceFoldableState`	`getCurrentFoldableState()` แสดงสถานะการพับปัจจุบันของอุปกรณ์หรือค่าว่างหากเกิดปัญหา
`int`	`getCurrentUser()` แสดงรหัสของผู้ใช้ที่กำลังใช้งานอยู่
`String`	`getDeviceClass()` รับคลาสอุปกรณ์
`long`	`getDeviceDate()` แสดงวันที่ของอุปกรณ์เป็นมิลลิวินาทีที่เริ่มนับมาตั้งแต่วันที่ 1 มกราคม ค.ศ. 1970
`DeviceDescriptor`	`getDeviceDescriptor()` ส่งคืน `DeviceDescriptor` จากข้อมูลอุปกรณ์เพื่อรับข้อมูลเกี่ยวกับอุปกรณ์โดยไม่ต้อง ส่งออบเจ็กต์อุปกรณ์จริง
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` ส่งคืน `DeviceDescriptor` จากข้อมูลอุปกรณ์เพื่อรับข้อมูลเกี่ยวกับอุปกรณ์โดยไม่ต้อง ส่งออบเจ็กต์อุปกรณ์จริง
`TestDeviceState`	`getDeviceState()` รับสถานะของอุปกรณ์
`long`	`getDeviceTimeOffset(Date date)` Helper เพื่อรับความแตกต่างของเวลาระหว่างอุปกรณ์กับ `Date` ที่ระบุ
`InputStreamSource`	`getEmulatorOutput()` รับสตรีม stdout และ stderr ของโปรแกรมจำลอง
`Process`	`getEmulatorProcess()` แสดงผล `Process` ที่สอดคล้องกับโปรแกรมจำลองนี้
`final File`	`getExecuteShellCommandLog()` บันทึกที่มี`executeShellCommand(String)`ทั้งหมด
`long`	`getExternalStoreFreeSpace()` เมธอดตัวช่วยในการกำหนดจำนวนพื้นที่ว่างในที่เก็บข้อมูลภายนอกของอุปกรณ์
`String`	`getFastbootPath()` แสดงเส้นทางของไบนารี fastboot ที่ใช้อยู่
`String`	`getFastbootProductType()` วิธีที่สะดวกในการรับประเภทสินค้าของอุปกรณ์นี้เมื่ออยู่ในโหมด Fastboot
`String`	`getFastbootProductVariant()` วิธีที่สะดวกในการรับประเภทสินค้าของอุปกรณ์นี้เมื่ออยู่ในโหมด Fastboot
`String`	`getFastbootSerialNumber()` แสดงผลหมายเลขซีเรียลของ Fastboot Mode
`String`	`getFastbootVariable(String variableName)` ดึงค่าตัวแปร fastboot ที่ระบุจากอุปกรณ์
`String`	`getFastbootVersion()` แสดงผลสตริงเวอร์ชันของไบนารี fastboot ที่ใช้
`IFileEntry`	`getFileEntry(String path)` เรียกข้อมูลการอ้างอิงไปยังไฟล์ระยะไกลในอุปกรณ์
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` โปรแกรมช่วยที่ไม่เป็นทางการในการรับ `FileEntry` จากเส้นทางที่ไม่ใช่รูท
`Set<DeviceFoldableState>`	`getFoldableStates()` แสดงผลรายการสถานะการพับบนอุปกรณ์
`IDevice`	`getIDevice()` แสดงผลการอ้างอิงไปยัง ddmlib `IDevice` ที่เกี่ยวข้อง
`Set<String>`	`getInstalledPackageNames()` ดึงชื่อแพ็กเกจแอปพลิเคชันที่มีอยู่ในอุปกรณ์
`long`	`getIntProperty(String name, long defaultValue)` แสดงผลค่าจำนวนเต็มของพร็อพเพอร์ตี้ที่ระบุจากอุปกรณ์
`String`	`getIpAddress()` รับที่อยู่ IP ของอุปกรณ์
`KeyguardControllerState`	`getKeyguardState()` ส่งคืนออบเจ็กต์เพื่อรับสถานะปัจจุบันของ Keyguard หรือค่า Null หากไม่รองรับ
`long`	`getLastExpectedRebootTimeMillis()` แสดงเวลาล่าสุดที่ API ของ Tradefed ทริกเกอร์การรีบูตเป็นมิลลิวินาทีตั้งแต่ EPOCH ตามที่ `System.currentTimeMillis()` ส่งคืน
`int`	`getLaunchApiLevel()` รับระดับ API ที่เปิดตัวครั้งแรกของอุปกรณ์
`InputStreamSource`	`getLogcat()` ดึงสตรีมภาพรวมของข้อมูล Logcat
`InputStreamSource`	`getLogcat(int maxBytes)` ดึงสตรีมสแนปชอตของข้อมูล Logcat ที่บันทึกไว้ในช่วง `maxBytes` ที่ผ่านมา
`InputStreamSource`	`getLogcatDump()` รับการดัมพ์ของ Logcat ปัจจุบันสำหรับอุปกรณ์
`InputStreamSource`	`getLogcatSince(long date)` ดึงสตรีมสแนปชอตของข้อมูล Logcat ที่บันทึกไว้โดยเริ่มจากวันที่ที่ระบุ
`String`	`getMacAddress()` แสดงที่อยู่ MAC ของอุปกรณ์ หรือแสดงค่า Null หากเรียกข้อมูลจากอุปกรณ์ไม่สำเร็จ
`Integer`	`getMainUserId()` แสดงผลรหัสผู้ใช้หลัก
`Set<String>`	`getMainlineModuleInfo()` รับข้อมูลเกี่ยวกับโมดูล Mainline ที่ติดตั้งในอุปกรณ์
`int`	`getMaxNumberOfRunningUsersSupported()` รับจำนวนผู้ใช้สูงสุดที่รองรับซึ่งทำงานพร้อมกัน
`int`	`getMaxNumberOfUsersSupported(String userType)` รับจำนวนผู้ใช้ที่รองรับสูงสุดของประเภทผู้ใช้ที่ระบุ
`int`	`getMaxNumberOfUsersSupported()` รับจำนวนผู้ใช้ที่เปลี่ยนได้สูงสุดที่ระบบรองรับ โดยไม่รวมผู้ใช้ที่เป็นแขกรับเชิญ
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` ส่งคืน `IDeviceStateMonitor` ที่เชื่อมโยงกับอุปกรณ์
`String`	`getMountPoint(String mountName)` แสดงผลจุดต่อเชื่อม
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` แสดงผล `MountPointInfo` ที่สอดคล้องกับเส้นทางของจุดต่อเชื่อมที่ระบุ หรือ `null` หากเส้นทางนั้นไม่มีการติดตั้งอะไรเลย หรือไม่ปรากฏใน /proc/mounts เป็นจุดต่อเชื่อม
`List<ITestDevice.MountPointInfo>`	`getMountPointInfo()` แสดงผลข้อมูลใน /proc/mounts บนอุปกรณ์ในเวอร์ชันที่แยกวิเคราะห์แล้ว
`TestDeviceOptions`	`getOptions()` ดึงตัวเลือกการทดสอบสำหรับอุปกรณ์
`long`	`getPartitionFreeSpace(String partition)` วิธีการช่วยในการกำหนดปริมาณพื้นที่ว่างในพาร์ติชันของอุปกรณ์
`Integer`	`getPrimaryUserId()` แสดงผลรหัสผู้ใช้หลัก
`ProcessInfo`	`getProcessByName(String processName)` เมธอด Helper จะเรียกใช้คำสั่ง "pidof" และ "stat" และแสดงผลออบเจ็กต์ `ProcessInfo` ที่มี PID และเวลาเริ่มต้นของกระบวนการที่ระบุ
`String`	`getProcessPid(String process)` แสดง PID ของบริการหรือค่าว่างหากเกิดข้อผิดพลาด
`String`	`getProductType()` วิธีการที่สะดวกในการรับประเภทสินค้าของอุปกรณ์นี้
`String`	`getProductVariant()` วิธีการที่สะดวกในการรับสินค้าย่อยของอุปกรณ์นี้
`String`	`getProperty(String name)` ดึงค่าพร็อพเพอร์ตี้ที่ระบุจากอุปกรณ์
`ITestDevice.RecoveryMode`	`getRecoveryMode()` รับโหมดการกู้คืนปัจจุบันที่ใช้สำหรับอุปกรณ์
`int`	`getRemainingCreatableUserCount(String userType)` แสดงจำนวนผู้ใช้ประเภทผู้ใช้ที่ระบุซึ่งสร้างในอุปกรณ์นี้ได้
`InputStreamSource`	`getScreenshot(Long displayId, String format, boolean rescale)` ถ่ายภาพหน้าจอจากอุปกรณ์ที่ระบุรหัสจอแสดงผลในรูปแบบที่รองรับ
`InputStreamSource`	`getScreenshot(String format)` จับภาพหน้าจอจากอุปกรณ์
`InputStreamSource`	`getScreenshot(long displayId)` จับภาพหน้าจอจากอุปกรณ์ที่ระบุรหัสการแสดงผล
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` จับภาพหน้าจอจากอุปกรณ์
`InputStreamSource`	`getScreenshot()` จับภาพหน้าจอจากอุปกรณ์
`String`	`getSerialNumber()` วิธีที่สะดวกในการรับหมายเลขซีเรียลของอุปกรณ์นี้
`String`	`getSetting(int userId, String namespace, String key)` แสดงค่าของการตั้งค่าที่ขอ
`String`	`getSetting(String namespace, String key)` ดู `getSetting(int,String,String)` และดำเนินการกับผู้ใช้ระบบ
`String`	`getSimOperator()` ส่งคืนผู้ให้บริการซิมการ์ดหรือ Null หากไม่มีหรือหากอุปกรณ์ไม่พร้อมใช้งาน
`String`	`getSimState()` แสดงสถานะซิมการ์ดหรือ Null หากไม่มีหรืออุปกรณ์ไม่พร้อมใช้งาน
`List<File>`	`getTombstones()` ดึงและแสดงรายการเครื่องหมายหลุมศพจากอุปกรณ์
`long`	`getTotalMemory()` แสดงขนาดหน่วยความจำจริงทั้งหมดในหน่วยไบต์ หรือ -1 ในกรณีที่เกิดข้อผิดพลาดภายใน
`String`	`getTrackingSerial()` เพื่อวัตถุประสงค์ในการจัดการอุปกรณ์ ให้รับหมายเลขซีเรียลที่ใช้ในการติดตามอุปกรณ์
`Set<String>`	`getUninstallablePackageNames()` ดึงชื่อแพ็กเกจแอปพลิเคชันที่ถอนการติดตั้งได้
`boolean`	`getUseFastbootErase()` ดูว่าจะใช้ fastboot erase หรือ fastboot format เพื่อล้างพาร์ติชันในอุปกรณ์
`int`	`getUserFlags(int userId)` ค้นหาและแสดงผลการแจ้งของผู้ใช้ที่ระบุ
`Map<Integer, UserInfo>`	`getUserInfos()` รับแผนที่ของ useId ไปยัง `UserInfo` ในอุปกรณ์
`int`	`getUserSerialNumber(int userId)` ส่งคืนหมายเลขซีเรียลที่เชื่อมโยงกับ userId หากพบ หรือ -10000 ในกรณีอื่นๆ
`int`	`getUserVisibleOnDisplay(int displayId)` รับรหัสผู้ใช้ของผู้ใช้ที่มองเห็นได้บนจอแสดงผลที่ระบุ
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` ประมวลผล DeviceEvent ที่ระบุ ประมวลผล DeviceEvent ซึ่งอาจเปลี่ยนสถานะการจัดสรรอุปกรณ์นี้เป็นสถานะใหม่หรือไม่ก็ได้
`boolean`	`hasFeature(String feature)` ตรวจสอบว่าฟีเจอร์พร้อมใช้งานในอุปกรณ์หรือไม่
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)` เริ่มการเชื่อมต่อกับอุปกรณ์
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` ติดตั้งแพ็กเกจ Android ในอุปกรณ์
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` ติดตั้งแพ็กเกจ Android ในอุปกรณ์
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` ติดตั้งแพ็กเกจ Android ในอุปกรณ์สำหรับผู้ใช้ที่ระบุ
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` ติดตั้งแพ็กเกจ Android ในอุปกรณ์สำหรับผู้ใช้ที่ระบุ
`boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` ติดตั้ง APK ด้วยโหมดเพิ่ม
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการแจงนับแอปหรือไม่
`boolean`	`isBypassLowTargetSdkBlockSupported()` ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการข้ามการบล็อก SDK เป้าหมายต่ำในการติดตั้งแอปหรือไม่
`boolean`	`isDebugfsMounted()` ตรวจสอบว่าได้ติดตั้ง debugfs แล้วหรือไม่
`boolean`	`isDeviceEncrypted()` แสดงว่าอุปกรณ์มีการเข้ารหัสหรือไม่
`boolean`	`isDirectory(String path)` แสดงค่าเป็น True หากเส้นทางในอุปกรณ์เป็นไดเรกทอรี หากไม่ แสดงค่าเป็น False
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` แสดงว่าอุปกรณ์รองรับการเข้ารหัสหรือไม่
`boolean`	`isExecutable(String fullPath)` แสดงค่าเป็น True หากเส้นทางไฟล์ในอุปกรณ์เป็นไฟล์ที่เรียกใช้งานได้ หากไม่ แสดงค่าเป็น False
`boolean`	`isFastbootEnabled()` แสดงว่า Fastboot พร้อมใช้งานในอุปกรณ์หรือไม่
`boolean`	`isHeadless()` แสดงค่าเป็นจริงหากอุปกรณ์ไม่มีส่วนหัว (ไม่มีหน้าจอ) และแสดงค่าเป็นเท็จในกรณีอื่นๆ
`boolean`	`isHeadlessSystemUserMode()` แสดงว่าอุปกรณ์ใช้โหมดผู้ใช้ระบบแบบไม่มีส่วนหัวหรือไม่
`boolean`	`isMainUserPermanentAdmin()` แสดงว่าผู้ใช้หลักเป็นผู้ดูแลระบบถาวรและไม่สามารถลบหรือลดระดับเป็น สถานะที่ไม่ใช่ผู้ดูแลระบบได้
`boolean`	`isMultiUserSupported()` แสดงว่าอุปกรณ์นี้รองรับผู้ใช้ที่สลับได้หลายคนซึ่งมีข้อมูลเข้าสู่ระบบและ พื้นที่ที่ปรับแต่งได้ของตนเองหรือไม่
`boolean`	`isPackageInstalled(String packageName, String userId)` ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจและรหัสผู้ใช้ที่ระบุเพื่อตรวจสอบว่าผู้ใช้รายนั้น ติดตั้งแอปอยู่หรือไม่
`boolean`	`isPackageInstalled(String packageName)` ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจที่ระบุเพื่อตรวจสอบว่ามีการติดตั้งอยู่ในปัจจุบันหรือไม่
`boolean`	`isRuntimePermissionSupported()` ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการให้สิทธิ์รันไทม์หรือไม่
`boolean`	`isShellV2Support()`
`boolean`	`isStateBootloaderOrFastbootd()` แสดงค่าเป็น "จริง" หากอุปกรณ์อยู่ใน `TestDeviceState.FASTBOOT` หรือ `TestDeviceState.FASTBOOTD`
`boolean`	`isUserRunning(int userId)` ตรวจสอบว่าผู้ใช้ที่ระบุใช้งานอยู่หรือไม่
`boolean`	`isUserSecondary(int userId)` แสดงว่าผู้ใช้ที่ระบุเป็นผู้ใช้รองหรือไม่ตามสถานะ
`boolean`	`isUserVisible(int userId)` ตรวจสอบว่าผู้ใช้ที่ระบุปรากฏหรือไม่
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` ตรวจสอบว่าผู้ใช้ที่ระบุปรากฏในจอแสดงผลที่ระบุหรือไม่
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` แสดงว่าอุปกรณ์อนุญาตให้ผู้ใช้เริ่มแสดงในเบื้องหลังใน `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)` หรือไม่
`boolean`	`isVisibleBackgroundUsersSupported()` แสดงว่าอุปกรณ์อนุญาตให้ผู้ใช้เริ่มแสดงในเบื้องหลังได้หรือไม่
`boolean`	`isWifiEnabled()` ทดสอบว่าได้เปิดใช้ Wi-Fi หรือไม่
`Set<Long>`	`listDisplayIds()` รวบรวมรายการรหัสจอแสดงผลที่พร้อมใช้งานในอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger"
`Set<Integer>`	`listDisplayIdsForStartingVisibleBackgroundUsers()` รับรายการจอแสดงผลที่ใช้เพื่อ `start a user visible in the background` ได้
`ArrayList<Integer>`	`listUsers()` รับรายชื่อผู้ใช้ในอุปกรณ์
`boolean`	`logAnrs(ITestLogger logger)` รวบรวมและบันทึก ANR จากอุปกรณ์
`boolean`	`logBugreport(String dataName, ITestLogger listener)` เมธอด Helper เพื่อสร้างรายงานข้อบกพร่องและบันทึกไปยังผู้รายงาน
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` บันทึกข้อความใน Logcat ของอุปกรณ์
`void`	`mountDebugfs()` เมานต์ debugfs
`void`	`nonBlockingReboot()` ออกคำสั่งเพื่อรีบูตอุปกรณ์และกลับมาเมื่อคำสั่งเสร็จสมบูรณ์และเมื่อ adb ไม่เห็นอุปกรณ์อีกต่อไป
`void`	`postAdbRootAction()` แทนที่หากอุปกรณ์ต้องดำเนินการบางอย่างหลังจาก adb root และก่อนที่ อุปกรณ์จะกลับมาออนไลน์
`void`	`postAdbUnrootAction()` ลบล้างหากอุปกรณ์ต้องดำเนินการบางอย่างหลังจากเลิกรูทด้วย adb และก่อนที่อุปกรณ์จะกลับมาออนไลน์
`void`	`postBootSetup()` ทำตามวิธีการเพื่อกำหนดค่าอุปกรณ์สำหรับการทดสอบหลังจากการบูตทุกครั้ง
`void`	`postInvocationTearDown(Throwable exception)` ขั้นตอนเพิ่มเติมสำหรับการล้างข้อมูลที่จำเป็นสำหรับอุปกรณ์โดยเฉพาะ ซึ่งจะดำเนินการหลังจากเรียกใช้
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` ขั้นตอนเพิ่มเติมสำหรับการตั้งค่าที่จำเป็นเฉพาะอุปกรณ์ซึ่งจะดำเนินการในอุปกรณ์ก่อน ขั้นตอนการเรียกใช้
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์แบบเรียกซ้ำ
`boolean`	`pullDir(String deviceFilePath, File localDir)` ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์แบบเรียกซ้ำ
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId, long timeout)` ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์แบบเรียกซ้ำ
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId, long timeout)` ดึงไฟล์ออกจากอุปกรณ์
`boolean`	`pullFile(String remoteFilePath, File localFile)` ดึงไฟล์ออกจากอุปกรณ์
`File`	`pullFile(String remoteFilePath, int userId)` ดึงไฟล์จากอุปกรณ์ จัดเก็บไว้ใน`File`ชั่วคราวในเครื่อง และส่งคืน`File`
`File`	`pullFile(String remoteFilePath)` ดึงไฟล์จากอุปกรณ์ จัดเก็บไว้ใน`File`ชั่วคราวในเครื่อง และส่งคืน`File`
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` ดึงไฟล์ออกจากอุปกรณ์
`String`	`pullFileContents(String remoteFilePath)` ดึงไฟล์ออกจากอุปกรณ์และแสดงเนื้อหา
`File`	`pullFileFromExternal(String remoteFilePath)` เป็นวิธีที่สะดวกในการดึงไฟล์จากที่จัดเก็บข้อมูลภายนอกของอุปกรณ์ จัดเก็บไว้ใน`File`ชั่วคราวในเครื่อง และส่งคืนการอ้างอิงไปยัง`File`นั้น
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` ส่งเนื้อหาไดเรกทอรีไปยังอุปกรณ์แบบเรียกซ้ำ
`boolean`	`pushDir(File localFileDir, String deviceFilePath, Set<String> excludedDirectories)` ส่งเนื้อหาไดเรกทอรีไปยังอุปกรณ์แบบเรียกซ้ำพร้อมยกเว้นไดเรกทอรีบางรายการที่ กรองแล้ว
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` ส่งเนื้อหาในไดเรกทอรีไปยังอุปกรณ์แบบเรียกซ้ำ
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` รูปแบบของ `pushFile(File,String)` ซึ่งอาจพิจารณาประเมินความจำเป็น สำหรับผู้ให้บริการเนื้อหาได้
`boolean`	`pushFile(File localFile, String remoteFilePath)` พุชไฟล์ไปยังอุปกรณ์
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` พุชไฟล์ไปยังอุปกรณ์
`boolean`	`pushString(String contents, String remoteFilePath)` พุชไฟล์ที่สร้างจากสตริงไปยังอุปกรณ์
`void`	`reboot(String reason)` รีบูตอุปกรณ์เข้าสู่โหมด adb โดยมี `reason` ที่กำหนดเพื่อคงไว้หลังการรีบูต
`String`	`reboot(String command, String reason)` รีบูตอุปกรณ์โดยใช้ `command` ที่ระบุ
`void`	`reboot()` รีบูตอุปกรณ์เข้าสู่โหมด adb
`void`	`rebootIntoBootloader()` รีบูตอุปกรณ์เข้าสู่โหมด Bootloader
`void`	`rebootIntoFastbootd()` รีบูตอุปกรณ์เข้าสู่โหมด fastbootd
`void`	`rebootIntoRecovery()` รีบูตอุปกรณ์เข้าสู่โหมดการกู้คืน adb
`void`	`rebootIntoSideload()` รีบูตอุปกรณ์เข้าสู่โหมดการโหลดจากแหล่งที่ไม่รู้จักของ adb (โปรดทราบว่านี่คือโหมดพิเศษภายใต้การกู้คืน) บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดการโหลดแอปจากแหล่งที่ไม่รู้จัก
`void`	`rebootIntoSideload(boolean autoReboot)` รีบูตอุปกรณ์เข้าสู่โหมดการโหลดจากแหล่งที่ไม่รู้จักของ adb (โปรดทราบว่านี่คือโหมดพิเศษภายใต้การกู้คืน) บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดการโหลดแอปจากแหล่งที่ไม่รู้จัก
`void`	`rebootUntilOnline()` ทางเลือกแทน `reboot()` ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น กล่าวคือมองเห็นได้ใน adb
`void`	`rebootUntilOnline(String reason)` ทางเลือกแทน `reboot()` ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น กล่าวคือมองเห็นได้ใน adb
`void`	`rebootUserspace()` รีบูตเฉพาะส่วนพื้นที่ผู้ใช้ของอุปกรณ์
`void`	`rebootUserspaceUntilOnline()` ทางเลือกแทน `rebootUserspace()` ()} ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น ซึ่งจะมองเห็นได้ใน adb
`boolean`	`recoverDevice()` พยายามกู้คืนการสื่อสารของอุปกรณ์
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` ลงทะเบียน `IDeviceActionReceiver` สำหรับอุปกรณ์นี้
`void`	`remountSystemReadOnly()` ทำให้พาร์ติชันระบบในอุปกรณ์เป็นแบบอ่านอย่างเดียว
`void`	`remountSystemWritable()` ทำให้พาร์ติชันระบบในอุปกรณ์เขียนได้
`void`	`remountVendorReadOnly()` ตั้งค่าพาร์ติชันของผู้ให้บริการในอุปกรณ์เป็นแบบอ่านอย่างเดียว
`void`	`remountVendorWritable()` ทำให้พาร์ติชันของผู้ให้บริการในอุปกรณ์เขียนได้
`boolean`	`removeAdmin(String componentName, int userId)` นำผู้ดูแลระบบอุปกรณ์ที่ระบุในผู้ใช้ที่ระบุออกและแสดง `true` หากสำเร็จ หรือ `false` หากไม่สำเร็จ
`void`	`removeOwners()` นำเจ้าของโปรไฟล์อุปกรณ์ที่มีอยู่ทั้งหมดออกอย่างเต็มความสามารถ
`boolean`	`removeUser(int userId)` นำผู้ใช้ที่ระบุออกจากอุปกรณ์
`void`	`resetContentProviderSetup()` รีเซ็ตสถานะการตั้งค่าผู้ให้บริการเนื้อหาเพื่อเรียกใช้การตั้งค่าอีกครั้ง
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, Collection<ITestLifeCycleReceiver> listeners)` เรียกใช้การทดสอบการวัดคุมและให้การกู้คืนอุปกรณ์
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` วิธีที่สะดวกในการดำเนินการ `runInstrumentationTests(IRemoteAndroidTestRunner,Collection)` โดยมีผู้ฟังอย่างน้อย 1 คนส่งเป็นพารามิเตอร์
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, Collection<ITestLifeCycleReceiver> listeners)` เหมือนกับ `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection)` แต่ เรียกใช้การทดสอบสำหรับผู้ใช้ที่ระบุ
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` เหมือนกับ `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,ITestLifeCycleReceiver...)` แต่จะเรียกใช้การทดสอบสำหรับผู้ใช้ที่ระบุ
`void`	`setAdbPath(String adbPath)` ตั้งค่าเส้นทางไปยังไบนารี adb ที่ควรใช้
`void`	`setConfiguration(IConfiguration configuration)` แทรก `IConfiguration` ที่ใช้งานอยู่
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` ตั้งวันที่ในอุปกรณ์ หมายเหตุ: การตั้งค่าวันที่ในอุปกรณ์ต้องใช้สิทธิ์รูท
`boolean`	`setDeviceOwner(String componentName, int userId)` ตั้งค่าคอมโพเนนต์ผู้ดูแลระบบอุปกรณ์เป็นเจ้าของอุปกรณ์ในผู้ใช้ที่ระบุ
`void`	`setDeviceState(TestDeviceState deviceState)` อัปเดตสถานะของอุปกรณ์
`void`	`setEmulatorOutputStream(SizeLimitedOutputStream output)` สำหรับโปรแกรมจำลอง ให้ตั้งค่า `SizeLimitedOutputStream` เพื่อบันทึกเอาต์พุต
`void`	`setEmulatorProcess(Process p)` ตั้งค่า `Process` เมื่ออุปกรณ์นี้เป็นโปรแกรมจำลอง
`void`	`setFastbootEnabled(boolean fastbootEnabled)` ตั้งค่าตัวเลือก fastboot สำหรับอุปกรณ์
`void`	`setFastbootPath(String fastbootPath)` ตั้งค่าเส้นทางไปยังไบนารี fastboot ที่ควรใช้
`void`	`setIDevice(IDevice newDevice)` อัปเดต iDevice ที่เชื่อมโยงกับ ITestDevice นี้
`void`	`setLogStartDelay(int delay)` ตั้งค่าเวลาเป็นมิลลิวินาทีเพื่อรอ ก่อนเริ่มการจับภาพ Logcat สำหรับอุปกรณ์ที่ออนไลน์
`void`	`setOptions(TestDeviceOptions options)` ตั้งค่า `TestDeviceOptions` สำหรับอุปกรณ์
`boolean`	`setProperty(String propKey, String propValue)` ตั้งค่าพร็อพเพอร์ตี้ที่ระบุในอุปกรณ์
`void`	`setRecovery(IDeviceRecovery recovery)` ตั้งค่า `IDeviceRecovery` ที่จะใช้สำหรับอุปกรณ์นี้
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` ตั้งค่าโหมดการกู้คืนปัจจุบันที่จะใช้กับอุปกรณ์
`void`	`setSetting(String namespace, String key, String value)` ดู `setSetting(int,String,String,String)` และดำเนินการกับผู้ใช้ระบบ
`void`	`setSetting(int userId, String namespace, String key, String value)` เพิ่มค่าการตั้งค่าลงในเนมสเปซของผู้ใช้ที่ต้องการ
`void`	`setTestLogger(ITestLogger testLogger)` แทรกอินสแตนซ์ `ITestLogger`
`void`	`setTrackingSerial(String trackingSerial)` เพื่อวัตถุประสงค์ในการจัดการอุปกรณ์ ให้ติดตามหมายเลขซีเรียลที่เราใช้เพื่ออ้างอิงอุปกรณ์
`void`	`setUseFastbootErase(boolean useFastbootErase)` ตั้งค่าว่าจะใช้ fastboot erase หรือ fastboot format เพื่อล้างพาร์ติชันในอุปกรณ์หรือไม่
`void`	`startLogcat()` เริ่มบันทึกเอาต์พุต Logcat จากอุปกรณ์ในเบื้องหลัง
`boolean`	`startTradeInModeTesting(int timeoutMs)` เปิดใช้โหมดแลกซื้อเครื่องใหม่สำหรับการทดสอบ
`boolean`	`startUser(int userId)` เริ่มผู้ใช้ที่ระบุในเบื้องหลังหากหยุดอยู่
`boolean`	`startUser(int userId, boolean waitFlag)` เริ่มผู้ใช้ที่ระบุในเบื้องหลังหากหยุดอยู่
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` เริ่มผู้ใช้ที่ระบุในเบื้องหลัง ซึ่งจะมองเห็นได้ในจอแสดงผลที่ระบุ (เช่น อนุญาตให้ผู้ใช้ เปิดใช้กิจกรรมในจอแสดงผลนั้น)
`void`	`stopEmulatorOutput()` ปิดและลบเอาต์พุตของโปรแกรมจำลอง
`void`	`stopLogcat()` หยุดบันทึกเอาต์พุต Logcat จากอุปกรณ์และทิ้งข้อมูล Logcat ที่บันทึกไว้ในปัจจุบัน
`void`	`stopTradeInModeTesting()` หยุดการทดสอบโหมดแลกซื้อเครื่องใหม่
`boolean`	`stopUser(int userId)` หยุดผู้ใช้ที่ระบุ
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` หยุดผู้ใช้ที่ระบุ
`String`	`switchToAdbTcp()` เปลี่ยนอุปกรณ์เป็นโหมด adb-over-tcp
`boolean`	`switchToAdbUsb()` เปลี่ยนอุปกรณ์เป็นโหมด adb ผ่าน USB
`boolean`	`switchUser(int userId)` เปลี่ยนไปใช้ userId อื่นที่มีการหมดเวลาเริ่มต้น
`boolean`	`switchUser(int userId, long timeout)` เปลี่ยนไปใช้ userId อื่นโดยมีระยะหมดเวลาที่ระบุเป็นกำหนดเวลา
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` ซิงค์เนื้อหาของไดเรกทอรีไฟล์ในเครื่องกับอุปกรณ์ทีละรายการ
`Bugreport`	`takeBugreport()` ใช้รายงานข้อบกพร่องและส่งคืนภายในออบเจ็กต์ `Bugreport` เพื่อจัดการ
`String`	`uninstallPackage(String packageName)` ถอนการติดตั้งแพ็กเกจ Android จากอุปกรณ์
`String`	`uninstallPackageForUser(String packageName, int userId)` ถอนการติดตั้งแพ็กเกจ Android จากอุปกรณ์สำหรับผู้ใช้ที่ระบุ
`boolean`	`unlockDevice()` ปลดล็อกอุปกรณ์หากอุปกรณ์อยู่ในสถานะที่เข้ารหัส
`void`	`unmountDebugfs()` ยกเลิกการเชื่อมต่อ debugfs
`boolean`	`waitForBootComplete(long timeOut)` บล็อกจนกว่าจะมีการตั้งค่าสถานะการบูตอุปกรณ์เสร็จสมบูรณ์
`boolean`	`waitForDeviceAvailable()` รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ
`boolean`	`waitForDeviceAvailable(long waitTime)` รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` รอให้อุปกรณ์ตอบสนองและพร้อมใช้งานโดยไม่พิจารณาเส้นทางการกู้คืน
`void`	`waitForDeviceBootloader()` บล็อกจนกว่าอุปกรณ์จะมองเห็นผ่าน fastboot
`void`	`waitForDeviceFastbootD()`
`boolean`	`waitForDeviceInRecovery(long waitTime)` บล็อกไม่ให้อุปกรณ์อยู่ในสถานะ "การกู้คืน adb" (โปรดทราบว่าสถานะนี้แตกต่างจาก `IDeviceRecovery`)
`boolean`	`waitForDeviceInSideload(long waitTime)` บล็อกไม่ให้อุปกรณ์อยู่ในสถานะ "adb sideload"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` บล็อกไม่ให้อุปกรณ์พร้อมใช้งาน เช่น หายไปจาก adb
`void`	`waitForDeviceOnline()` บล็อกจนกว่าอุปกรณ์จะมองเห็นได้ผ่าน adb
`void`	`waitForDeviceOnline(long waitTime)` บล็อกจนกว่าอุปกรณ์จะมองเห็นได้ผ่าน adb
`boolean`	`waitForDeviceShell(long waitTime)` รอให้อุปกรณ์ตอบสนองต่อคำสั่งเชลล์ adb พื้นฐาน

วิธีการที่ได้รับการป้องกัน
`void`	`addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand(String command, boolean forceExitStatusDetection, boolean oldShellCommand)` สร้างคำสั่ง OS สำหรับเซสชันคำสั่ง adb shell และอาร์กิวเมนต์ที่ระบุ
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` สร้าง `RebootDeviceAction` เพื่อใช้เมื่อดำเนินการรีบูต
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` ทำการรีบูต adb
`void`	`ensureRuntimePermissionSupported()` วิธีการช่วยในการส่งข้อยกเว้นหากไม่รองรับสิทธิ์รันไทม์
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` รับอินสแตนซ์ `RunUtil` เพื่อใช้งาน
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` ดึงข้อมูลพร็อพเพอร์ตี้ของอุปกรณ์จากแคช ddmlib โดยค่าเริ่มต้น และกลับไปใช้ `adb shell getprop` หรือ `fastboot getvar` ขึ้นอยู่กับว่าอุปกรณ์อยู่ใน Fastboot หรือไม่
`boolean`	`isInRebootCallback()` แสดงผลว่าขณะนี้มีการเรียกกลับการรีบูตหรือไม่
`boolean`	`isNewer(File localFile, IFileEntry entry)` ส่งคืน `true` หากไฟล์ในเครื่องใหม่กว่าไฟล์ระยะไกล
`void`	`notifyRebootEnded()` แจ้งเตือน `IDeviceActionReceiver` ทั้งหมดเกี่ยวกับเหตุการณ์สิ้นสุดการรีบูต
`void`	`notifyRebootStarted()` แจ้งเตือน `IDeviceActionReceiver` ทั้งหมดเกี่ยวกับเหตุการณ์การเริ่มต้นรีบูต
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` ดำเนินการในอุปกรณ์นี้
`void`	`postAdbReboot(NativeDevice.RebootMode rebootMode)` การดำเนินการเพิ่มเติมที่อาจทำได้หลังจากการรีบูต
`void`	`prePostBootSetup()` อนุญาตให้ประเภทอุปกรณ์แต่ละประเภท (AndroidNativeDevice, TestDevice) ลบล้างวิธีการนี้สำหรับ การตั้งค่าเฉพาะหลังการบูต
`boolean`	`pullFileWithAdbCommand(String remoteFilePath, File localFile, long timeout)`
`void`	`setClock(Clock clock)` ตั้งค่าอินสแตนซ์ Clock ที่จะใช้
`void`	`setMicrodroidProcess(Process process)` ทำเครื่องหมาย TestDevice เป็น microdroid และตั้งค่า CID
`void`	`setTestDeviceOptions(Map<String, String> deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` เรียกใช้คำสั่ง Fastboot อย่างง่ายและรายงานสถานะของคำสั่ง
`CommandResult`	`simpleFastbootCommand(long timeout, Map<String, String> envVarMap, String[] fullCmd)` เรียกใช้คำสั่ง Fastboot อย่างง่ายด้วยตัวแปรสภาพแวดล้อมและรายงานสถานะของคำสั่ง
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` รอจนกว่าอุปกรณ์จะใช้งานไม่ได้ (หยุดรายงานไปยัง adb)

ค่าคงที่

DEBUGFS_PATH

public static final String DEBUGFS_PATH

ค่าคงที่: "/sys/kernel/debug"

INVALID_USER_ID

public static final int INVALID_USER_ID

ค่าที่แสดงสำหรับรหัสผู้ใช้ที่ไม่ถูกต้อง/ไม่พบ: UserHandle กำหนดค่า -10000

ค่าคงที่ -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

ค่าคงที่: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

จำนวนครั้งเริ่มต้นที่พยายามลองส่งคำสั่งอีกครั้ง

ค่าคงที่ 2 (0x00000002)

SD_CARD

protected static final String SD_CARD

ค่าคงที่: "/sdcard/"

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

ค่าคงที่ "/storage/emulated/"

ทุ่ง

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

เครื่องมือสร้างสาธารณะ

NativeDevice

public NativeDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

สร้าง TestDevice

พารามิเตอร์
`device`	`IDevice`: `IDevice` ที่เชื่อมโยง
`stateMonitor`	`IDeviceStateMonitor`: กลไก `IDeviceStateMonitor` ที่จะใช้
`allocationMonitor`	`IDeviceMonitor`: `IDeviceMonitor` เพื่อแจ้งการเปลี่ยนแปลงสถานะการจัดสรร อาจเป็นค่าว่าง

เมธอดสาธารณะ

adbInstallPackage

public String adbInstallPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

ติดตั้งแพ็กเกจ Android ในอุปกรณ์ด้วยคำสั่ง adb

พารามิเตอร์
`packageFile`	`File`: ไฟล์ APK ที่จะติดตั้ง
`reinstall`	`boolean`: `true` หากควรติดตั้งอีกครั้ง
`extraArgs`	`String`: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm -h"

การคืนสินค้า
`String`	`String` พร้อมรหัสข้อผิดพลาด หรือ `null` หากสำเร็จ

ส่ง
`DeviceNotAvailableException`

adbInstallPackage

public String adbInstallPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

ติดตั้งแพ็กเกจ Android ในอุปกรณ์ด้วยคำสั่ง adb

หมายเหตุ: เฉพาะกรณีการใช้งานที่ต้องมีการควบคุมอย่างชัดเจนในการให้สิทธิ์รันไทม์ในเวลาติดตั้งเท่านั้นที่ควรเรียกใช้ฟังก์ชันนี้

พารามิเตอร์
`packageFile`	`File`: ไฟล์ APK ที่จะติดตั้ง
`reinstall`	`boolean`: `true` หากควรติดตั้งอีกครั้ง
`grantPermissions`	`boolean`: หากควรมอบสิทธิ์รันไทม์ทั้งหมด ณ เวลาที่ติดตั้ง
`extraArgs`	`String`: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm -h"

การคืนสินค้า
`String`	`String` พร้อมรหัสข้อผิดพลาด หรือ `null` หากสำเร็จ

ส่ง
`DeviceNotAvailableException`

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

การเพิ่มประสิทธิภาพเล็กๆ น้อยๆ (ประมาณ 400 มิลลิวินาที) โดยการดึงข้อมูลพร็อพทั้งหมดที่เราต้องการล่วงหน้าแทนที่จะเรียกใช้ "adb getprop" สำหรับแต่ละรายการ กล่าวคือ การดึงข้อมูลพร็อพทั้งหมดจะเร็วเท่ากับการดึงข้อมูลพร็อพรายการเดียว เช่น device.getApiLevel(), checkApiLevelAgainstNextRelease และ getBuildAlias ทั้งหมดจะเรียกใช้ `adb getprop` ที่เบื้องหลัง เราจะดึงข้อมูลในการเรียกใช้ครั้งเดียวและเรียกใช้ NativeDevice.setProperty แม้ว่าเราจะไม่ทำเช่นนี้ NativeDevice จะเรียกใช้ setProperty ด้วยตัวเองและแคชผลลัพธ์สำหรับการเรียกในอนาคต เพียงแต่เราจะดำเนินการเร็วกว่าปกติเล็กน้อย หากอุปกรณ์อยู่ในโหมดการกู้คืนหรือมีข้อผิดพลาดอื่นๆ ในการดึงข้อมูลพร็อพเพอร์ตี้ เราจะละเว้นพร็อพเพอร์ตี้เหล่านั้น

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

แสดงว่าอนุญาตให้เปลี่ยนไปใช้ผู้ใช้ SYSTEM แบบไม่มีส่วนหัวหรือไม่

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

ตรวจสอบว่าระบบรองรับฟีเจอร์ในปัจจุบันหรือไม่ โดยพิจารณาจากระดับที่รองรับขั้นต่ำ วิธีนี้ จะพิจารณาฟีเจอร์ที่ยังไม่ได้เผยแพร่ก่อนที่จะเพิ่มระดับ API

พารามิเตอร์
`strictMinLevel`	`int`: ระดับต่ำสุดที่เป็นไปได้ที่รองรับฟีเจอร์นี้

การคืนสินค้า
`boolean`	จริงหากระบบรองรับระดับ มิเช่นนั้นจะเป็น "เท็จ"

ส่ง
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

ตรวจสอบว่าอุปกรณ์มีการเชื่อมต่อเครือข่าย

การคืนสินค้า
`boolean`	`true` หากอุปกรณ์เชื่อมต่อกับเครือข่ายที่กำลังทำงานอยู่ `false` มิเช่นนั้น

ส่ง
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

พยายามปิดกล่องโต้ตอบข้อผิดพลาดที่แสดงอยู่ใน UI ของอุปกรณ์

การคืนสินค้า
`boolean`	`true` หากไม่มีกล่องโต้ตอบหรือล้างกล่องโต้ตอบเรียบร้อยแล้ว `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

ล้างเครือข่าย Wi-Fi ที่เชื่อมต่อล่าสุด ควรเรียกใช้ฟังก์ชันนี้เมื่อเริ่มการเรียกใช้ใหม่ เพื่อหลีกเลี่ยงการเชื่อมต่อกับเครือข่าย Wi-Fi ที่ใช้ในการทดสอบก่อนหน้าหลังจากรีบูตอุปกรณ์

clearLogcat

public void clearLogcat ()

ลบข้อมูล Logcat ที่สะสมไว้

ซึ่งจะมีประโยชน์ในกรณีที่คุณต้องการให้ ITestDevice.getLogcat() แสดงเฉพาะ ข้อมูลบันทึกที่สร้างขึ้นหลังจากจุดหนึ่ง (เช่น หลังจากแฟลชบิลด์อุปกรณ์ใหม่ เป็นต้น)

connectToWifiNetworkIfNeededWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

รูปแบบของ connectToWifiNetwork(String,String) ที่จะเชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ ไม่มีการเชื่อมต่อเครือข่ายในขณะนั้น

พารามิเตอร์
`scanSsid`	`boolean`: ระบุว่าจะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่

การคืนสินค้า
`IWifiHelper.WifiConnectionResult`	`WifiConnectionResult` ซึ่งระบุสถานะของการเชื่อมต่อ

ส่ง
`DeviceNotAvailableException`

connectToWifiNetworkIfNeededWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk)

รูปแบบของ connectToWifiNetwork(String,String) ที่จะเชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ ไม่มีการเชื่อมต่อเครือข่ายในขณะนี้

การคืนสินค้า
`IWifiHelper.WifiConnectionResult`	`WifiConnectionResult` ซึ่งระบุสถานะของการเชื่อมต่อ

ส่ง
`DeviceNotAvailableException`

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

เชื่อมต่อกับเครือข่าย Wi-Fi

เปิด Wi-Fi และบล็อกจนกว่าจะเชื่อมต่อกับเครือข่าย Wi-Fi ที่ระบุสำเร็จ เมื่อสร้างการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากการรีบูตทุกครั้งจนกว่าจะมีการเรียกใช้ ITestDevice.disconnectFromWifi() หรือ ITestDevice.clearLastConnectedWifiNetwork()

พารามิเตอร์
`wifiSsid`	`String`: SSID ของ Wi-Fi ที่จะเชื่อมต่อ
`wifiPsk`	`String`: วลีรหัส PSK หรือ null หากไม่ได้เข้ารหัส
`scanSsid`	`boolean`: ระบุว่าจะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่

การคืนสินค้า
`IWifiHelper.WifiConnectionResult`	`WifiConnectionResult` ซึ่งระบุสถานะของการเชื่อมต่อ

ส่ง
`DeviceNotAvailableException`

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk)

เชื่อมต่อกับเครือข่าย Wi-Fi

เปิด Wi-Fi และบล็อกจนกว่าจะเชื่อมต่อกับเครือข่าย Wi-Fi อย่างใดอย่างหนึ่งที่ระบุไว้ในแผนที่ wifiSsidToPsk ได้สำเร็จ เมื่อสร้างการเชื่อมต่อแล้ว อินสแตนซ์จะพยายาม กู้คืนการเชื่อมต่อหลังจากการรีบูตทุกครั้งจนกว่าจะมีการเรียกใช้ ITestDevice.disconnectFromWifi() หรือ ITestDevice.clearLastConnectedWifiNetwork()

พารามิเตอร์
`wifiSsidToPsk`	`Map`: แผนที่ของ SSID ของ Wi-Fi ไปยังรหัสผ่าน

การคืนสินค้า
`IWifiHelper.WifiConnectionResult`	`WifiConnectionResult` ซึ่งระบุสถานะของการเชื่อมต่อ

ส่ง
`DeviceNotAvailableException`

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

เชื่อมต่อกับเครือข่าย Wi-Fi

พารามิเตอร์
`wifiSsidToPsk`	`Map`: แผนที่ของ SSID ของ Wi-Fi ไปยังรหัสผ่าน
`scanSsid`	`boolean`: จะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่

การคืนสินค้า
`IWifiHelper.WifiConnectionResult`	`WifiConnectionResult` ซึ่งระบุสถานะของการเชื่อมต่อ

ส่ง
`DeviceNotAvailableException`

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk)

เชื่อมต่อกับเครือข่าย Wi-Fi

พารามิเตอร์
`wifiSsid`	`String`: SSID ของ Wi-Fi ที่จะเชื่อมต่อ
`wifiPsk`	`String`: วลีรหัส PSK หรือ null หากไม่ได้เข้ารหัส

การคืนสินค้า
`IWifiHelper.WifiConnectionResult`	`WifiConnectionResult` ซึ่งระบุสถานะของการเชื่อมต่อ

ส่ง
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

สร้างผู้ใช้ที่มีชื่อที่ระบุและ Flag ที่ระบุ

พารามิเตอร์
`name`	`String`: ของผู้ใช้เพื่อสร้างในอุปกรณ์
`guest`	`boolean`: เปิดใช้ค่าสถานะผู้ใช้ --guest ในระหว่างการสร้าง
`ephemeral`	`boolean`: เปิดใช้แฟล็กผู้ใช้ --ephemeral ระหว่างการสร้าง

การคืนสินค้า
`int`	รหัสของผู้ใช้ที่สร้างขึ้น

ส่ง
`DeviceNotAvailableException`
`IllegalStateException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

สร้างผู้ใช้ที่มีชื่อที่ระบุและ Flag ที่ระบุ

พารามิเตอร์
`name`	`String`: ของผู้ใช้เพื่อสร้างในอุปกรณ์
`guest`	`boolean`: เปิดใช้ค่าสถานะผู้ใช้ --guest ในระหว่างการสร้าง
`ephemeral`	`boolean`: เปิดใช้แฟล็กผู้ใช้ --ephemeral ระหว่างการสร้าง
`forTesting`	`boolean`: เปิดใช้ Flag การทดสอบ --for-testing ระหว่างการสร้าง

การคืนสินค้า
`int`	รหัสของผู้ใช้ที่สร้างขึ้น

ส่ง
`DeviceNotAvailableException`
`IllegalStateException`

createUser

public int createUser (String name)

สร้างผู้ใช้ที่มีชื่อที่ระบุและค่าสถานะเริ่มต้นเป็น 0

พารามิเตอร์
`name`	`String`: ของผู้ใช้เพื่อสร้างในอุปกรณ์

การคืนสินค้า
`int`	จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้น

ส่ง
`DeviceNotAvailableException`
`IllegalStateException`

createUserNoThrow

public int createUserNoThrow (String name)

สร้างผู้ใช้ที่มีชื่อที่ระบุและค่าสถานะเริ่มต้นเป็น 0

พารามิเตอร์
`name`	`String`: ของผู้ใช้เพื่อสร้างในอุปกรณ์

การคืนสินค้า
`int`	จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้น หรือ -1 สำหรับข้อผิดพลาด

ส่ง
`DeviceNotAvailableException`

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

ตรวจสอบอุปกรณ์และแสดงข้อมูลโดยละเอียดเมื่ออุปกรณ์ไม่พร้อมใช้งาน

การคืนสินค้า
`DeviceInspectionResult`

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

เมธอดช่วยในการลบไฟล์หรือไดเรกทอรีในอุปกรณ์

พารามิเตอร์
`deviceFilePath`	`String`: เส้นทางแบบเต็มของไฟล์ในอุปกรณ์
`userId`	`int`: รหัสผู้ใช้ที่จะลบ

ส่ง
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath)

เมธอดช่วยในการลบไฟล์หรือไดเรกทอรีในอุปกรณ์

พารามิเตอร์
`deviceFilePath`	`String`: เส้นทางแบบเต็มของไฟล์ในอุปกรณ์

ส่ง
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

นำ IDeviceActionReceiver ที่ลงทะเบียนออก

พารามิเตอร์
`deviceActionReceiver`	`IDeviceActionReceiver`: `IDeviceActionReceiver` ซึ่งจะถูกนำออก

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

เมธอดช่วยในการตรวจสอบว่าอุปกรณ์รีสตาร์ทแบบซอฟต์หรือไม่โดยการเปรียบเทียบ system_server ปัจจุบันกับ system_server ก่อนหน้า ProcessInfo ใช้ getProcessByName(String) เพื่อรับ ProcessInfo

พารามิเตอร์
`prevSystemServerProcess`	`ProcessInfo`: กระบวนการ system_server ก่อนหน้า `ProcessInfo`

การคืนสินค้า
`boolean`	`true` หากอุปกรณ์รีสตาร์ทแบบซอฟต์รีเซ็ต

ส่ง
`DeviceNotAvailableException`

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

เมธอดตัวช่วยในการตรวจสอบว่าอุปกรณ์รีสตาร์ทแบบซอฟต์หรือไม่นับตั้งแต่เวลา UTC ตั้งแต่ Epoch จาก อุปกรณ์และ TimeUnit การรีสตาร์ทแบบไม่บังคับหมายถึงการรีสตาร์ท system_server นอกการรีบูตแบบบังคับของอุปกรณ์ (เช่น รีบูตตามคำขอ) คุณรับ utcEpochTime ปัจจุบันของอุปกรณ์ในหน่วยมิลลิวินาทีได้โดยใช้เมธอด getDeviceDate()

พารามิเตอร์
`utcEpochTime`	`long`: เวลาของอุปกรณ์เป็นวินาทีนับตั้งแต่ Epoch
`timeUnit`	`TimeUnit`: หน่วยเวลา `TimeUnit` สำหรับ utcEpochTime ที่ระบุ

การคืนสินค้า
`boolean`	`true` หากอุปกรณ์รีสตาร์ทแบบซอฟต์รีเซ็ต

ส่ง
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

ปิดรูท adb

การปิดใช้รูท adb อาจทำให้อุปกรณ์ยกเลิกการเชื่อมต่อจาก adb วิธีนี้จะบล็อกจนกว่าอุปกรณ์ จะพร้อมใช้งาน

การคืนสินค้า
`boolean`	`true` หากสำเร็จ

ส่ง
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

พยายามปิดใช้ Keyguard

ก่อนอื่นให้รอจนกว่าการส่งอินพุตจะพร้อม ซึ่งจะเกิดขึ้นในเวลาใกล้เคียงกับที่อุปกรณ์รายงาน BOOT_COMPLETE โดยจะเกิดขึ้นแบบไม่พร้อมกัน เนื่องจากปัจจุบันการใช้งานเฟรมเวิร์กมีเงื่อนไขการแข่งขันเป็นครั้งคราว จากนั้นระบบจะส่งคำสั่งเพื่อปิด Keyguard (ใช้ได้กับอุปกรณ์ที่ไม่ปลอดภัยเท่านั้น)

ส่ง
`DeviceNotAvailableException`

disableNetworkMonitor

public boolean disableNetworkMonitor ()

ปิดใช้การตรวจสอบเครือข่ายในอุปกรณ์

การคืนสินค้า
`boolean`	`true` หากปิดใช้การตรวจสอบสำเร็จ `false` หากไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

disconnectFromWifi

public boolean disconnectFromWifi ()

ยกเลิกการเชื่อมต่อจากเครือข่าย Wi-Fi

นำเครือข่ายทั้งหมดออกจากรายการเครือข่ายที่รู้จักและปิดใช้ Wi-Fi

การคืนสินค้า
`boolean`	`true` หากยกเลิกการเชื่อมต่อจากเครือข่าย Wi-Fi สำเร็จ `false` หากยกเลิกการเชื่อมต่อไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

เมธอดตัวช่วยเพื่อตรวจสอบว่ามีไฟล์ในอุปกรณ์สำหรับผู้ใช้ที่ระบุหรือไม่

พารามิเตอร์
`deviceFilePath`	`String`: เส้นทางแบบเต็มของไฟล์ในอุปกรณ์ที่จะตรวจสอบ
`userId`	`int`: รหัสผู้ใช้ที่จะใช้ตรวจสอบว่ามีไฟล์อยู่หรือไม่

การคืนสินค้า
`boolean`	`true` หากมีไฟล์อยู่ `false` มิฉะนั้น

ส่ง
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

เมธอด Helper เพื่อตรวจสอบว่ามีไฟล์ในอุปกรณ์หรือไม่

พารามิเตอร์
`deviceFilePath`	`String`: เส้นทางแบบเต็มของไฟล์ในอุปกรณ์ที่จะตรวจสอบ

การคืนสินค้า
`boolean`	`true` หากมีไฟล์อยู่ `false` มิฉะนั้น

ส่ง
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

พยายามดัมพ์ฮีปจาก system_server ผู้โทรมีหน้าที่รับผิดชอบในการล้างข้อมูล ไฟล์ที่ทิ้ง

พารามิเตอร์
`process`	`String`: ชื่อของกระบวนการอุปกรณ์ที่จะเรียกใช้ dumpheap
`devicePath`	`String`: เส้นทางในอุปกรณ์ที่จะวางไฟล์ดัมพ์ ต้องเป็นตำแหน่งที่ สิทธิ์อนุญาต

การคืนสินค้า
`File`	`File`ที่มีรายงาน เป็น Null หากเกิดข้อผิดพลาด

ส่ง
`DeviceNotAvailableException`

enableAdbRoot

public boolean enableAdbRoot ()

เปิดรูท adb หากการตั้งค่า "enable-root" เป็น "false" ระบบจะบันทึกข้อความและส่งคืนโดยไม่เปิดใช้รูท

การเปิดใช้รูท adb อาจทำให้อุปกรณ์ยกเลิกการเชื่อมต่อจาก adb วิธีนี้จะบล็อกจนกว่าอุปกรณ์ จะพร้อมใช้งาน

การคืนสินค้า
`boolean`	`true` หากสำเร็จ

ส่ง
`DeviceNotAvailableException`

enableNetworkMonitor

public boolean enableNetworkMonitor ()

เปิดใช้การตรวจสอบเครือข่ายในอุปกรณ์

การคืนสินค้า
`boolean`	`true` หากเปิดใช้การตรวจสอบสำเร็จ `false` หากไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา

executeShellCommand(String) ควรใช้แทนเมื่อเป็นไปได้ เนื่องจากวิธีดังกล่าวจะช่วยให้ตรวจหาข้อผิดพลาดและประสิทธิภาพได้ดีกว่า

พารามิเตอร์
`timeout`	`long`: เวลาเป็นมิลลิวินาทีก่อนที่ระบบจะถือว่าอุปกรณ์ไม่ตอบสนอง 0L สำหรับ ไม่มีการหมดเวลา
`cmdArgs`	`String`: คำสั่งและอาร์กิวเมนต์ adb ที่จะเรียกใช้

การคืนสินค้า
`String`	stdout จากคำสั่ง `null` หากคำสั่งดำเนินการไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบ

พารามิเตอร์
`cmdArgs`	`String`: คำสั่งและอาร์กิวเมนต์ adb ที่จะเรียกใช้

การคืนสินค้า
`String`	stdout จากคำสั่ง `null` หากคำสั่งดำเนินการไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                Map<String, String> envMap, 
                String... cmdArgs)

เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา

พารามิเตอร์
`timeout`	`long`: เวลาเป็นมิลลิวินาทีก่อนที่ระบบจะถือว่าอุปกรณ์ไม่ตอบสนอง 0L สำหรับ ไม่มีการหมดเวลา
`envMap`	`Map`: สภาพแวดล้อมที่จะตั้งค่าสำหรับคำสั่ง
`cmdArgs`	`String`: คำสั่งและอาร์กิวเมนต์ adb ที่จะเรียกใช้

การคืนสินค้า
`String`	stdout จากคำสั่ง `null` หากคำสั่งดำเนินการไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบ

พารามิเตอร์
`cmdArgs`	`String`: คำสั่งและอาร์กิวเมนต์ adb ที่จะเรียกใช้

การคืนสินค้า
`CommandResult`	CommandResult ที่มีเอาต์พุตของคำสั่ง

ส่ง
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                String... cmdArgs)

เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา

พารามิเตอร์
`timeout`	`long`: เวลาเป็นมิลลิวินาทีก่อนที่ระบบจะถือว่าอุปกรณ์ไม่ตอบสนอง 0L สำหรับ ไม่มีการหมดเวลา
`cmdArgs`	`String`: คำสั่งและอาร์กิวเมนต์ adb ที่จะเรียกใช้

การคืนสินค้า
`CommandResult`	CommandResult ที่มีเอาต์พุตของคำสั่ง

ส่ง
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                String... cmdArgs)

เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา

พารามิเตอร์
`timeout`	`long`: เวลาเป็นมิลลิวินาทีก่อนที่ระบบจะถือว่าอุปกรณ์ไม่ตอบสนอง 0L สำหรับ ไม่มีการหมดเวลา
`envMap`	`Map`: สภาพแวดล้อมที่จะตั้งค่าสำหรับคำสั่ง
`cmdArgs`	`String`: คำสั่งและอาร์กิวเมนต์ adb ที่จะเรียกใช้

การคืนสินค้า
`CommandResult`	CommandResult ที่มีเอาต์พุตของคำสั่ง

ส่ง
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                int retryAttempts, 
                String... cmdArgs)

เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา

พารามิเตอร์
`timeout`	`long`: เวลาเป็นมิลลิวินาทีก่อนที่ระบบจะถือว่าอุปกรณ์ไม่ตอบสนอง 0L สำหรับ ไม่มีการหมดเวลา
`envMap`	`Map`: สภาพแวดล้อมที่จะตั้งค่าสำหรับคำสั่ง
`retryAttempts`	`int`: จำนวนครั้งสูงสุดในการลองส่งคำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะแสดง DeviceNotResponsiveException หากดำเนินการ `retryAttempts` ไม่สำเร็จ
`cmdArgs`	`String`: คำสั่งและอาร์กิวเมนต์ adb ที่จะเรียกใช้

การคืนสินค้า
`CommandResult`	CommandResult ที่มีเอาต์พุตของคำสั่ง

ส่ง
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

เมธอดช่วยที่เรียกใช้คำสั่ง fastboot เป็นคำสั่งของระบบโดยมีระยะหมดเวลาเริ่มต้น 2 นาที

คาดว่าจะใช้เมื่ออุปกรณ์อยู่ในโหมด Fastboot อยู่แล้ว

พารามิเตอร์
`cmdArgs`	`String`: คำสั่งและอาร์กิวเมนต์ fastboot ที่จะเรียกใช้

การคืนสินค้า
`CommandResult`	CommandResult ที่มีเอาต์พุตของคำสั่ง

ส่ง
`DeviceNotAvailableException`
`UnsupportedOperationException`

executeFastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

เมธอดตัวช่วยที่เรียกใช้คำสั่ง fastboot เป็นคำสั่งของระบบ

คาดว่าจะใช้เมื่ออุปกรณ์อยู่ในโหมด Fastboot อยู่แล้ว

พารามิเตอร์
`timeout`	`long`: เวลาเป็นมิลลิวินาทีก่อนที่คำสั่งจะหมดอายุ
`cmdArgs`	`String`: คำสั่งและอาร์กิวเมนต์ fastboot ที่จะเรียกใช้

การคืนสินค้า
`CommandResult`	CommandResult ที่มีเอาต์พุตของคำสั่ง

ส่ง
`DeviceNotAvailableException`
`UnsupportedOperationException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

เมธอดช่วยที่เรียกใช้คำสั่ง fastboot ที่ทำงานเป็นเวลานานในฐานะคำสั่งของระบบ

เหมือนกับ executeFastbootCommand(String...) แต่ใช้การหมดเวลาที่นานกว่า

พารามิเตอร์
`cmdArgs`	`String`: คำสั่งและอาร์กิวเมนต์ fastboot ที่จะเรียกใช้

การคืนสินค้า
`CommandResult`	CommandResult ที่มีเอาต์พุตของคำสั่ง

ส่ง
`DeviceNotAvailableException`
`UnsupportedOperationException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (Map<String, String> envVarMap, 
                String... cmdArgs)

เมธอด Helper ซึ่งเรียกใช้คำสั่ง fastboot ที่ทำงานเป็นเวลานานในฐานะคำสั่งของระบบที่มีตัวแปรสภาพแวดล้อมของระบบ

เหมือนกับ executeFastbootCommand(String...) แต่ใช้การหมดเวลาที่นานกว่า

พารามิเตอร์
`envVarMap`	`Map`: ตัวแปรสภาพแวดล้อมของระบบที่คำสั่ง fastboot ทำงานด้วย
`cmdArgs`	`String`: คำสั่งและอาร์กิวเมนต์ fastboot ที่จะเรียกใช้

การคืนสินค้า
`CommandResult`	CommandResult ที่มีเอาต์พุตของคำสั่ง

ส่ง
`DeviceNotAvailableException`
`UnsupportedOperationException`

executeShellCommand

public String executeShellCommand (String command)

เมธอดช่วยที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น String

พารามิเตอร์
`command`	`String`: คำสั่ง adb shell ที่จะเรียกใช้

การคืนสินค้า
`String`	เอาต์พุตของเชลล์

ส่ง
`DeviceNotAvailableException`

executeShellCommand

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

เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง

พารามิเตอร์
`command`	`String`: คำสั่ง adb shell ที่จะเรียกใช้
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` ที่จะส่งเอาต์พุตของ Shell โดยตรง
`maxTimeToOutputShellResponse`	`long`: ระยะเวลาสูงสุดที่อนุญาตให้คำสั่งไม่ต้องแสดงผลการตอบกลับใดๆ หน่วยตามที่ระบุใน `timeUnit`
`timeUnit`	`TimeUnit`: หน่วยสำหรับ `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: จำนวนครั้งสูงสุดในการลองส่งคำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะแสดง DeviceNotResponsiveException หากดำเนินการ `retryAttempts` ไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

executeShellCommand

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

พารามิเตอร์
`command`	`String`: คำสั่ง adb shell ที่จะเรียกใช้
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` ที่จะส่งเอาต์พุตของ Shell โดยตรง
`maxTimeoutForCommand`	`long`: การหมดเวลาสูงสุดสำหรับคำสั่งให้เสร็จสมบูรณ์ หน่วยเป็น ที่ระบุใน `timeUnit`
`maxTimeToOutputShellResponse`	`long`: ระยะเวลาสูงสุดที่อนุญาตให้คำสั่งไม่ต้องแสดงการตอบกลับใดๆ หน่วยตามที่ระบุใน `timeUnit`
`timeUnit`	`TimeUnit`: หน่วยสำหรับ `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: จำนวนครั้งสูงสุดในการลองส่งคำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะแสดง DeviceNotResponsiveException หากดำเนินการ `retryAttempts` ไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

เรียกใช้คำสั่ง adb shell ที่ระบุ โดยจะลองอีกหลายครั้งหากคำสั่งล้มเหลว

รูปแบบที่เรียบง่ายกว่าของ executeShellCommand(String,IShellOutputReceiver,long,TimeUnit,int) ที่มี ค่าเริ่มต้น

พารามิเตอร์
`command`	`String`: คำสั่ง adb shell ที่จะเรียกใช้
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` ที่จะส่งเอาต์พุตของ Shell โดยตรง

ส่ง
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

เมธอด Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult ที่มีเอาต์พุตสถานะคำสั่ง, stdout และ stderr อย่างถูกต้อง

พารามิเตอร์
`cmd`	`String`: คำสั่งที่ควรเรียกใช้

การคืนสินค้า
`CommandResult`	ผลการค้นหาในภาษา`CommandResult`

ส่ง
`DeviceNotAvailableException`

executeShellV2Command

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

พารามิเตอร์
`cmd`	`String`: คำสั่ง adb shell ที่จะเรียกใช้
`pipeAsInput`	`File`: `File` ที่จะส่งเป็นอินพุตไปยังคำสั่ง หรือ null
`pipeToOutput`	`OutputStream`: `OutputStream` ที่จะเปลี่ยนเส้นทางเอาต์พุตมาตรฐาน หรือ null
`maxTimeoutForCommand`	`long`: การหมดเวลาสูงสุดสำหรับคำสั่งให้เสร็จสมบูรณ์ หน่วยเป็น ที่ระบุใน `timeUnit`
`timeUnit`	`TimeUnit`: หน่วยสำหรับ `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: จำนวนครั้งสูงสุดในการลองส่งคำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะแสดง DeviceNotResponsiveException หากดำเนินการ `retryAttempts` ไม่สำเร็จ

การคืนสินค้า
`CommandResult`

ส่ง
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

พารามิเตอร์
`cmd`	`String`: คำสั่ง adb shell ที่จะเรียกใช้
`maxTimeoutForCommand`	`long`: การหมดเวลาสูงสุดสำหรับคำสั่งให้เสร็จสมบูรณ์ หน่วยเป็น ที่ระบุใน `timeUnit`
`timeUnit`	`TimeUnit`: หน่วยสำหรับ `maxTimeToOutputShellResponse`

การคืนสินค้า
`CommandResult`

ส่ง
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

พารามิเตอร์
`cmd`	`String`: คำสั่งที่ควรเรียกใช้
`pipeAsInput`	`File`: `File` ที่จะส่งเป็นอินพุตไปยังคำสั่ง หรือ null

การคืนสินค้า
`CommandResult`	ผลการค้นหาในภาษา`CommandResult`

ส่ง
`DeviceNotAvailableException`

executeShellV2Command

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

พารามิเตอร์
`cmd`	`String`: คำสั่ง adb shell ที่จะเรียกใช้
`maxTimeoutForCommand`	`long`: การหมดเวลาสูงสุดสำหรับคำสั่งให้เสร็จสมบูรณ์ หน่วยเป็น ที่ระบุใน `timeUnit`
`timeUnit`	`TimeUnit`: หน่วยสำหรับ `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: จำนวนครั้งสูงสุดในการลองส่งคำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะแสดง DeviceNotResponsiveException หากดำเนินการ `retryAttempts` ไม่สำเร็จ

การคืนสินค้า
`CommandResult`

ส่ง
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

เมธอดช่วยที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult ที่มีเอาต์พุตสถานะคำสั่งและ stderr อย่างถูกต้อง ส่วน stdout จะ เปลี่ยนเส้นทางไปยังสตรีมที่ระบุ

พารามิเตอร์
`cmd`	`String`: คำสั่งที่ควรเรียกใช้
`pipeToOutput`	`OutputStream`: `OutputStream` ที่จะเปลี่ยนเส้นทางเอาต์พุตมาตรฐาน หรือ null

การคืนสินค้า
`CommandResult`	ผลการค้นหาในภาษา`CommandResult`

ส่ง
`DeviceNotAvailableException`

executeShellV2Command

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

พารามิเตอร์
`cmd`	`String`: คำสั่ง adb shell ที่จะเรียกใช้
`pipeAsInput`	`File`: `File` ที่จะส่งเป็นอินพุตไปยังคำสั่ง หรือ null
`pipeToOutput`	`OutputStream`: `OutputStream` ที่จะเปลี่ยนเส้นทางเอาต์พุตมาตรฐาน หรือ null
`pipeToError`	`OutputStream`: `OutputStream` ที่จะเปลี่ยนเส้นทางข้อผิดพลาดมาตรฐาน หรือ null
`maxTimeoutForCommand`	`long`: การหมดเวลาสูงสุดสำหรับคำสั่งให้เสร็จสมบูรณ์ หน่วยเป็น ที่ระบุใน `timeUnit`
`timeUnit`	`TimeUnit`: หน่วยสำหรับ `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: จำนวนครั้งสูงสุดในการลองส่งคำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะแสดง DeviceNotResponsiveException หากดำเนินการ `retryAttempts` ไม่สำเร็จ

การคืนสินค้า
`CommandResult`

ส่ง
`DeviceNotAvailableException`

executeShellV2Command

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

พารามิเตอร์
`cmd`	`String`: คำสั่ง adb shell ที่จะเรียกใช้
`pipeAsInput`	`File`: `File` ที่จะส่งเป็นอินพุตไปยังคำสั่ง หรือ null
`pipeToOutput`	`OutputStream`: `OutputStream` ที่จะเปลี่ยนเส้นทางเอาต์พุตมาตรฐาน หรือ null
`pipeToError`	`OutputStream`: `OutputStream` ที่จะเปลี่ยนเส้นทางข้อผิดพลาดมาตรฐาน หรือ null
`maxTimeoutForCommand`	`long`: การหมดเวลาสูงสุดสำหรับคำสั่งให้เสร็จสมบูรณ์ หน่วยเป็น ที่ระบุใน `timeUnit`
`maxTimeToOutputShellResponse`	`long`: ระยะเวลาสูงสุดที่อนุญาตให้คำสั่งไม่ต้องแสดงการตอบกลับใดๆ หน่วยตามที่ระบุใน `timeUnit`
`timeUnit`	`TimeUnit`: หน่วยสำหรับ `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: จำนวนครั้งสูงสุดในการลองส่งคำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะแสดง DeviceNotResponsiveException หากดำเนินการ `retryAttempts` ไม่สำเร็จ

การคืนสินค้า
`CommandResult`

ส่ง
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                IShellOutputReceiver receiver)

พารามิเตอร์
`cmd`	`String`: คำสั่งที่ควรเรียกใช้
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` ที่จะส่งเอาต์พุตของ Shell โดยตรง

การคืนสินค้า
`CommandResult`	ผลการค้นหาในภาษา`CommandResult`

ส่ง
`DeviceNotAvailableException`

fastbootOemRamdumpNow

public CommandResult fastbootOemRamdumpNow ()

วิธีการช่วยที่เรียกใช้ ramdump จากโหมด fastboot

วิธีนี้จะเรียกใช้คำสั่ง "oem ramdump now" ซึ่งแตกต่างจาก ERROR(/#executeFastbootCommand()), โดยจะไม่พยายามลองอีกครั้งหรือกู้คืนอุปกรณ์หากคำสั่งล้มเหลวหรือสถานะ ไม่ถูกต้อง เนื่องจากผลลัพธ์ที่ต้องการคืออุปกรณ์ขัดข้อง คาดว่าจะใช้เมื่ออุปกรณ์อยู่ในโหมด Fastboot อยู่แล้ว

การคืนสินค้า
`CommandResult`	CommandResult ที่มีเอาต์พุตของคำสั่ง

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

เมธอด Helper ที่ล้างพาร์ติชันสำหรับอุปกรณ์

หาก getUseFastbootErase() เป็น true ระบบจะใช้ fastboot erase เพื่อล้าง พาร์ติชัน จากนั้นอุปกรณ์จะต้องสร้างระบบไฟล์ในครั้งถัดไปที่อุปกรณ์บูต ไม่เช่นนั้น ระบบจะใช้รูปแบบ fastboot ซึ่งจะสร้างระบบไฟล์ใหม่ในอุปกรณ์

คาดว่าจะใช้เมื่ออุปกรณ์อยู่ในโหมด Fastboot อยู่แล้ว

พารามิเตอร์
`partition`	`String`: พาร์ติชันที่จะล้างข้อมูล

การคืนสินค้า
`CommandResult`	CommandResult ที่มีเอาต์พุตของคำสั่ง

ส่ง
`DeviceNotAvailableException`

getActiveApexes

public Set<ITestDevice.ApexInfo> getActiveApexes ()

ดึงข้อมูลเกี่ยวกับ APEX ที่เปิดใช้งานในอุปกรณ์

การคืนสินค้า
`Set<ITestDevice.ApexInfo>`	`Set` จาก `ApexInfo` เปิดใช้งานอยู่ในอุปกรณ์

ส่ง
`DeviceNotAvailableException`

getAdbPath

public String getAdbPath ()

แสดงเส้นทางของไบนารี adb ที่ใช้อยู่

การคืนสินค้า
`String`

getAllSettings

public Map<String, String> getAllSettings (String namespace)

แสดงผลคู่คีย์-ค่าของเนมสเปซที่ขอ

พารามิเตอร์
`namespace`	`String`: ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ {"system", "secure", "global"}

การคืนสินค้า
`Map<String, String>`	แผนที่ของคู่คีย์-ค่า เป็น Null หากไม่รองรับเนมสเปซ

ส่ง
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

แสดงผลสถานะการจัดสรรปัจจุบันของอุปกรณ์

การคืนสินค้า
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

ค้นหาและแสดง android-id ที่เชื่อมโยงกับ userId หรือแสดงค่า null หากไม่พบ

พารามิเตอร์
`userId`	`int`

การคืนสินค้า
`String`

ส่ง
`DeviceNotAvailableException`

getAndroidIds

public Map<Integer, String> getAndroidIds ()

สร้างแผนที่ของรหัส Android ที่พบซึ่งตรงกับรหัสผู้ใช้ ไม่มีการรับประกันว่ารหัสผู้ใช้แต่ละรายการจะพบรหัส Android ที่เชื่อมโยงในฟังก์ชันนี้ ดังนั้นรหัสผู้ใช้บางรายการอาจตรงกับค่า Null

การคืนสินค้า
`Map<Integer, String>`	แผนที่ของรหัส Android ที่พบซึ่งตรงกับรหัสผู้ใช้

ส่ง
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

รับระดับ API ของอุปกรณ์ ค่าเริ่มต้นคือ UNKNOWN_API_LEVEL

การคืนสินค้า
`int`	จำนวนเต็มที่ระบุระดับ API ของอุปกรณ์

ส่ง
`DeviceNotAvailableException`

getApiLevelFull

public int getApiLevelFull ()

คล้ายกับ getApiLevel() แต่จะแสดงผลเวอร์ชันเต็ม

การคืนสินค้า
`int`	จำนวนเต็มที่ระบุระดับ API แบบเต็มของอุปกรณ์

ส่ง
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

ดึงข้อมูลเกี่ยวกับแพ็กเกจที่ติดตั้งในอุปกรณ์

พารามิเตอร์
`packageName`	`String`

การคืนสินค้า
`PackageInfo`	`PackageInfo` หรือ `null` หากเรียกข้อมูลไม่ได้

ส่ง
`DeviceNotAvailableException`

getAppPackageInfos

public List<PackageInfo> getAppPackageInfos ()

ดึงข้อมูลของแพ็กเกจที่ติดตั้งในอุปกรณ์

การคืนสินค้า
`List<PackageInfo>`	`List` จาก `PackageInfo` ที่ติดตั้งในอุปกรณ์

ส่ง
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

วิธีการที่สะดวกในการรับเวอร์ชันเบสแบนด์ (วิทยุ) ของอุปกรณ์นี้ การรับเวอร์ชันวิทยุ เป็นข้อมูลเฉพาะของอุปกรณ์ ดังนั้นอาจไม่แสดงข้อมูลที่ถูกต้องสำหรับอุปกรณ์บางเครื่อง วิธีนี้ใช้พร็อพเพอร์ตี้ gsm.version.baseband เพื่อแสดงข้อมูลเวอร์ชันที่ถูกต้อง ข้อมูลนี้ไม่ถูกต้องสำหรับอุปกรณ์ CDMA บางเครื่อง และเวอร์ชันที่แสดงที่นี่อาจไม่ตรงกับเวอร์ชันที่รายงานจาก fastboot และอาจไม่แสดงเวอร์ชันสำหรับวิทยุ CDMA สรุปสั้นๆ คือ วิธีนี้จะรายงานเวอร์ชันที่ถูกต้องก็ต่อเมื่อพร็อพเพอร์ตี้ gsm.version.baseband เหมือนกับเวอร์ชันที่ fastboot getvar version-baseband แสดงผล

การคืนสินค้า
`String`	`String`เวอร์ชันเบสแบนด์`null`หรือหากระบุไม่ได้ (อุปกรณ์ไม่มีวิทยุหรืออ่านสตริงเวอร์ชันไม่ได้)

ส่ง
`DeviceNotAvailableException`

getBattery

public Integer getBattery ()

แสดงระดับแบตเตอรี่ปัจจุบันของอุปกรณ์หรือ Null หากระดับแบตเตอรี่ไม่พร้อมใช้งาน

การคืนสินค้า
`Integer`

getBooleanProperty

public 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 Map<Long, String> getBootHistory ()

เมธอด Helper จะรวบรวมแผนที่ประวัติการบูตพร้อมเวลาและเหตุผลในการบูต

การคืนสินค้า
`Map<Long, String>`	แผนที่ของเวลาบูต (เวลา UTC เป็นวินาทีตั้งแต่ Epoch) และเหตุผลในการบูต

ส่ง
`DeviceNotAvailableException`

getBootHistorySince

public Map<Long, String> getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

เมธอด Helper จะรวบรวมแผนที่ประวัติการเปิดเครื่องพร้อมเวลาเปิดเครื่องและเหตุผลในการเปิดเครื่องตั้งแต่เวลาที่ระบุ นับตั้งแต่ Epoch จากอุปกรณ์และหน่วยเวลาที่ระบุ คุณรับ utcEpochTime ปัจจุบันของอุปกรณ์ในหน่วยมิลลิวินาทีได้โดยใช้เมธอด getDeviceDate()

พารามิเตอร์
`utcEpochTime`	`long`: เวลาของอุปกรณ์ตั้งแต่ Epoch
`timeUnit`	`TimeUnit`: หน่วยเวลา `TimeUnit`

การคืนสินค้า
`Map<Long, String>`	แผนที่ของเวลาบูต (เวลา UTC เป็นวินาทีตั้งแต่ Epoch) และเหตุผลในการบูต

ส่ง
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

วิธีที่สะดวกในการดูเวอร์ชัน Bootloader ของอุปกรณ์นี้

จะพยายามดึงข้อมูลเวอร์ชัน Bootloader จากสถานะปัจจุบันของอุปกรณ์ (เช่น หากอุปกรณ์ อยู่ใน Fastboot Mode ระบบจะพยายามดึงข้อมูลเวอร์ชันจาก Fastboot)

การคืนสินค้า
`String`	`String` เวอร์ชัน Bootloader หรือ `null` หากไม่พบ

ส่ง
`DeviceNotAvailableException`
`UnsupportedOperationException`

getBugreport

public InputStreamSource getBugreport ()

เรียกข้อมูลรายงานข้อบกพร่องจากอุปกรณ์

เราขอรับประกันว่าการติดตั้งใช้งานนี้จะยังคงทำงานต่อไปในอุปกรณ์ที่ไม่มี sdcard (หรือยังไม่ได้ติดตั้ง sdcard)

การคืนสินค้า
`InputStreamSource`	`InputStreamSource` ซึ่งจะสร้างเนื้อหาของรายงานข้อบกพร่องตามคำขอ ใน กรณีที่ดำเนินการไม่สำเร็จ `InputStreamSource` จะสร้าง `InputStream` ที่ว่างเปล่า

getBugreportz

public InputStreamSource getBugreportz ()

เรียกข้อมูล bugreportz จากอุปกรณ์ รายงานข้อบกพร่องในรูปแบบ ZIP มีรายงานข้อบกพร่องหลักและ ไฟล์บันทึกอื่นๆ ที่มีประโยชน์สำหรับการแก้ไขข้อบกพร่อง

รองรับเฉพาะ "adb version" > 1.0.36

การคืนสินค้า
`InputStreamSource`	`InputStreamSource` ของไฟล์ zip ที่มี bugreportz ให้คืนค่าเป็น null ใน กรณีที่ล้มเหลว

getBuildAlias

public String getBuildAlias ()

ดึงข้อมูลชื่อแทนของบิลด์ที่อุปกรณ์กำลังใช้อยู่

โดยปกติแล้ว Build Alias จะเป็นสตริงที่อ่านง่ายกว่า Build ID (โดยทั่วไปจะเป็นตัวเลขสำหรับบิลด์ Nexus) เช่น เวอร์ชันสุดท้ายของ Android 4.2 มีชื่อแทนบิลด์ JDQ39 และรหัสบิลด์ 573038

การคืนสินค้า
`String`	นามแฝงของบิลด์หรือใช้รหัสบิลด์แทนหากเรียกข้อมูลไม่ได้

ส่ง
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

ดึงข้อมูลรสชาติของบิลด์สำหรับอุปกรณ์

การคืนสินค้า
`String`	รสชาติของบิลด์หรือ null หากดึงข้อมูลไม่ได้

ส่ง
`DeviceNotAvailableException`

getBuildId

public String getBuildId ()

เรียกข้อมูลบิลด์ที่อุปกรณ์ใช้อยู่ในปัจจุบัน

การคืนสินค้า
`String`	รหัสบิลด์หรือ `IBuildInfo.UNKNOWN_BUILD_ID` หากเรียกข้อมูลไม่ได้

ส่ง
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

แสดงประเภทคีย์ที่ใช้ลงนามในอิมเมจของอุปกรณ์

โดยปกติแล้ว อุปกรณ์ Android อาจได้รับการลงนามด้วยคีย์ทดสอบ (เช่น ใน AOSP) หรือคีย์รุ่น (ควบคุมโดยผู้ผลิตอุปกรณ์แต่ละราย)

การคืนสินค้า
`String`	คีย์การลงนาม (หากพบ) หรือ Null

ส่ง
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

แสดงผล DeviceDescriptor ที่แคชไว้หากมีการจัดสรรอุปกรณ์ มิเช่นนั้นจะแสดงผล DeviceDescriptor ปัจจุบัน

การคืนสินค้า
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

พารามิเตอร์
`shortDescriptor`	`boolean`: จะจำกัดข้อบ่งชี้ให้มีข้อมูลขั้นต่ำหรือไม่

การคืนสินค้า
`DeviceDescriptor`

getChildren

public String[] getChildren (String path)

ทางเลือกแทนการใช้ IFileEntry ซึ่งบางครั้งอาจใช้งานไม่ได้เนื่องจากสิทธิ์

พารามิเตอร์
`path`	`String`: คือเส้นทางในอุปกรณ์ที่จะทำการค้นหา

การคืนสินค้า
`String[]`	อาร์เรย์ของสตริงที่มีไฟล์ทั้งหมดในเส้นทางบนอุปกรณ์

ส่ง
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

การเชื่อมต่อปัจจุบันที่เชื่อมโยงกับอุปกรณ์

การคืนสินค้า
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

แสดง ContentProviderHandler หรือค่าว่างหากไม่มี

สามารถนำผู้ให้บริการเนื้อหามาใช้ซ้ำได้หากสร้างไว้ก่อนหน้านี้ด้วย userId เดียวกัน

พารามิเตอร์
`userId`	`int`: รหัสผู้ใช้เพื่อเริ่มต้น Content Provider

การคืนสินค้า
`ContentProviderHandler`

ส่ง
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

แสดงสถานะการพับปัจจุบันของอุปกรณ์หรือค่าว่างหากเกิดปัญหา

การคืนสินค้า
`DeviceFoldableState`

ส่ง
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

แสดงรหัสของผู้ใช้ที่กำลังใช้งานอยู่ ในกรณีที่เกิดข้อผิดพลาด ให้แสดงผล -10000

การคืนสินค้า
`int`

ส่ง
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

รับคลาสอุปกรณ์

การคืนสินค้า
`String`	`String` คลาสอุปกรณ์

getDeviceDate

public long getDeviceDate ()

แสดงวันที่ของอุปกรณ์เป็นมิลลิวินาทีที่เริ่มนับมาตั้งแต่วันที่ 1 มกราคม ค.ศ. 1970

การคืนสินค้า
`long`	วันที่ของอุปกรณ์ในรูปแบบ Epoch

ส่ง
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

ส่งคืน DeviceDescriptor จากข้อมูลอุปกรณ์เพื่อรับข้อมูลเกี่ยวกับอุปกรณ์โดยไม่ต้อง ส่งออบเจ็กต์อุปกรณ์จริง

การคืนสินค้า
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

พารามิเตอร์
`shortDescriptor`	`boolean`: จะจำกัดข้อบ่งชี้ให้มีข้อมูลขั้นต่ำหรือไม่

การคืนสินค้า
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

รับสถานะของอุปกรณ์

การคืนสินค้า
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Helper เพื่อรับความแตกต่างของเวลาระหว่างอุปกรณ์กับ Date ที่ระบุ ใช้เวลา Epoch ภายใน

พารามิเตอร์
`date`	`Date`

การคืนสินค้า
`long`	ความแตกต่างเป็นมิลลิวินาที

ส่ง
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

รับสตรีม stdout และ stderr ของโปรแกรมจำลอง

การคืนสินค้า
`InputStreamSource`	เอาต์พุตของโปรแกรมจำลอง

getEmulatorProcess

public Process getEmulatorProcess ()

แสดงผล Process ที่สอดคล้องกับโปรแกรมจำลองนี้

การคืนสินค้า
`Process`	`Process` หรือ `null`

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

บันทึกที่มีexecuteShellCommand(String)ทั้งหมด

การคืนสินค้า
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

เมธอดตัวช่วยในการกำหนดจำนวนพื้นที่ว่างในที่เก็บข้อมูลภายนอกของอุปกรณ์

การคืนสินค้า
`long`	ปริมาณพื้นที่ว่างเป็น KB

ส่ง
`DeviceNotAvailableException`

getFastbootPath

public String getFastbootPath ()

แสดงเส้นทางของไบนารี fastboot ที่ใช้อยู่ ยังคงต้องมีค่า isFastbootEnabled() เป็น "จริง" เพื่อเปิดใช้ฟังก์ชัน fastboot

การคืนสินค้า
`String`

getFastbootProductType

public String getFastbootProductType ()

วิธีที่สะดวกในการรับประเภทสินค้าของอุปกรณ์นี้เมื่ออยู่ในโหมด Fastboot

ใช้วิธีนี้ในกรณีที่อุปกรณ์ควรอยู่ในโหมด Fastboot เท่านั้น ซึ่งเป็นตัวแปรที่ปลอดภัยกว่าเล็กน้อย เมื่อเทียบกับเมธอด getProductType() ทั่วไปในกรณีนี้ เนื่องจาก ITestDevice จะทราบวิธีนำอุปกรณ์เข้าสู่ fastboot หากอุปกรณ์อยู่ในสถานะที่ไม่ถูกต้องหรือ ไม่ตอบสนอง

การคืนสินค้า
`String`	`String`ชื่อประเภทสินค้าหรือ`null`หากระบุไม่ได้

ส่ง
`DeviceNotAvailableException`
`UnsupportedOperationException`

getFastbootProductVariant

public String getFastbootProductVariant ()

วิธีที่สะดวกในการรับประเภทสินค้าของอุปกรณ์นี้เมื่ออยู่ในโหมด Fastboot

การคืนสินค้า
`String`	`String`ชื่อประเภทสินค้าหรือ`null`หากระบุไม่ได้

ส่ง
`DeviceNotAvailableException`
`UnsupportedOperationException`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

แสดงผลหมายเลขซีเรียลของ Fastboot Mode

การคืนสินค้า
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

ดึงค่าตัวแปร fastboot ที่ระบุจากอุปกรณ์

พารามิเตอร์
`variableName`	`String`: ชื่อตัวแปร

การคืนสินค้า
`String`	ค่าพร็อพเพอร์ตี้หรือ `null` หากไม่มี

ส่ง
`DeviceNotAvailableException`
`UnsupportedOperationException`

getFastbootVersion

public String getFastbootVersion ()

แสดงผลสตริงเวอร์ชันของไบนารี fastboot ที่ใช้ หรือ null หากเกิดข้อผิดพลาด

การคืนสินค้า
`String`

getFileEntry

public IFileEntry getFileEntry (String path)

เรียกข้อมูลการอ้างอิงไปยังไฟล์ระยะไกลในอุปกรณ์

พารามิเตอร์
`path`	`String`: เส้นทางไฟล์ที่จะดึงข้อมูล อาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับ "/" (เช่น รองรับทั้งไวยากรณ์ "/system" และ "system")

การคืนสินค้า
`IFileEntry`	`IFileEntry` หรือ `null` หากไม่พบไฟล์ที่ `path` ที่ระบุ

ส่ง
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

โปรแกรมช่วยที่ไม่เป็นทางการในการรับ FileEntry จากเส้นทางที่ไม่ใช่รูท FIXME: Refactor the FileEntry system to have it available from any path. (แม้จะไม่ได้รูท)

พารามิเตอร์
`entry`	`FileListingService.FileEntry`: `FileEntry` ไม่จำเป็นต้องเป็นรูทตามที่ Ddmlib ต้องการ

การคืนสินค้า
`IFileEntry`	FileEntryWrapper ที่แสดง FileEntry

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getFoldableStates

public Set<DeviceFoldableState> getFoldableStates ()

แสดงผลรายการสถานะการพับบนอุปกรณ์ ดูได้ด้วย "cmd device_state print-states"

การคืนสินค้า
`Set<DeviceFoldableState>`

ส่ง
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

แสดงผลการอ้างอิงไปยัง ddmlib IDevice ที่เกี่ยวข้อง

DDMS อาจจัดสรร IDevice ใหม่ทุกครั้งที่อุปกรณ์ตัดการเชื่อมต่อและ เชื่อมต่อจาก adb อีกครั้ง ดังนั้น ผู้โทรจึงไม่ควรเก็บการอ้างอิงถึง IDevice, เนื่องจากการอ้างอิงนั้นอาจล้าสมัย

การคืนสินค้า
`IDevice`	`IDevice`

getInstalledPackageNames

public Set<String> getInstalledPackageNames ()

ดึงชื่อแพ็กเกจแอปพลิเคชันที่มีอยู่ในอุปกรณ์

การคืนสินค้า
`Set<String>`	`Set` ของชื่อแพ็กเกจ `String` ที่ติดตั้งอยู่ในอุปกรณ์

ส่ง
`DeviceNotAvailableException`

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

แสดงผลค่าจำนวนเต็มของพร็อพเพอร์ตี้ที่ระบุจากอุปกรณ์

พารามิเตอร์
`name`	`String`: ชื่อพร็อพเพอร์ตี้
`defaultValue`	`long`: ค่าเริ่มต้นที่จะแสดงหากพร็อพเพอร์ตี้ว่างเปล่าหรือไม่มีอยู่

การคืนสินค้า
`long`	ค่าพร็อพเพอร์ตี้หรือ `defaultValue` หากพร็อพเพอร์ตี้ว่าง ไม่มีอยู่ หรือไม่มีค่าจำนวนเต็ม

ส่ง
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

รับที่อยู่ IP ของอุปกรณ์

การคืนสินค้า
`String`	ที่อยู่ IP ของอุปกรณ์ หรือ `null` หากอุปกรณ์ไม่มีที่อยู่ IP

ส่ง
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

แสดงออบเจ็กต์เพื่อรับสถานะปัจจุบันของ Keyguard หรือ Null หากไม่รองรับ

การคืนสินค้า
`KeyguardControllerState`	a `KeyguardControllerState` ที่มีสแนปชอตของสถานะของ Keyguard และแสดงค่า Null หากไม่รองรับการค้นหา Keyguard

ส่ง
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

แสดงเวลาล่าสุดที่ API ของ Tradefed ทริกเกอร์การรีบูตเป็นมิลลิวินาทีตั้งแต่ EPOCH ตามที่ System.currentTimeMillis() ส่งคืน

การคืนสินค้า
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

รับระดับ API ที่เปิดตัวครั้งแรกของอุปกรณ์ ค่าเริ่มต้นคือ UNKNOWN_API_LEVEL

การคืนสินค้า
`int`	จำนวนเต็มที่ระบุระดับ API แรกที่เปิดตัวของอุปกรณ์

ส่ง
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

ดึงสตรีมภาพรวมของข้อมูล Logcat

ทำงานได้ 2 โหมด ได้แก่

หากมีการบันทึก logcat ในเบื้องหลังอยู่ ระบบจะแสดงเนื้อหาปัจจุบันของการบันทึก logcat ในเบื้องหลังสูงสุด TestDeviceOptions.getMaxLogcatDataSize() ไบต์

มิเช่นนั้น จะแสดงผลการดัมพ์แบบคงที่ของข้อมูล Logcat หากอุปกรณ์ตอบสนองอยู่ในขณะนี้

การคืนสินค้า
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

ดึงสตรีมสแนปชอตของข้อมูล Logcat ที่บันทึกไว้ในช่วง maxBytes ที่ผ่านมา

มีประโยชน์ในกรณีที่คุณต้องการบันทึกสแนปชอตของข้อมูล Logcat ที่บันทึกไว้บ่อยๆ โดยไม่ต้องเสียค่าปรับพื้นที่ดิสก์ที่อาจมีขนาดใหญ่จากการรับgetLogcat()สแนปชอตทั้งหมด

พารามิเตอร์
`maxBytes`	`int`: จำนวนข้อมูลสูงสุดที่จะแสดงผล ควรเป็นจำนวนที่ พอดีกับหน่วยความจำ

การคืนสินค้า
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

รับการดัมพ์ของ Logcat ปัจจุบันสำหรับอุปกรณ์ ซึ่งต่างจาก getLogcat() วิธีนี้จะ แสดงผลการดัมพ์แบบคงที่ของ Logcat เสมอ

มีข้อเสียคือจะไม่มีการส่งคืนข้อมูลใดๆ หากเข้าถึงอุปกรณ์ไม่ได้

การคืนสินค้า
`InputStreamSource`	`InputStreamSource` ของข้อมูล Logcat ระบบจะแสดงผลสตรีมเปล่าหาก บันทึกข้อมูล Logcat ไม่สำเร็จ

getLogcatSince

public InputStreamSource getLogcatSince (long date)

ดึงสตรีมสแนปชอตของข้อมูล Logcat ที่บันทึกไว้โดยเริ่มจากวันที่ที่ระบุ ควรใช้เวลาในอุปกรณ์ getDeviceDate()

พารามิเตอร์
`date`	`long`: ในรูปแบบมิลลิวินาทีที่เริ่มนับมาตั้งแต่วันที่ 1 มกราคม ค.ศ. 1970 ของเวลาที่จะเริ่มสแนปชอตจนถึงปัจจุบัน (รับได้โดยใช้ 'date +%s')

การคืนสินค้า
`InputStreamSource`

getMacAddress

public String getMacAddress ()

แสดงที่อยู่ MAC ของอุปกรณ์ หรือแสดงค่า Null หากเรียกข้อมูลจากอุปกรณ์ไม่สำเร็จ

การคืนสินค้า
`String`

getMainUserId

public Integer getMainUserId ()

แสดงผลรหัสผู้ใช้หลัก

การคืนสินค้า
`Integer`	userId ของผู้ใช้หลัก (หากมี) และ null หากไม่มีผู้ใช้หลัก

ส่ง
`DeviceNotAvailableException`

getMainlineModuleInfo

public Set<String> getMainlineModuleInfo ()

รับข้อมูลเกี่ยวกับโมดูล Mainline ที่ติดตั้งในอุปกรณ์

การคืนสินค้า
`Set<String>`	`Set` ของโมดูล `String` mainline ที่ติดตั้งในอุปกรณ์ในปัจจุบัน

ส่ง
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

รับจำนวนผู้ใช้สูงสุดที่รองรับซึ่งทำงานพร้อมกัน ค่าเริ่มต้นคือ 0

การคืนสินค้า
`int`	จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่ใช้งานพร้อมกัน

ส่ง
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported (String userType)

รับจำนวนผู้ใช้ที่รองรับสูงสุดของประเภทผู้ใช้ที่ระบุ ค่าเริ่มต้นคือ 0

พารามิเตอร์
`userType`	`String`: ประเภทผู้ใช้ตามที่กำหนดไว้ใน UserManager เช่น "android.os.usertype.full.SECONDARY"

การคืนสินค้า
`int`	จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่รองรับของประเภทผู้ใช้ที่ระบุ

ส่ง
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

รับจำนวนผู้ใช้ที่เปลี่ยนได้สูงสุดที่ระบบรองรับ โดยไม่รวมผู้ใช้ที่เป็นแขกรับเชิญ หลังจาก API เวอร์ชัน 36 จะไม่รวมผู้ใช้ที่เปลี่ยนไม่ได้ (เช่น โปรไฟล์) ค่าเริ่มต้นคือ 0

การคืนสินค้า
`int`	จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่เปลี่ยนได้ที่รองรับ

ส่ง
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

การคืนสินค้า
`Process`	แสดงผลกระบวนการของ VM Microdroid หาก TestDevice ไม่ใช่ Microdroid จะแสดงผล null

getMonitor

public IDeviceStateMonitor getMonitor ()

ส่งคืน IDeviceStateMonitor ที่เชื่อมโยงกับอุปกรณ์

การคืนสินค้า
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

แสดงผลจุดต่อเชื่อม

ค้นหาอุปกรณ์โดยตรงหากไม่มีข้อมูลที่แคชไว้ใน IDevice

สิ่งที่ต้องทำ: ย้ายลักษณะการทำงานนี้ไปที่ IDevice.getMountPoint(String)

พารามิเตอร์
`mountName`	`String`: ชื่อของจุดต่อเชื่อม

การคืนสินค้า
`String`	จุดต่อเชื่อมหรือ `null`

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

แสดงผล MountPointInfo ที่สอดคล้องกับเส้นทางของจุดต่อเชื่อมที่ระบุ หรือ null หากเส้นทางนั้นไม่มีการติดตั้งอะไรเลย หรือไม่ปรากฏใน /proc/mounts เป็นจุดต่อเชื่อม

พารามิเตอร์
`mountpoint`	`String`

การคืนสินค้า
`ITestDevice.MountPointInfo`	`List` ของ `MountPointInfo` ที่มีข้อมูลใน "/proc/mounts"

ส่ง
`DeviceNotAvailableException`

getMountPointInfo

public List<ITestDevice.MountPointInfo> getMountPointInfo ()

แสดงผลข้อมูลใน /proc/mounts บนอุปกรณ์ในเวอร์ชันที่แยกวิเคราะห์แล้ว

การคืนสินค้า
`List<ITestDevice.MountPointInfo>`	`List` ของ `MountPointInfo` ที่มีข้อมูลใน "/proc/mounts"

ส่ง
`DeviceNotAvailableException`

getOptions

public TestDeviceOptions getOptions ()

ดึงตัวเลือกการทดสอบสำหรับอุปกรณ์

การคืนสินค้า
`TestDeviceOptions`	`TestDeviceOptions` ที่เกี่ยวข้องกับอุปกรณ์ที่อยู่ระหว่างการทดสอบ

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

วิธีการช่วยในการกำหนดปริมาณพื้นที่ว่างในพาร์ติชันของอุปกรณ์

พารามิเตอร์
`partition`	`String`

การคืนสินค้า
`long`	ปริมาณพื้นที่ว่างเป็น KB

ส่ง
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

แสดงผลรหัสผู้ใช้หลัก

การคืนสินค้า
`Integer`	userId ของผู้ใช้หลัก (หากมี) และ null หากไม่มีผู้ใช้หลัก

ส่ง
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

เมธอด Helper จะเรียกใช้คำสั่ง "pidof" และ "stat" และแสดงผลออบเจ็กต์ ProcessInfo ที่มี PID และเวลาเริ่มต้นของกระบวนการที่ระบุ

พารามิเตอร์
`processName`	`String`: สตริงชื่อกระบวนการ

การคืนสินค้า
`ProcessInfo`	ProcessInfo ของ processName ที่ระบุ

ส่ง
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

แสดง PID ของบริการหรือค่าว่างหากเกิดข้อผิดพลาด

พารามิเตอร์
`process`	`String`: สตริงชื่อกระบวนการ

การคืนสินค้า
`String`

ส่ง
`DeviceNotAvailableException`

getProductType

public String getProductType ()

วิธีการที่สะดวกในการรับประเภทสินค้าของอุปกรณ์นี้

วิธีนี้จะใช้ได้หากอุปกรณ์อยู่ในโหมด adb หรือ fastboot

การคืนสินค้า
`String`	`String`ชื่อประเภทสินค้า ต้องไม่เป็นค่าว่าง

ส่ง
`DeviceNotAvailableException`

getProductVariant

public String getProductVariant ()

วิธีการที่สะดวกในการรับสินค้าย่อยของอุปกรณ์นี้

วิธีนี้จะใช้ได้หากอุปกรณ์อยู่ในโหมด adb หรือ fastboot

การคืนสินค้า
`String`	`String`ชื่อสินค้าย่อย`null`หรือหากไม่สามารถระบุได้

ส่ง
`DeviceNotAvailableException`

getProperty

public String getProperty (String name)

ดึงค่าพร็อพเพอร์ตี้ที่ระบุจากอุปกรณ์

พารามิเตอร์
`name`	`String`: ชื่อพร็อพเพอร์ตี้

การคืนสินค้า
`String`	ค่าพร็อพเพอร์ตี้หรือ `null` หากไม่มี

ส่ง
`DeviceNotAvailableException`

getRecoveryMode

public ITestDevice.RecoveryMode getRecoveryMode ()

รับโหมดการกู้คืนปัจจุบันที่ใช้สำหรับอุปกรณ์

การคืนสินค้า
`ITestDevice.RecoveryMode`	โหมดการกู้คืนปัจจุบันที่ใช้สำหรับอุปกรณ์

getRemainingCreatableUserCount

public int getRemainingCreatableUserCount (String userType)

แสดงจำนวนผู้ใช้ประเภทผู้ใช้ที่ระบุซึ่งสร้างในอุปกรณ์นี้ได้

พารามิเตอร์
`userType`	`String`: ประเภทผู้ใช้ตามที่กำหนดไว้ใน UserManager เช่น "android.os.usertype.full.SECONDARY"

การคืนสินค้า
`int`	เพิ่มผู้ใช้ประเภทที่ระบุได้กี่ราย

ส่ง
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (Long displayId, 
                String format, 
                boolean rescale)

ถ่ายภาพหน้าจอจากอุปกรณ์ที่ระบุรหัสจอแสดงผลในรูปแบบที่รองรับ อนุญาตให้ปรับขนาดเพื่อ รองรับขนาดที่เล็กลง

พารามิเตอร์
`displayId`	`Long`: รหัสการแสดงผลของหน้าจอที่จะจับภาพหน้าจอ
`format`	`String`: รองรับ PNG, JPEG
`rescale`	`boolean`: หากควรปรับขนาดภาพหน้าจอเพื่อลดขนาดของรูปภาพที่ได้

การคืนสินค้า
`InputStreamSource`	`InputStreamSource` ของภาพหน้าจอในรูปแบบ หรือ `null` หาก ภาพหน้าจอไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

จับภาพหน้าจอจากอุปกรณ์ ขอแนะนำให้ใช้ getScreenshot(format) แทนโดยใช้การเข้ารหัส JPEG เพื่อให้มีขนาดเล็กลง

พารามิเตอร์
`format`	`String`: รองรับ PNG, JPEG

การคืนสินค้า
`InputStreamSource`	`InputStreamSource` ของภาพหน้าจอในรูปแบบ หรือ `null` หาก ภาพหน้าจอไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (long displayId)

จับภาพหน้าจอจากอุปกรณ์ที่ระบุรหัสการแสดงผล รูปแบบคือ PNG

TODO: extend the implementations above to support 'format' and 'rescale'

พารามิเตอร์
`displayId`	`long`: รหัสการแสดงผลของหน้าจอที่จะจับภาพหน้าจอ

การคืนสินค้า
`InputStreamSource`	`InputStreamSource` ของภาพหน้าจอในรูปแบบ หรือ `null` หาก ภาพหน้าจอไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

จับภาพหน้าจอจากอุปกรณ์ ขอแนะนำให้ใช้ getScreenshot(String) แทน โดยใช้การเข้ารหัส JPEG เพื่อให้มีขนาดเล็กลง

พารามิเตอร์
`format`	`String`: รองรับ PNG, JPEG
`rescale`	`boolean`: หากควรปรับขนาดภาพหน้าจอเพื่อลดขนาดของรูปภาพที่ได้

การคืนสินค้า
`InputStreamSource`	`InputStreamSource` ของภาพหน้าจอในรูปแบบ หรือ `null` หาก ภาพหน้าจอไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

จับภาพหน้าจอจากอุปกรณ์

การคืนสินค้า
`InputStreamSource`	`InputStreamSource` ของภาพหน้าจอในรูปแบบ PNG หรือ `null` หาก ภาพหน้าจอไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

วิธีที่สะดวกในการรับหมายเลขซีเรียลของอุปกรณ์นี้

การคืนสินค้า
`String`	`String` หมายเลขซีเรียล

getSetting

public String getSetting (int userId, 
                String namespace, 
                String key)

แสดงค่าของการตั้งค่าที่ขอ เนมสเปซต้องเป็นหนึ่งใน {"system", "secure", "global"}

พารามิเตอร์
`userId`	`int`
`namespace`	`String`
`key`	`String`

การคืนสินค้า
`String`	ค่าที่เชื่อมโยงกับ namespace:key ของผู้ใช้ เป็น Null หากไม่พบ

ส่ง
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

ดู getSetting(int,String,String) และดำเนินการกับผู้ใช้ระบบ

พารามิเตอร์
`namespace`	`String`
`key`	`String`

การคืนสินค้า
`String`

ส่ง
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

ส่งคืนผู้ให้บริการซิมการ์ดหรือ Null หากไม่มีหรือหากอุปกรณ์ไม่พร้อมใช้งาน

การคืนสินค้า
`String`

getSimState

public String getSimState ()

แสดงสถานะซิมการ์ดหรือ Null หากไม่มีหรืออุปกรณ์ไม่พร้อมใช้งาน

การคืนสินค้า
`String`

getTombstones

public List<File> getTombstones ()

ดึงและแสดงรายการเครื่องหมายหลุมศพจากอุปกรณ์ ต้องใช้รูท

เป็นแบบพยายามอย่างเต็มที่ ดังนั้นหากดึงเครื่องหมายหลุมศพไม่ได้ไม่ว่าด้วยเหตุผลใดก็ตาม เครื่องหมายหลุมศพนั้นจะ หายไปจากรายการ มีเพียง DeviceNotAvailableException เท่านั้นที่จะสิ้นสุดวิธีการ ก่อนกำหนด

การคืนสินค้า
`List<File>`	รายการไฟล์ที่ถูกทำเครื่องหมายว่าไม่พร้อมใช้งาน ซึ่งจะว่างเปล่าหากไม่มีไฟล์ที่ถูกทำเครื่องหมาย

ส่ง
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

แสดงผลขนาดหน่วยความจำจริงทั้งหมดในหน่วยไบต์หรือ -1 ในกรณีที่เกิดข้อผิดพลาดภายใน

การคืนสินค้า
`long`

getTrackingSerial

public String getTrackingSerial ()

เพื่อวัตถุประสงค์ในการจัดการอุปกรณ์ ให้รับหมายเลขซีเรียลที่ใช้ในการติดตามอุปกรณ์

การคืนสินค้า
`String`

getUninstallablePackageNames

public Set<String> getUninstallablePackageNames ()

ดึงชื่อแพ็กเกจแอปพลิเคชันที่ถอนการติดตั้งได้ ปัจจุบันกำหนดให้เป็นแพ็กเกจที่ไม่ใช่ระบบและแพ็กเกจระบบที่อัปเดตแล้ว

การคืนสินค้า
`Set<String>`	`Set` ของชื่อแพ็กเกจ `String` ที่ถอนการติดตั้งไม่ได้ซึ่งติดตั้งอยู่ในอุปกรณ์ ในขณะนี้

ส่ง
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

ดูว่าจะใช้ fastboot erase หรือ fastboot format เพื่อล้างพาร์ติชันในอุปกรณ์

การคืนสินค้า
`boolean`	`true` หากจะใช้ fastboot erase หรือ `false` หากจะใช้ fastboot format

getUserFlags

public int getUserFlags (int userId)

ค้นหาและแสดงผลการแจ้งของผู้ใช้ที่ระบุ โดยมีการกำหนด Flag ไว้ในคลาส "android.content.pm.UserInfo" ในโครงการโอเพนซอร์ส Android

พารามิเตอร์
`userId`	`int`

การคืนสินค้า
`int`	แฟล็กที่เชื่อมโยงกับ userId ที่ระบุ หากพบ -10000 ในกรณีอื่นๆ

ส่ง
`DeviceNotAvailableException`

getUserInfos

public Map<Integer, UserInfo> getUserInfos ()

รับแผนที่ของ useId ไปยัง UserInfo ในอุปกรณ์ จะแสดง DeviceRuntimeException หากเอาต์พุตจากอุปกรณ์ไม่เป็นไปตามที่คาดไว้

การคืนสินค้า
`Map<Integer, UserInfo>`	รายการออบเจ็กต์ UserInfo

ส่ง
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

ส่งคืนหมายเลขซีเรียลที่เชื่อมโยงกับ userId หากพบ หรือ -10000 ในกรณีอื่นๆ

พารามิเตอร์
`userId`	`int`

การคืนสินค้า
`int`

ส่ง
`DeviceNotAvailableException`

getUserVisibleOnDisplay

public int getUserVisibleOnDisplay (int displayId)

รับรหัสผู้ใช้ของผู้ใช้ที่มองเห็นได้บนจอแสดงผลที่ระบุ

พารามิเตอร์
`displayId`	`int`: รหัสของจอแสดงผล

การคืนสินค้า

int

รหัสผู้ใช้ของผู้ใช้ที่มองเห็นได้บนจอแสดงผลที่ระบุ โดยจะไม่แยกความแตกต่างระหว่างผู้ใช้ที่ทำงานในเบื้องหลังซึ่งมองเห็นได้กับผู้ใช้ที่ทำงานในเบื้องหน้าปัจจุบัน เนื่องจากผู้ใช้ทั้ง 2 ประเภทมองเห็นได้ หากต้องการ แยกความแตกต่าง ให้เปรียบเทียบกับผลลัพธ์ของ getCurrentUser() เพิ่มเติม

ส่ง
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

ประมวลผล DeviceEvent ที่ระบุ อาจเปลี่ยนอุปกรณ์ เป็นสถานะใหม่ จะแจ้งให้ IDeviceMonitor ทราบถึงการเปลี่ยนสถานะ

ประมวลผล DeviceEvent ซึ่งอาจเปลี่ยนสถานะการจัดสรรอุปกรณ์นี้เป็นสถานะใหม่หรือไม่ก็ได้

พารามิเตอร์
`event`	`DeviceEvent`

การคืนสินค้า
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

ตรวจสอบว่าฟีเจอร์พร้อมใช้งานในอุปกรณ์หรือไม่

พารามิเตอร์
`feature`	`String`: รูปแบบควรเป็น "feature:" หรือ "" โดยตรง

การคืนสินค้า
`boolean`	เป็นจริงหากพบฟีเจอร์ เป็นเท็จหากไม่พบ

ส่ง
`DeviceNotAvailableException`

initializeConnection

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

เริ่มการเชื่อมต่อกับอุปกรณ์ ฟังก์ชันนี้เรียกใช้โดย preInvocationSetup แต่ในบางกรณีอาจต้องเรียกใช้แยกกัน เมื่อสร้างการเชื่อมต่อระหว่างการตั้งค่าอุปกรณ์

พารามิเตอร์
`info`	`IBuildInfo`
`attributes`	`MultiMap`

ส่ง
`DeviceNotAvailableException`
`TargetSetupError`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

ติดตั้งแพ็กเกจ Android ในอุปกรณ์

พารามิเตอร์
`packageFile`	`File`: ไฟล์ APK ที่จะติดตั้ง
`reinstall`	`boolean`: `true` หากควรติดตั้งอีกครั้ง
`grantPermissions`	`boolean`: หากควรมอบสิทธิ์รันไทม์ทั้งหมด ณ เวลาที่ติดตั้ง
`extraArgs`	`String`: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm -h"

การคืนสินค้า
`String`	`String` พร้อมรหัสข้อผิดพลาด หรือ `null` หากสำเร็จ

ส่ง
`DeviceNotAvailableException`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

ติดตั้งแพ็กเกจ Android ในอุปกรณ์

พารามิเตอร์
`packageFile`	`File`: ไฟล์ APK ที่จะติดตั้ง
`reinstall`	`boolean`: `true` หากควรติดตั้งอีกครั้ง
`extraArgs`	`String`: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm -h"

การคืนสินค้า
`String`	`String` พร้อมรหัสข้อผิดพลาด หรือ `null` หากสำเร็จ

ส่ง
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

ติดตั้งแพ็กเกจ Android ในอุปกรณ์สำหรับผู้ใช้ที่ระบุ

พารามิเตอร์
`packageFile`	`File`: ไฟล์ APK ที่จะติดตั้ง
`reinstall`	`boolean`: `true` หากควรติดตั้งอีกครั้ง
`grantPermissions`	`boolean`: หากควรมอบสิทธิ์รันไทม์ทั้งหมด ณ เวลาที่ติดตั้ง
`userId`	`int`: รหัสผู้ใช้ที่เป็นจำนวนเต็มที่จะติดตั้ง
`extraArgs`	`String`: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm -h"

การคืนสินค้า
`String`	`String` พร้อมรหัสข้อผิดพลาด หรือ `null` หากสำเร็จ

ส่ง
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

ติดตั้งแพ็กเกจ Android ในอุปกรณ์สำหรับผู้ใช้ที่ระบุ

พารามิเตอร์
`packageFile`	`File`: ไฟล์ APK ที่จะติดตั้ง
`reinstall`	`boolean`: `true` หากควรติดตั้งอีกครั้ง
`userId`	`int`: รหัสผู้ใช้ที่เป็นจำนวนเต็มที่จะติดตั้ง
`extraArgs`	`String`: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm -h"

การคืนสินค้า
`String`	`String` พร้อมรหัสข้อผิดพลาด หรือ `null` หากสำเร็จ

ส่ง
`DeviceNotAvailableException`

installPackageWithIncrementalMode

public boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

ติดตั้ง APK ด้วยโหมดเพิ่ม

พารามิเตอร์
`apkFiles`	`File`: ไฟล์ APK ที่จะติดตั้ง
`extraArgs`	`String`
`userId`	`String`

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

การคืนสินค้า
`boolean`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการแจงนับแอปหรือไม่

การคืนสินค้า
`boolean`	เป็นจริงหากระบบรองรับการแจงนับแอป หากไม่รองรับจะเป็นเท็จ

ส่ง
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการข้ามการบล็อก SDK เป้าหมายต่ำในการติดตั้งแอปหรือไม่

การคืนสินค้า
`boolean`	เป็นจริงหากรองรับการข้ามการบล็อก SDK เป้าหมายต่ำ มิเช่นนั้นจะเป็นเท็จ

ส่ง
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

ตรวจสอบว่าได้ติดตั้ง debugfs แล้วหรือไม่

การคืนสินค้า
`boolean`	`true` หากมีการติดตั้ง debugfs

ส่ง
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

แสดงว่าอุปกรณ์มีการเข้ารหัสหรือไม่

การคืนสินค้า
`boolean`	`true` หากอุปกรณ์มีการเข้ารหัส

ส่ง
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

แสดงค่าเป็น True หากเส้นทางในอุปกรณ์เป็นไดเรกทอรี หากไม่ แสดงค่าเป็น False

พารามิเตอร์
`path`	`String`

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

isEnableAdbRoot

public boolean isEnableAdbRoot ()

การคืนสินค้า
`boolean`	`true` หากควรเปิดใช้ adb root ในอุปกรณ์

isEncryptionSupported

public boolean isEncryptionSupported ()

แสดงว่าอุปกรณ์รองรับการเข้ารหัสหรือไม่

การคืนสินค้า
`boolean`	`true` หากอุปกรณ์รองรับการเข้ารหัส

ส่ง
`DeviceNotAvailableException`

isExecutable

public boolean isExecutable (String fullPath)

แสดงค่าเป็น True หากเส้นทางไฟล์ในอุปกรณ์เป็นไฟล์ที่เรียกใช้งานได้ หากไม่ แสดงค่าเป็น False

พารามิเตอร์
`fullPath`	`String`

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

แสดงว่า Fastboot พร้อมใช้งานในอุปกรณ์หรือไม่

การคืนสินค้า
`boolean`

isHeadless

public boolean isHeadless ()

แสดงค่าเป็นจริงหากอุปกรณ์ไม่มีส่วนหัว (ไม่มีหน้าจอ) และแสดงค่าเป็นเท็จในกรณีอื่นๆ

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

แสดงว่าอุปกรณ์ใช้โหมดผู้ใช้ระบบแบบไม่มีส่วนหัวหรือไม่

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

แสดงว่าผู้ใช้หลักเป็นผู้ดูแลระบบถาวรและไม่สามารถลบหรือลดระดับเป็น สถานะที่ไม่ใช่ผู้ดูแลระบบได้

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

แสดงว่าอุปกรณ์นี้รองรับผู้ใช้ที่สลับได้หลายคนซึ่งมีข้อมูลเข้าสู่ระบบและ พื้นที่ที่ปรับแต่งได้ของตนเองหรือไม่

โปรดทราบว่าแม้จะระบุว่าไม่รองรับ แต่ระบบอาจยังอนุญาตให้มีผู้ใช้หลายคนได้ตราบใดที่ไม่จำเป็นต้องใช้ UI การเข้าสู่ระบบ เช่น ระบบอาจยังรองรับโปรไฟล์เนื่องจากไม่จำเป็นต้องใช้ UI การเข้าสู่ระบบ

นอกจากนี้ยังตรวจสอบ config_enableMultiUserUI ด้วย ตามคำขอ เราได้รับอนุญาตให้ถือว่า อุปกรณ์ที่ตั้งค่าเป็นจริงจะได้รับการกำหนดค่าให้อนุญาตการเพิ่มผู้ใช้รองผ่าน adb

การคืนสินค้า
`boolean`	อุปกรณ์รองรับผู้ใช้หลายคนที่สลับได้หรือไม่

ส่ง
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจและรหัสผู้ใช้ที่ระบุเพื่อตรวจสอบว่าผู้ใช้รายนั้น ติดตั้งแอปอยู่หรือไม่

พารามิเตอร์
`packageName`	`String`: แพ็กเกจที่เรากำลังตรวจสอบว่ามีการติดตั้งหรือไม่
`userId`	`String`: รหัสผู้ใช้ที่เรากำลังตรวจสอบว่ามีการติดตั้งแพ็กเกจไว้หรือไม่ หากเป็นค่าว่าง ระบบจะใช้ผู้ใช้หลัก เป็น 0

การคืนสินค้า
`boolean`	จริง หากมีการรายงานว่าติดตั้งแพ็กเกจแล้ว มิเช่นนั้นจะเป็น "เท็จ"

ส่ง
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจที่ระบุเพื่อตรวจสอบว่ามีการติดตั้งอยู่ในปัจจุบันหรือไม่

พารามิเตอร์
`packageName`	`String`

การคืนสินค้า
`boolean`	จริง หากมีการรายงานว่าติดตั้งแพ็กเกจแล้ว มิเช่นนั้นจะเป็น "เท็จ"

ส่ง
`DeviceNotAvailableException`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการให้สิทธิ์รันไทม์หรือไม่

การคืนสินค้า
`boolean`	เป็นจริงหากรองรับสิทธิ์รันไทม์ หรือเป็นเท็จ

ส่ง
`DeviceNotAvailableException`

isShellV2Support

public boolean isShellV2Support ()

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

แสดงค่าเป็น "จริง" หากอุปกรณ์อยู่ใน TestDeviceState.FASTBOOT หรือ TestDeviceState.FASTBOOTD

การคืนสินค้า
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

ตรวจสอบว่าผู้ใช้ที่ระบุใช้งานอยู่หรือไม่

พารามิเตอร์
`userId`	`int`

การคืนสินค้า
`boolean`	เป็นจริงหากผู้ใช้กำลังวิ่ง และเป็นเท็จในกรณีอื่นๆ

ส่ง
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

แสดงว่าผู้ใช้ที่ระบุเป็นผู้ใช้รองหรือไม่ตามสถานะ

พารามิเตอร์
`userId`	`int`

การคืนสินค้า
`boolean`	จริง หากผู้ใช้เป็นผู้ใช้รอง เท็จ หากไม่ใช่

ส่ง
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

ตรวจสอบว่าผู้ใช้ที่ระบุปรากฏหรือไม่

ผู้ใช้ที่ "มองเห็นได้" คือผู้ใช้ที่โต้ตอบกับผู้ใช้ "ที่เป็นมนุษย์" และจึงสามารถ เปิดกิจกรรมการเปิดแอป (โดยปกติจะอยู่ในจอแสดงผลเริ่มต้น)

พารามิเตอร์
`userId`	`int`

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

ตรวจสอบว่าผู้ใช้ที่ระบุปรากฏในจอแสดงผลที่ระบุหรือไม่

ผู้ใช้ที่ "มองเห็นได้" คือผู้ใช้ที่โต้ตอบกับผู้ใช้ที่เป็น "มนุษย์" และจึงสามารถ เปิดกิจกรรมการเปิดตัวในจอแสดงผลนั้นได้

พารามิเตอร์
`userId`	`int`
`displayId`	`int`

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

แสดงว่าอุปกรณ์อนุญาตให้ผู้ใช้เริ่มแสดงในเบื้องหลังใน ERROR(/java.android.view.Display#DEFAULT_DISPLAY) หรือไม่

หากเป็นเช่นนั้น คุณสามารถเรียก startVisibleBackgroundUser(int, int, boolean) โดยส่ง จอแสดงผลที่ listDisplayIdsForStartingVisibleBackgroundUsers() ส่งคืน (ซึ่ง ควรมี ERROR(/java.android.view.Display#DEFAULT_DISPLAY))

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

แสดงว่าอุปกรณ์อนุญาตให้ผู้ใช้เริ่มแสดงในเบื้องหลังได้หรือไม่

หากเป็นเช่นนั้น คุณก็เรียกใช้ startVisibleBackgroundUser(int, int, boolean) ได้โดยส่ง จอแสดงผลที่ listDisplayIdsForStartingVisibleBackgroundUsers() แสดงผล

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

ทดสอบว่าได้เปิดใช้ Wi-Fi หรือไม่

ตรวจสอบว่าเปิดใช้ Wi-Fi ในอุปกรณ์หรือไม่ มีประโยชน์ในการยืนยันสถานะ Wi-Fi ก่อนการทดสอบที่ไม่ควรเรียกใช้กับ Wi-Fi เช่น การทดสอบอินเทอร์เน็ตมือถือ

การคืนสินค้า
`boolean`	`true` หากเปิดใช้ Wi-Fi `false` หากปิดใช้

ส่ง
`DeviceNotAvailableException`

listDisplayIds

public Set<Long> listDisplayIds ()

รวบรวมรายการรหัสจอแสดงผลที่พร้อมใช้งานในอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger"

การคืนสินค้า
`Set<Long>`	รายการจอแสดงผล ค่าเริ่มต้นจะแสดงผลเป็นค่าเริ่มต้น 0 เสมอ

ส่ง
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

รับรายการจอแสดงผลที่ใช้เพื่อ start a user visible in the background ได้

การคืนสินค้า
`Set<Integer>`

ส่ง
`DeviceNotAvailableException`

listUsers

public ArrayList<Integer> listUsers ()

รับรายชื่อผู้ใช้ในอุปกรณ์ จะส่ง DeviceRuntimeException หากเอาต์พุต จากอุปกรณ์ไม่เป็นไปตามที่คาดไว้

การคืนสินค้า
`ArrayList<Integer>`	รายการรหัสผู้ใช้

ส่ง
`DeviceNotAvailableException`

logAnrs

public boolean logAnrs (ITestLogger logger)

รวบรวมและบันทึก ANR จากอุปกรณ์

พารามิเตอร์
`logger`	`ITestLogger`: `ITestLogger` สำหรับบันทึก ANR

การคืนสินค้า
`boolean`	เป็นจริงหากการบันทึกสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ

ส่ง
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

เมธอด Helper เพื่อสร้างรายงานข้อบกพร่องและบันทึกไปยังผู้รายงาน

พารามิเตอร์
`dataName`	`String`: ชื่อที่จะใช้รายงานข้อบกพร่อง
`listener`	`ITestLogger`: `ITestLogger` เพื่อบันทึกรายงานข้อบกพร่อง

การคืนสินค้า
`boolean`	เป็นจริงหากการบันทึกสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ

logOnDevice

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

บันทึกข้อความใน Logcat ของอุปกรณ์ นี่เป็นการเรียกที่ปลอดภัยซึ่งจะไม่เกิดข้อผิดพลาดแม้ว่าการบันทึกจะล้มเหลวก็ตาม

พารามิเตอร์
`tag`	`String`: แท็กที่เราใช้บันทึกข้อความใน Logcat
`level`	`Log.LogLevel`: ระดับการแก้ไขข้อบกพร่องของข้อความใน Logcat
`format`	`String`: รูปแบบข้อความ
`args`	`Object`: อาร์กิวเมนต์ที่จะแทนที่ผ่าน String.format()

mountDebugfs

public void mountDebugfs ()

เมานต์ debugfs

ส่ง
`DeviceNotAvailableException`

nonBlockingReboot

public void nonBlockingReboot ()

ออกคำสั่งเพื่อรีบูตอุปกรณ์และกลับมาเมื่อคำสั่งเสร็จสมบูรณ์และเมื่อ adb ไม่เห็นอุปกรณ์อีกต่อไป

ส่ง
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

แทนที่หากอุปกรณ์ต้องดำเนินการบางอย่างหลังจาก adb root และก่อนที่ อุปกรณ์จะกลับมาออนไลน์ การติดตั้งใช้งานเริ่มต้นจะไม่มีการดำเนินการเพิ่มเติมใดๆ และไม่รับประกันว่าจะเปิดใช้ adb root ในขั้นตอนนี้

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postAdbUnrootAction

public void postAdbUnrootAction ()

ลบล้างหากอุปกรณ์ต้องดำเนินการบางอย่างหลังจากเลิกรูทด้วย adb และก่อนที่อุปกรณ์จะกลับมาออนไลน์ การติดตั้งใช้งานเริ่มต้นจะไม่มีการดำเนินการเพิ่มเติมใดๆ และเราไม่รับประกันว่าจะปิดใช้ adb root ในขั้นตอนนี้

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postBootSetup

public void postBootSetup ()

ทำตามวิธีการเพื่อกำหนดค่าอุปกรณ์สำหรับการทดสอบหลังจากการบูตทุกครั้ง

ควรเรียกใช้หลังจากอุปกรณ์บูต/พร้อมใช้งานอย่างเต็มรูปแบบ

ในสถานการณ์ปกติ ไม่จำเป็นต้องเรียกใช้เมธอดนี้อย่างชัดเจน เนื่องจาก การติดตั้งใช้งานควรดำเนินการตามขั้นตอนเหล่านี้โดยอัตโนมัติเมื่อทำการรีบูต

ในกรณีที่อาจต้องเรียกใช้คือเมื่ออุปกรณ์รีบูตเนื่องจากเหตุการณ์อื่นๆ (เช่น เมื่อคำสั่งอัปเดต fastboot เสร็จสมบูรณ์)

ส่ง
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

ขั้นตอนเพิ่มเติมสำหรับการล้างข้อมูลที่จำเป็นสำหรับอุปกรณ์โดยเฉพาะ ซึ่งจะดำเนินการหลังจากเรียกใช้ เสร็จแล้ว

พารามิเตอร์
`exception`	`Throwable`: ข้อยกเว้นสุดท้ายที่เกิดจากความล้มเหลวในการเรียกใช้ (หากมี)

preInvocationSetup

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

ขั้นตอนเพิ่มเติมสำหรับการตั้งค่าที่จำเป็นเฉพาะอุปกรณ์ซึ่งจะดำเนินการในอุปกรณ์ก่อน ขั้นตอนการเรียกใช้

พารามิเตอร์
`info`	`IBuildInfo`: `IBuildInfo` ของอุปกรณ์
`attributes`	`MultiMap`: แอตทริบิวต์ที่จัดเก็บไว้ในบริบทการเรียกใช้

ส่ง
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์แบบเรียกซ้ำ

พารามิเตอร์
`deviceFilePath`	`String`: เส้นทางไฟล์แบบสัมบูรณ์ของแหล่งข้อมูลระยะไกล
`localDir`	`File`: ไดเรกทอรีในเครื่องที่จะดึงไฟล์เข้าไป
`userId`	`int`: รหัสผู้ใช้ที่จะดึงข้อมูล

การคืนสินค้า
`boolean`	`true` หากดึงไฟล์สำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์แบบเรียกซ้ำ

พารามิเตอร์
`deviceFilePath`	`String`: เส้นทางไฟล์แบบสัมบูรณ์ของแหล่งข้อมูลระยะไกล
`localDir`	`File`: ไดเรกทอรีในเครื่องที่จะดึงไฟล์เข้าไป

การคืนสินค้า
`boolean`	`true` หากดึงไฟล์สำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId, 
                long timeout)

ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์แบบเรียกซ้ำ

พารามิเตอร์
`deviceFilePath`	`String`: เส้นทางไฟล์แบบสัมบูรณ์ของแหล่งข้อมูลระยะไกล
`localDir`	`File`: ไดเรกทอรีในเครื่องที่จะดึงไฟล์เข้าไป
`userId`	`int`: รหัสผู้ใช้ที่จะดึงข้อมูล
`timeout`	`long`: การหมดเวลาสำหรับคำสั่งดึง

การคืนสินค้า
`boolean`	`true` หากดึงไฟล์สำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

pullFile

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

ดึงไฟล์ออกจากอุปกรณ์

พารามิเตอร์
`remoteFilePath`	`String`: เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์
`localFile`	`File`: ไฟล์ในเครื่องที่จะจัดเก็บเนื้อหา หากมีเนื้อหาอยู่แล้ว ระบบจะแทนที่เนื้อหาดังกล่าว
`userId`	`int`: รหัสผู้ใช้ที่จะดึงข้อมูล
`timeout`	`long`: คำสั่งดึงไฟล์หมดเวลา

การคืนสินค้า
`boolean`	`true` หากดึงข้อมูลไฟล์สำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

ดึงไฟล์ออกจากอุปกรณ์

พารามิเตอร์
`remoteFilePath`	`String`: เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์
`localFile`	`File`: ไฟล์ในเครื่องที่จะจัดเก็บเนื้อหา หากมีเนื้อหาอยู่แล้ว ระบบจะแทนที่เนื้อหาดังกล่าว

การคืนสินค้า
`boolean`	`true` หากดึงข้อมูลไฟล์สำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

ดึงไฟล์จากอุปกรณ์ จัดเก็บไว้ในFileชั่วคราวในเครื่อง และส่งคืนFile

พารามิเตอร์
`remoteFilePath`	`String`: เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์
`userId`	`int`: รหัสผู้ใช้ที่จะดึงข้อมูล

การคืนสินค้า
`File`	`File`ที่มีเนื้อหาของไฟล์ในอุปกรณ์ หรือ `null` หาก การคัดลอกล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม (รวมถึงปัญหาเกี่ยวกับระบบไฟล์ของโฮสต์)

ส่ง
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath)

ดึงไฟล์จากอุปกรณ์ จัดเก็บไว้ในFileชั่วคราวในเครื่อง และส่งคืนFile

พารามิเตอร์
`remoteFilePath`	`String`: เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์

การคืนสินค้า
`File`	`File`ที่มีเนื้อหาของไฟล์ในอุปกรณ์ หรือ `null` หาก การคัดลอกล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม (รวมถึงปัญหาเกี่ยวกับระบบไฟล์ของโฮสต์)

ส่ง
`DeviceNotAvailableException`

pullFile

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

ดึงไฟล์ออกจากอุปกรณ์

พารามิเตอร์
`remoteFilePath`	`String`: เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์
`localFile`	`File`: ไฟล์ในเครื่องที่จะจัดเก็บเนื้อหา หากมีเนื้อหาอยู่แล้ว ระบบจะแทนที่เนื้อหาดังกล่าว
`userId`	`int`: รหัสผู้ใช้ที่จะดึงข้อมูล

การคืนสินค้า
`boolean`	`true` หากดึงข้อมูลไฟล์สำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

ดึงไฟล์ออกจากอุปกรณ์และแสดงเนื้อหา

พารามิเตอร์
`remoteFilePath`	`String`: เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์

การคืนสินค้า
`String`	`String`ที่มีเนื้อหาของไฟล์ในอุปกรณ์ หรือ `null` หาก การคัดลอกล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม (รวมถึงปัญหาเกี่ยวกับระบบไฟล์ของโฮสต์)

ส่ง
`DeviceNotAvailableException`

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

เป็นวิธีที่สะดวกในการดึงไฟล์จากที่จัดเก็บข้อมูลภายนอกของอุปกรณ์ จัดเก็บไว้ในFileชั่วคราวในเครื่อง และส่งคืนการอ้างอิงไปยังFileนั้น

พารามิเตอร์
`remoteFilePath`	`String`: เส้นทางไปยังไฟล์ในอุปกรณ์ที่สัมพันธ์กับจุดเชื่อมต่อของที่เก็บข้อมูลภายนอกของอุปกรณ์

การคืนสินค้า
`File`	`File`ที่มีเนื้อหาของไฟล์ในอุปกรณ์ หรือ `null` หาก การคัดลอกล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม (รวมถึงปัญหาเกี่ยวกับระบบไฟล์ของโฮสต์)

ส่ง
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                int userId)

ส่งเนื้อหาไดเรกทอรีไปยังอุปกรณ์แบบเรียกซ้ำ

พารามิเตอร์
`localFileDir`	`File`: ไดเรกทอรีในเครื่องที่จะพุช
`deviceFilePath`	`String`: เส้นทางไฟล์แบบสัมบูรณ์ของปลายทางระยะไกล
`userId`	`int`: รหัสผู้ใช้ที่จะพุช

การคืนสินค้า
`boolean`	`true` หากพุชไฟล์สำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                Set<String> excludedDirectories)

ส่งเนื้อหาไดเรกทอรีไปยังอุปกรณ์แบบเรียกซ้ำพร้อมยกเว้นไดเรกทอรีบางรายการที่ กรองแล้ว

พารามิเตอร์
`localFileDir`	`File`: ไดเรกทอรีในเครื่องที่จะพุช
`deviceFilePath`	`String`: เส้นทางไฟล์แบบสัมบูรณ์ของปลายทางระยะไกล
`excludedDirectories`	`Set`: ชุดชื่อไดเรกทอรีที่ยกเว้นซึ่งไม่ควรพุช

การคืนสินค้า
`boolean`	`true` หากพุชไฟล์สำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

ส่งเนื้อหาไดเรกทอรีไปยังอุปกรณ์แบบเรียกซ้ำ

พารามิเตอร์
`localFileDir`	`File`: ไดเรกทอรีในเครื่องที่จะพุช
`deviceFilePath`	`String`: เส้นทางไฟล์แบบสัมบูรณ์ของปลายทางระยะไกล

การคืนสินค้า
`boolean`	`true` หากพุชไฟล์สำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                boolean evaluateContentProviderNeeded)

รูปแบบของ pushFile(File,String) ซึ่งอาจพิจารณาประเมินความจำเป็น สำหรับผู้ให้บริการเนื้อหาได้

พารามิเตอร์
`localFile`	`File`: ไฟล์ในเครื่องที่จะพุช
`remoteFilePath`	`String`: เส้นทางไฟล์แบบสัมบูรณ์ของปลายทางระยะไกล
`evaluateContentProviderNeeded`	`boolean`: ตรวจสอบว่าเราต้องการผู้ให้บริการเนื้อหาหรือไม่

การคืนสินค้า
`boolean`	`true` หากพุชไฟล์สำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

พุชไฟล์ไปยังอุปกรณ์ โดยค่าเริ่มต้นจะใช้ผู้ให้บริการเนื้อหา

พารามิเตอร์
`localFile`	`File`: ไฟล์ในเครื่องที่จะพุช
`remoteFilePath`	`String`: เส้นทางไฟล์แบบสัมบูรณ์ของปลายทางระยะไกล

การคืนสินค้า
`boolean`	`true` หากพุชไฟล์สำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                int userId)

พุชไฟล์ไปยังอุปกรณ์ โดยค่าเริ่มต้นจะใช้ผู้ให้บริการเนื้อหา

พารามิเตอร์
`localFile`	`File`: ไฟล์ในเครื่องที่จะพุช
`remoteFilePath`	`String`: เส้นทางไฟล์แบบสัมบูรณ์ของปลายทางระยะไกล
`userId`	`int`: รหัสผู้ใช้ที่จะพุช

การคืนสินค้า
`boolean`	`true` หากพุชไฟล์สำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

พุชไฟล์ที่สร้างจากสตริงไปยังอุปกรณ์

พารามิเตอร์
`contents`	`String`: เนื้อหาของไฟล์ที่จะพุช
`remoteFilePath`	`String`: เส้นทางไฟล์สัมบูรณ์ของปลายทางระยะไกล

การคืนสินค้า
`boolean`	`true` หากส่งสตริงสำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

เริ่มต้นใหม่

public void reboot (String reason)

รีบูตอุปกรณ์เข้าสู่โหมด adb โดยมี reason ที่กำหนดเพื่อคงไว้หลังการรีบูต

บล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน

คุณดูเหตุผลของการรีบูตครั้งล่าสุดได้โดยการค้นหาพร็อพเพอร์ตี้ sys.boot.reason

พารามิเตอร์
`reason`	`String`: เหตุผลในการรีบูตนี้ หรือ `null` หากไม่ได้ระบุเหตุผล

ส่ง
`DeviceNotAvailableException`

เริ่มต้นใหม่

public String reboot (String command, 
                String reason)

รีบูตอุปกรณ์โดยใช้ command ที่ระบุ

บล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน

คุณดูเหตุผลของการรีบูตครั้งล่าสุดได้โดยการค้นหาพร็อพเพอร์ตี้ sys.boot.reason

พารามิเตอร์

command

String: คำสั่งที่ส่งไปยัง `adb` โปรดทราบว่าคำสั่งจะส่ง "ตามที่เป็น" ดังนั้นผู้เรียกจึงต้องใส่เครื่องหมายคำพูดที่เหมาะสมหากจำเป็น (โดยเฉพาะอย่างยิ่งหากมีหลายส่วนที่คั่นด้วยช่องว่าง)

reason

String: เหตุผลในการรีบูตนี้ หรือ null หากไม่ได้ระบุเหตุผล

การคืนสินค้า
`String`

ส่ง
`DeviceNotAvailableException`

เริ่มต้นใหม่

public void reboot ()

รีบูตอุปกรณ์เข้าสู่โหมด adb

บล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน

ส่ง
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

รีบูตอุปกรณ์เข้าสู่โหมด Bootloader

บล็อกจนกว่าอุปกรณ์จะอยู่ในโหมด Bootloader

ส่ง
`DeviceNotAvailableException`
`UnsupportedOperationException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

รีบูตอุปกรณ์เข้าสู่โหมด fastbootd

บล็อกจนกว่าอุปกรณ์จะอยู่ในโหมด fastbootd

ส่ง
`DeviceNotAvailableException`
`UnsupportedOperationException`

rebootIntoRecovery

public void rebootIntoRecovery ()

รีบูตอุปกรณ์เข้าสู่โหมดการกู้คืน adb

บล็อกจนกว่าอุปกรณ์จะเข้าสู่การกู้คืน

ส่ง
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload ()

รีบูตอุปกรณ์เข้าสู่โหมดการโหลดจากแหล่งที่ไม่รู้จักของ adb (โปรดทราบว่านี่คือโหมดพิเศษภายใต้การกู้คืน)

บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดการโหลดแอปจากแหล่งที่ไม่รู้จัก

ส่ง
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดการโหลดแอปจากแหล่งที่ไม่รู้จัก

พารามิเตอร์
`autoReboot`	`boolean`: จะรีบูตอุปกรณ์โดยอัตโนมัติหลังจากโหลดจากแหล่งที่ไม่รู้จักหรือไม่

ส่ง
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline ()

ทางเลือกแทน reboot() ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น กล่าวคือมองเห็นได้ใน adb

ส่ง
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline (String reason)

พารามิเตอร์
`reason`	`String`: เหตุผลในการรีบูตนี้ หรือ `null` หากไม่ได้ระบุเหตุผล

ส่ง
`DeviceNotAvailableException`

rebootUserspace

public void rebootUserspace ()

รีบูตเฉพาะส่วนพื้นที่ผู้ใช้ของอุปกรณ์

บล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน

คำเตือน การรีบูตในพื้นที่ผู้ใช้กำลังอยู่ระหว่างการพัฒนา โปรดใช้โดยยอมรับความเสี่ยงเอง

ส่ง
`DeviceNotAvailableException`

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

ทางเลือกแทน rebootUserspace() ()} ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น ซึ่งจะมองเห็นได้ใน adb

ส่ง
`DeviceNotAvailableException`

recoverDevice

public boolean recoverDevice ()

พยายามกู้คืนการสื่อสารของอุปกรณ์

การคืนสินค้า
`boolean`	เป็นจริงหากมีการพยายามกู้คืนและสำเร็จ แสดงค่าเท็จหากข้ามการกู้คืน

ส่ง
`DeviceNotAvailableException`	หากอุปกรณ์ไม่พร้อมใช้งานแล้ว

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

ลงทะเบียน IDeviceActionReceiver สำหรับอุปกรณ์นี้

IDeviceActionReceiver ที่ลงทะเบียนทั้งหมดจะได้รับการแจ้งเตือนก่อนที่การดำเนินการในอุปกรณ์จะเริ่มขึ้น และหลังจากที่การดำเนินการในอุปกรณ์สิ้นสุดลง

พารามิเตอร์
`deviceActionReceiver`	`IDeviceActionReceiver`: `IDeviceActionReceiver` ที่จะลงทะเบียน

remountSystemReadOnly

public void remountSystemReadOnly ()

ทำให้พาร์ติชันระบบในอุปกรณ์เป็นแบบอ่านอย่างเดียว อาจรีบูตอุปกรณ์

ส่ง
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

ทำให้พาร์ติชันระบบในอุปกรณ์เขียนได้ อาจรีบูตอุปกรณ์

ส่ง
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

ตั้งค่าพาร์ติชันของผู้ให้บริการในอุปกรณ์เป็นแบบอ่านอย่างเดียว อาจรีบูตอุปกรณ์

ส่ง
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

ทำให้พาร์ติชันของผู้ให้บริการในอุปกรณ์เขียนได้ อาจรีบูตอุปกรณ์

ส่ง
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

นำผู้ดูแลระบบอุปกรณ์ที่ระบุในผู้ใช้ที่ระบุออกและแสดง true หากสำเร็จ หรือ false หากไม่สำเร็จ

พารามิเตอร์
`componentName`	`String`: ของผู้ดูแลระบบอุปกรณ์ที่จะนำออก
`userId`	`int`: ของผู้ใช้ที่ผู้ดูแลระบบอุปกรณ์อาศัยอยู่

การคืนสินค้า
`boolean`	เป็นจริงหากสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ

ส่ง
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

นำเจ้าของโปรไฟล์อุปกรณ์ที่มีอยู่ทั้งหมดออกอย่างเต็มความสามารถ

ส่ง
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

นำผู้ใช้ที่ระบุออกจากอุปกรณ์

พารามิเตอร์
`userId`	`int`: ของผู้ใช้ที่ต้องการนำออก

การคืนสินค้า
`boolean`	จริง หากเรานำผู้ใช้ออกได้สำเร็จ หรือเป็นเท็จ

ส่ง
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

รีเซ็ตสถานะการตั้งค่าผู้ให้บริการเนื้อหาเพื่อเรียกใช้การตั้งค่าอีกครั้ง

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                Collection<ITestLifeCycleReceiver> listeners)

เรียกใช้การทดสอบการวัดคุมและให้การกู้คืนอุปกรณ์

หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปก่อนที่การทดสอบจะเสร็จสมบูรณ์ และการกู้คืนสำเร็จ ระบบจะแจ้งให้ผู้ฟังทั้งหมดทราบว่า testRunFailed และจะแสดงผลเป็น "false" ระบบจะไม่เรียกใช้คำสั่งทดสอบ อีก ผู้โทรจะต้องลองโทรอีกครั้งหากจำเป็น

หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปก่อนที่การทดสอบจะเสร็จสมบูรณ์ และการกู้คืนล้มเหลว ระบบจะแจ้งให้ผู้ฟังทั้งหมดทราบว่า testRunFailed และจะแสดง DeviceNotAvailableException

พารามิเตอร์
`runner`	`IRemoteAndroidTestRunner`: `IRemoteAndroidTestRunner` ที่เรียกใช้การทดสอบ
`listeners`	`Collection`: ผู้ฟังผลการทดสอบ

การคืนสินค้า
`boolean`	`true` หากคำสั่งทดสอบเสร็จสมบูรณ์ `false` หากดำเนินการไม่สำเร็จเนื่องจากข้อยกเว้นในการสื่อสารของอุปกรณ์ แต่การกู้คืนสำเร็จ

ส่ง
`DeviceNotAvailableException`

runInstrumentationTests

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

วิธีที่สะดวกในการดำเนินการ runInstrumentationTests(IRemoteAndroidTestRunner,Collection) โดยมีผู้ฟังอย่างน้อย 1 คนส่งเป็นพารามิเตอร์

พารามิเตอร์
`runner`	`IRemoteAndroidTestRunner`: `IRemoteAndroidTestRunner` ที่เรียกใช้การทดสอบ
`listeners`	`ITestLifeCycleReceiver`: ผู้ฟังผลการทดสอบ

การคืนสินค้า
`boolean`	`true` หากคำสั่งทดสอบเสร็จสมบูรณ์ `false` หากไม่สำเร็จ แต่การกู้คืนสำเร็จ

ส่ง
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                Collection<ITestLifeCycleReceiver> listeners)

เหมือนกับ ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection) แต่ เรียกใช้การทดสอบสำหรับผู้ใช้ที่ระบุ

พารามิเตอร์
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`	`Collection`

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

เหมือนกับ ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,ITestLifeCycleReceiver...) แต่จะเรียกใช้การทดสอบสำหรับผู้ใช้ที่ระบุ

พารามิเตอร์
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`	`ITestLifeCycleReceiver`

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

setAdbPath

public void setAdbPath (String adbPath)

ตั้งค่าเส้นทางไปยังไบนารี adb ที่ควรใช้

พารามิเตอร์
`adbPath`	`String`

setConfiguration

public void setConfiguration (IConfiguration configuration)

แทรก IConfiguration ที่ใช้งานอยู่

พารามิเตอร์
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

พารามิเตอร์
`avdInfo`	`GceAvdInfo`

setDate

public void setDate (Date date)

ตั้งวันที่ในอุปกรณ์

หมายเหตุ: การตั้งค่าวันที่ในอุปกรณ์ต้องใช้สิทธิ์รูท

พารามิเตอร์
`date`	`Date`: ระบุวันที่ที่ต้องการ หากไม่มี `null` จะใช้วันที่ของโฮสต์

ส่ง
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

ตั้งค่าคอมโพเนนต์ผู้ดูแลระบบอุปกรณ์เป็นเจ้าของอุปกรณ์ในผู้ใช้ที่ระบุ

พารามิเตอร์
`componentName`	`String`: ของผู้ดูแลระบบอุปกรณ์ให้เป็นเจ้าของอุปกรณ์
`userId`	`int`: ของผู้ใช้ที่เจ้าของอุปกรณ์อาศัยอยู่

การคืนสินค้า
`boolean`	เป็นจริงหากสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ

ส่ง
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

อัปเดตสถานะของอุปกรณ์

พารามิเตอร์
`deviceState`	`TestDeviceState`: `TestDeviceState`

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

สำหรับโปรแกรมจำลอง ให้ตั้งค่า SizeLimitedOutputStream เพื่อบันทึกเอาต์พุต

พารามิเตอร์
`output`	`SizeLimitedOutputStream`: เพื่อบันทึกเอาต์พุต

setEmulatorProcess

public void setEmulatorProcess (Process p)

ตั้งค่า Process เมื่ออุปกรณ์นี้เป็นโปรแกรมจำลอง

พารามิเตอร์
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

ตั้งค่าตัวเลือก fastboot สำหรับอุปกรณ์ ควรตั้งค่าเมื่อมีการจัดสรรอุปกรณ์เป็นครั้งแรก

พารามิเตอร์
`fastbootEnabled`	`boolean`: อุปกรณ์รองรับ Fastboot หรือไม่

setFastbootPath

public void setFastbootPath (String fastbootPath)

ตั้งค่าเส้นทางไปยังไบนารี fastboot ที่ควรใช้ ยังคงต้องมีค่า isFastbootEnabled() เป็น "จริง" เพื่อเปิดใช้ฟังก์ชัน fastboot

พารามิเตอร์
`fastbootPath`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

อัปเดต iDevice ที่เชื่อมโยงกับ ITestDevice นี้

iDevice เครื่องใหม่ต้องอ้างอิงอุปกรณ์จริงเครื่องเดียวกันกับที่อ้างอิงในปัจจุบัน ระบบจะเรียกใช้เมธอดนี้ หาก DDMS จัดสรร IDevice ใหม่

พารามิเตอร์
`newDevice`	`IDevice`: `IDevice`

setLogStartDelay

public void setLogStartDelay (int delay)

ตั้งค่าเวลาเป็นมิลลิวินาทีเพื่อรอ ก่อนเริ่มการจับภาพ Logcat สำหรับอุปกรณ์ที่ออนไลน์

พารามิเตอร์
`delay`	`int`: ความล่าช้าในหน่วยมิลลิวินาที

setOptions

public void setOptions (TestDeviceOptions options)

ตั้งค่า TestDeviceOptions สำหรับอุปกรณ์

พารามิเตอร์
`options`	`TestDeviceOptions`

setProperty

public boolean setProperty (String propKey, 
                String propValue)

ตั้งค่าพร็อพเพอร์ตี้ที่ระบุในอุปกรณ์ ต้องระบุว่า adb root เป็นจริง

พารามิเตอร์
`propKey`	`String`: คีย์เป้าหมายที่จะตั้งค่า
`propValue`	`String`: ค่าพร็อพเพอร์ตี้ที่จะตั้งค่า

การคืนสินค้า
`boolean`	จะแสดง `True` หากคำสั่ง setprop สำเร็จ หรือ False หากไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

ตั้งค่า IDeviceRecovery ที่จะใช้สำหรับอุปกรณ์นี้ ควรตั้งค่าเมื่อมีการจัดสรรอุปกรณ์เป็นครั้งแรก

พารามิเตอร์
`recovery`	`IDeviceRecovery`: `IDeviceRecovery`

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

ตั้งค่าโหมดการกู้คืนปัจจุบันที่จะใช้กับอุปกรณ์

ใช้เพื่อควบคุมว่าจะใช้วิธีการกู้คืนใดเมื่อพบปัญหาการสื่อสารของอุปกรณ์ เราขอแนะนำให้ใช้วิธีนี้เฉพาะเมื่อจำเป็นเท่านั้น (เช่น เมื่อเฟรมเวิร์กล่ม เป็นต้น)

พารามิเตอร์
`mode`	`ITestDevice.RecoveryMode`: เลือกว่าควรเปิดโหมด "กู้คืนจนกว่าจะออนไลน์เท่านั้น" หรือไม่

setSetting

public void setSetting (String namespace, 
                String key, 
                String value)

ดู setSetting(int,String,String,String) และดำเนินการกับผู้ใช้ระบบ

พารามิเตอร์
`namespace`	`String`
`key`	`String`
`value`	`String`

ส่ง
`DeviceNotAvailableException`

setSetting

public void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

เพิ่มค่าการตั้งค่าลงในเนมสเปซของผู้ใช้ที่ต้องการ การตั้งค่าบางอย่างจะใช้ได้หลังจากรีบูตเท่านั้น เนมสเปซต้องเป็นหนึ่งใน {"system", "secure", "global"}

พารามิเตอร์
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

ส่ง
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

แทรกอินสแตนซ์ ITestLogger

พารามิเตอร์
`testLogger`	`ITestLogger`

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

เพื่อวัตถุประสงค์ในการจัดการอุปกรณ์ ให้ติดตามหมายเลขซีเรียลที่เราใช้เพื่ออ้างอิงอุปกรณ์

พารามิเตอร์
`trackingSerial`	`String`

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

ตั้งค่าว่าจะใช้ fastboot erase หรือ fastboot format เพื่อล้างพาร์ติชันในอุปกรณ์หรือไม่

พารามิเตอร์
`useFastbootErase`	`boolean`: `true` หากควรใช้ fastboot erase หรือ `false` หากควรใช้ fastboot format

startLogcat

public void startLogcat ()

เริ่มบันทึกเอาต์พุต Logcat จากอุปกรณ์ในเบื้องหลัง

จะไม่มีผลหากมีการบันทึกเอาต์พุต Logcat อยู่แล้ว โดยจะดึงข้อมูลได้ในภายหลังผ่าน getLogcat

เมื่อไม่ได้ใช้อุปกรณ์แล้ว ต้องเรียกใช้ stopLogcat()

โดยปกติแล้วไม่จำเป็นต้องเรียกใช้ startLogcat() และ stopLogcat() เมื่อ อยู่ในบริบทการเรียกใช้ TF เนื่องจากเฟรมเวิร์ก TF จะเริ่มและหยุด logcat

startTradeInModeTesting

public boolean startTradeInModeTesting (int timeoutMs)

เปิดใช้โหมดแลกซื้อเครื่องใหม่สำหรับการทดสอบ ระบบจะล้างข้อมูลในอุปกรณ์และรีบูต

พารามิเตอร์
`timeoutMs`	`int`

การคืนสินค้า
`boolean`	เป็นจริงหากสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId)

เริ่มผู้ใช้ที่ระบุในเบื้องหลังหากหยุดอยู่ หากผู้ใช้ ทำงานในเบื้องหลังอยู่แล้ว วิธีนี้จะไม่มีผล

พารามิเตอร์
`userId`	`int`: ของผู้ใช้ให้เริ่มทำงานในเบื้องหลัง

การคืนสินค้า
`boolean`	จริง หากเริ่มผู้ใช้ในเบื้องหลังได้สำเร็จ

ส่ง
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

เริ่มผู้ใช้ที่ระบุในเบื้องหลังหากหยุดอยู่ หากผู้ใช้ ทำงานในเบื้องหลังอยู่แล้ว วิธีนี้จะไม่มีผล ระบุแฟล็กเพิ่มเติมเพื่อรอให้การดำเนินการมีผลได้

พารามิเตอร์
`userId`	`int`: ของผู้ใช้ให้เริ่มทำงานในเบื้องหลัง
`waitFlag`	`boolean`: จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มและปลดล็อก

การคืนสินค้า
`boolean`	จริง หากเริ่มผู้ใช้ในเบื้องหลังได้สำเร็จ

ส่ง
`DeviceNotAvailableException`

startVisibleBackgroundUser

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

เริ่มผู้ใช้ที่ระบุในเบื้องหลัง ซึ่งจะมองเห็นได้ในจอแสดงผลที่ระบุ (เช่น อนุญาตให้ผู้ใช้ เปิดใช้กิจกรรมในจอแสดงผลนั้น)

หมายเหตุ: คำสั่งนี้ไม่ได้ตรวจสอบว่ามีผู้ใช้หรือไม่ มีการแสดงผลหรือไม่ device supports such feature ฯลฯ

พารามิเตอร์
`userId`	`int`: ของผู้ใช้ให้เริ่มทำงานในเบื้องหลัง
`displayId`	`int`: แสดงเพื่อเริ่มให้ผู้ใช้เห็นใน
`waitFlag`	`boolean`: จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มและปลดล็อก

การคืนสินค้า
`boolean`	`true` หากเริ่มผู้ใช้ให้มองเห็นในเบื้องหลังได้สำเร็จ

ส่ง
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

ปิดและลบเอาต์พุตของโปรแกรมจำลอง

stopLogcat

public void stopLogcat ()

หยุดบันทึกเอาต์พุต Logcat จากอุปกรณ์และทิ้งข้อมูล Logcat ที่บันทึกไว้ในปัจจุบัน

จะไม่มีผลหากไม่ได้บันทึกเอาต์พุต Logcat

stopTradeInModeTesting

public void stopTradeInModeTesting ()

หยุดการทดสอบโหมดแลกซื้อเครื่องใหม่

ส่ง
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

หยุดผู้ใช้ที่ระบุ หากผู้ใช้หยุดไปแล้ว เมธอดนี้จะไม่มีผล หยุดผู้ใช้ปัจจุบันและผู้ใช้ระบบไม่ได้

พารามิเตอร์
`userId`	`int`: ของผู้ใช้เพื่อหยุด

การคืนสินค้า
`boolean`	เป็นจริงหากหยุดผู้ใช้สำเร็จ

ส่ง
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

หยุดผู้ใช้ที่ระบุ สามารถระบุแฟล็กเพิ่มเติมเพื่อรอให้การดำเนินการมีผล และบังคับให้ผู้ใช้สิ้นสุดการทำงาน หยุดผู้ใช้ปัจจุบันและผู้ใช้ระบบไม่ได้

พารามิเตอร์
`userId`	`int`: ของผู้ใช้เพื่อหยุด
`waitFlag`	`boolean`: จะทำให้คำสั่งรอจนกว่าผู้ใช้จะหยุด
`forceFlag`	`boolean`: จะบังคับให้ผู้ใช้หยุด

การคืนสินค้า
`boolean`	เป็นจริงหากหยุดผู้ใช้สำเร็จ

ส่ง
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

เปลี่ยนอุปกรณ์เป็นโหมด adb-over-tcp

การคืนสินค้า
`String`	หมายเลขซีเรียล TCP หรือ `null` หากเปลี่ยนอุปกรณ์ไม่ได้

ส่ง
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

เปลี่ยนอุปกรณ์เป็นโหมด adb ผ่าน USB

การคืนสินค้า
`boolean`	`true` หากเปลี่ยนสำเร็จ หรือ `false` หากไม่สำเร็จ

ส่ง
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

เปลี่ยนไปใช้ userId อื่นที่มีการหมดเวลาเริ่มต้น switchUser(int, long)

พารามิเตอร์
`userId`	`int`

การคืนสินค้า
`boolean`	จริง หาก userId ใหม่ตรงกับผู้ให้บริการ userId มิเช่นนั้นจะเป็น "เท็จ"

ส่ง
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

เปลี่ยนไปใช้ userId อื่นโดยมีระยะหมดเวลาที่ระบุเป็นกำหนดเวลา พยายามปิดใช้ Keyguard หลังจากที่ผู้ใช้เปลี่ยนสำเร็จ

พารามิเตอร์
`userId`	`int`
`timeout`	`long`: เพื่อรอให้การเปลี่ยนผู้ใช้ล้มเหลวก่อนที่จะส่งคืนค่าเป็นเท็จ

การคืนสินค้า
`boolean`	จริง หาก userId ใหม่ตรงกับผู้ให้บริการ userId มิเช่นนั้นจะเป็น "เท็จ"

ส่ง
`DeviceNotAvailableException`

syncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

ซิงค์เนื้อหาของไดเรกทอรีไฟล์ในเครื่องกับอุปกรณ์ทีละรายการ

กำหนดว่าจะพุชไฟล์ใดโดยการเปรียบเทียบการประทับเวลาของไฟล์ในเครื่องกับไฟล์ที่เทียบเท่าในระยะไกล ระบบจะพุชเฉพาะไฟล์ที่ "ใหม่กว่า" หรือไฟล์ที่ไม่มีอยู่ไปยังอุปกรณ์ ดังนั้นค่าใช้จ่าย จึงควรค่อนข้างน้อยหากชุดไฟล์ในอุปกรณ์เป็นเวอร์ชันล่าสุดอยู่แล้ว

ระบบจะไม่สนใจไฟล์ที่ซ่อนอยู่ (ชื่อขึ้นต้นด้วย ".")

ตัวอย่างการใช้งาน: syncFiles("/tmp/files", "/sdcard") จะสร้างไดเรกทอรี /sdcard/files หากยังไม่มี และจะพุชเนื้อหา /tmp/files ไปยัง /sdcard/files แบบเรียกซ้ำ

พารามิเตอร์
`localFileDir`	`File`: ไดเรกทอรีไฟล์ในเครื่องที่มีไฟล์ที่จะพุชแบบเรียกซ้ำ
`deviceFilePath`	`String`: รูทเส้นทางแบบเต็มของไฟล์ปลายทางระยะไกล ต้องอ่านได้ทุกไดเรกทอรีในเส้นทางไฟล์นั้น เช่น การพุชไปยัง /data/local/tmp เมื่อ adb ไม่ใช่รูท จะล้มเหลว

การคืนสินค้า
`boolean`	`true` หากซิงค์ไฟล์สำเร็จ `false` หรือไม่เช่นนั้น

ส่ง
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

ใช้รายงานข้อบกพร่องและส่งคืนภายในออบเจ็กต์ Bugreport เพื่อจัดการ แสดงผลเป็น Null ในกรณีที่มีปัญหา ต้องล้างไฟล์ที่อ้างอิงในออบเจ็กต์ Bugreport ผ่าน Bugreport.close()

การคืนสินค้า
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

ถอนการติดตั้งแพ็กเกจ Android จากอุปกรณ์

พารามิเตอร์
`packageName`	`String`: แพ็กเกจ Android ที่จะถอนการติดตั้ง

การคืนสินค้า
`String`	`String` พร้อมรหัสข้อผิดพลาด หรือ `null` หากสำเร็จ

ส่ง
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

ถอนการติดตั้งแพ็กเกจ Android จากอุปกรณ์สำหรับผู้ใช้ที่ระบุ

พารามิเตอร์
`packageName`	`String`: แพ็กเกจ Android ที่จะถอนการติดตั้ง
`userId`	`int`: รหัสผู้ใช้ที่เป็นจำนวนเต็มที่จะถอนการติดตั้ง

การคืนสินค้า
`String`	`String` พร้อมรหัสข้อผิดพลาด หรือ `null` หากสำเร็จ

ส่ง
`DeviceNotAvailableException`

ปลดล็อกอุปกรณ์

public boolean unlockDevice ()

ปลดล็อกอุปกรณ์หากอุปกรณ์อยู่ในสถานะที่เข้ารหัส

เมธอดนี้อาจรีสตาร์ทเฟรมเวิร์ก แต่จะไม่เรียกใช้ postBootSetup() ดังนั้น อุปกรณ์อาจยังไม่พร้อมสำหรับการทดสอบอย่างเต็มที่เมื่อเมธอดนี้แสดงผล

การคืนสินค้า
`boolean`	`true` หากสำเร็จหรือหากอุปกรณ์ไม่ได้เข้ารหัส

ส่ง
`DeviceNotAvailableException`
`UnsupportedOperationException`

unmountDebugfs

public void unmountDebugfs ()

ยกเลิกการเชื่อมต่อ debugfs

ส่ง
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

บล็อกจนกว่าจะมีการตั้งค่าสถานะการบูตอุปกรณ์เสร็จสมบูรณ์

พารามิเตอร์
`timeOut`	`long`: เวลาเป็นมิลลิวินาทีที่รอให้ตั้งค่า Flag

การคืนสินค้า
`boolean`	จริง หากตั้งค่าสถานะการบูตของอุปกรณ์เสร็จสมบูรณ์ภายในระยะหมดเวลา

ส่ง
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable ()

รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ ใช้ระยะหมดเวลาเริ่มต้น

การคืนสินค้า
`boolean`	เป็นจริงหากอุปกรณ์พร้อมใช้งาน เป็นเท็จหากปิดใช้การกู้คืนและไม่พร้อมใช้งาน

ส่ง
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

การคืนสินค้า
`boolean`	เป็นจริงหากอุปกรณ์พร้อมใช้งาน เป็นเท็จหากปิดใช้การกู้คืนและไม่พร้อมใช้งาน

ส่ง
`DeviceNotAvailableException`

waitForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

รอให้อุปกรณ์ตอบสนองและพร้อมใช้งานโดยไม่พิจารณาเส้นทางการกู้คืน

พารามิเตอร์
`waitTime`	`long`

การคืนสินค้า
`boolean`	เป็นจริงหากอุปกรณ์พร้อมใช้งาน เป็นเท็จหากไม่พร้อมใช้งาน

ส่ง
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

บล็อกจนกว่าอุปกรณ์จะมองเห็นผ่าน fastboot ใช้ระยะหมดเวลาเริ่มต้น

ส่ง
`DeviceNotAvailableException`

waitForDeviceFastbootD

public void waitForDeviceFastbootD ()

ส่ง
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

บล็อกไม่ให้อุปกรณ์อยู่ในสถานะ "การกู้คืน adb" (โปรดทราบว่าสถานะนี้แตกต่างจาก IDeviceRecovery)

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

การคืนสินค้า
`boolean`	`true` หากอุปกรณ์บูตเข้าสู่การกู้คืนก่อนเวลาหมด `false` มิฉะนั้น

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

บล็อกไม่ให้อุปกรณ์อยู่ในสถานะ "adb sideload"

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

การคืนสินค้า
`boolean`	`true` หากอุปกรณ์บูตเข้าสู่การโหลดจากแหล่งที่ไม่รู้จักก่อนเวลาหมดอายุ `false` มิฉะนั้น

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

บล็อกไม่ให้อุปกรณ์พร้อมใช้งาน เช่น หายไปจาก adb

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

การคืนสินค้า
`boolean`	`true` หากอุปกรณ์ไม่พร้อมใช้งานก่อนเวลาหมดอายุ `false` มิฉะนั้น

waitForDeviceOnline

public void waitForDeviceOnline ()

บล็อกจนกว่าอุปกรณ์จะมองเห็นได้ผ่าน adb ใช้ระยะหมดเวลาเริ่มต้น

โปรดทราบว่าอุปกรณ์อาจไม่ตอบสนองต่อคำสั่งเมื่อดำเนินการเสร็จสมบูรณ์ โปรดใช้ waitForDeviceAvailable() แทน

ส่ง
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

บล็อกจนกว่าอุปกรณ์จะมองเห็นได้ผ่าน adb

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

ส่ง
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

รอให้อุปกรณ์ตอบสนองต่อคำสั่งเชลล์ adb พื้นฐาน

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

การคืนสินค้า
`boolean`	`true` หากอุปกรณ์ตอบสนองก่อนที่ `waitTime` จะหมดเวลา

วิธีการที่ได้รับการป้องกัน

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

พารามิเตอร์
`builder`	`DefaultConnection.ConnectionBuilder`

buildAdbShellCommand

protected String[] buildAdbShellCommand (String command, 
                boolean forceExitStatusDetection, 
                boolean oldShellCommand)

สร้างคำสั่ง OS สำหรับเซสชันคำสั่ง adb shell และอาร์กิวเมนต์ที่ระบุ

พารามิเตอร์
`command`	`String`
`forceExitStatusDetection`	`boolean`
`oldShellCommand`	`boolean`

การคืนสินค้า
`String[]`

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

พารามิเตอร์
`feature`	`String`
`strictMinLevel`	`int`

createRebootDeviceAction

protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                String reason)

สร้าง RebootDeviceAction เพื่อใช้เมื่อดำเนินการรีบูต

พารามิเตอร์
`rebootMode`	`NativeDevice.RebootMode`: โหมดของการรีบูตนี้
`reason`	`String`: สำหรับการรีบูตนี้

การคืนสินค้า
`NativeDevice.RebootDeviceAction`	`RebootDeviceAction` ที่สร้างขึ้น

createRunUtil

protected IRunUtil createRunUtil ()

การคืนสินค้า
`IRunUtil`

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

ทำการรีบูต adb

พารามิเตอร์
`rebootMode`	`NativeDevice.RebootMode`: โหมดของการรีบูตนี้
`reason`	`String`: สำหรับการรีบูตนี้

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

วิธีการช่วยในการส่งข้อยกเว้นหากไม่รองรับสิทธิ์รันไทม์

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getApiLevelSafe

protected int getApiLevelSafe ()

การคืนสินค้า
`int`

getLogger

protected ITestLogger getLogger ()

การคืนสินค้า
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

รับอินสแตนซ์ RunUtil เพื่อใช้งาน

การคืนสินค้า
`IRunUtil`

internalGetProperty

protected String internalGetProperty (String propName, 
                String fastbootVar, 
                String description)

ดึงข้อมูลพร็อพเพอร์ตี้ของอุปกรณ์จากแคช ddmlib โดยค่าเริ่มต้น และกลับไปใช้ `adb shell getprop` หรือ `fastboot getvar` ขึ้นอยู่กับว่าอุปกรณ์อยู่ใน Fastboot หรือไม่

พารามิเตอร์
`propName`	`String`: ชื่อของพร็อพเพอร์ตี้อุปกรณ์ตามที่ส่งคืนโดย `adb shell getprop`
`fastbootVar`	`String`: ชื่อของตัวแปร fastboot ที่เทียบเท่าเพื่อค้นหา หาก `null`, fastboot จะไม่พยายามค้นหา
`description`	`String`: คำอธิบายตัวแปรอย่างง่าย ตัวอักษรแรกควรเป็นตัวพิมพ์ใหญ่

การคืนสินค้า
`String`	สตริง ซึ่งอาจเป็น `null` หรือว่างเปล่า ซึ่งมีค่าของพร็อพเพอร์ตี้ที่ระบุ

ส่ง
`DeviceNotAvailableException`
`UnsupportedOperationException`

isInRebootCallback

protected boolean isInRebootCallback ()

แสดงผลว่าขณะนี้มีการเรียกกลับการรีบูตหรือไม่ หากเป็นจริง ให้ปิดใช้ API สาธารณะทั้งหมดสำหรับการรีบูต

การคืนสินค้า
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

แสดงผล true หากไฟล์ในเครื่องใหม่กว่าไฟล์ระยะไกล IFileEntry มีความแม่นยำถึงระดับนาที ในกรณีที่เวลาเท่ากัน ระบบจะถือว่าไฟล์นั้นเป็นไฟล์ใหม่กว่า

พารามิเตอร์
`localFile`	`File`
`entry`	`IFileEntry`

การคืนสินค้า
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

แจ้งเตือน IDeviceActionReceiver ทั้งหมดเกี่ยวกับเหตุการณ์สิ้นสุดการรีบูต

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

notifyRebootStarted

protected void notifyRebootStarted ()

แจ้งเตือน IDeviceActionReceiver ทั้งหมดเกี่ยวกับเหตุการณ์การเริ่มต้นรีบูต

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

performDeviceAction

protected boolean performDeviceAction (String actionDescription, 
                NativeDevice.DeviceAction action, 
                int retryAttempts)

ดำเนินการในอุปกรณ์นี้ พยายามกู้คืนอุปกรณ์และลองส่งคำสั่งอีกครั้ง (ไม่บังคับ) หาก การดำเนินการล้มเหลว

พารามิเตอร์
`actionDescription`	`String`: คำอธิบายสั้นๆ ของการดำเนินการที่จะทำ ใช้เพื่อการบันทึกเท่านั้น
`action`	`NativeDevice.DeviceAction`: การดำเนินการที่จะทำ
`retryAttempts`	`int`: ความพยายามในการลองใหม่เพื่อดำเนินการหากล้มเหลวแต่การกู้คืนสำเร็จ

การคืนสินค้า
`boolean`	`true` หากดำเนินการสำเร็จ

ส่ง
`DeviceNotAvailableException`	หากกู้คืนไม่สำเร็จหรือพยายามกู้คืนจนถึงจำนวนครั้งสูงสุดโดยไม่ สำเร็จ

postAdbReboot

protected void postAdbReboot (NativeDevice.RebootMode rebootMode)

การดำเนินการเพิ่มเติมที่อาจทำได้หลังจากการรีบูต

พารามิเตอร์
`rebootMode`	`NativeDevice.RebootMode`

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

prePostBootSetup

protected void prePostBootSetup ()

อนุญาตให้ประเภทอุปกรณ์แต่ละประเภท (AndroidNativeDevice, TestDevice) ลบล้างวิธีการนี้สำหรับ การตั้งค่าเฉพาะหลังการบูต

ส่ง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pullFileWithAdbCommand

protected boolean pullFileWithAdbCommand (String remoteFilePath, 
                File localFile, 
                long timeout)

พารามิเตอร์
`remoteFilePath`	`String`
`localFile`	`File`
`timeout`	`long`

การคืนสินค้า
`boolean`

ส่ง
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

ตั้งค่าอินสแตนซ์ Clock ที่จะใช้

พารามิเตอร์
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

ทำเครื่องหมาย TestDevice เป็น microdroid และตั้งค่า CID

พารามิเตอร์
`process`	`Process`: กระบวนการของ VM Microdroid

setTestDeviceOptions

protected void setTestDeviceOptions (Map<String, String> deviceOptions)

พารามิเตอร์
`deviceOptions`	`Map`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                String[] fullCmd)

เรียกใช้คำสั่ง Fastboot อย่างง่ายและรายงานสถานะของคำสั่ง

พารามิเตอร์
`timeout`	`long`
`fullCmd`	`String`

การคืนสินค้า
`CommandResult`

ส่ง
`UnsupportedOperationException`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                Map<String, String> envVarMap, 
                String[] fullCmd)

เรียกใช้คำสั่ง Fastboot อย่างง่ายด้วยตัวแปรสภาพแวดล้อมและรายงานสถานะของคำสั่ง

พารามิเตอร์
`timeout`	`long`
`envVarMap`	`Map`
`fullCmd`	`String`

การคืนสินค้า
`CommandResult`

ส่ง
`UnsupportedOperationException`

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

รอจนกว่าอุปกรณ์จะใช้งานไม่ได้ (หยุดรายงานไปยัง adb)

พารามิเตอร์
`operationDesc`	`String`: ชื่อของการดำเนินการที่รอให้พร้อมใช้งาน
`time`	`long`: เวลาที่รอให้สถานะ "ไม่พร้อมใช้งาน" เกิดขึ้น

การคืนสินค้า
`boolean`	เป็นจริงหากอุปกรณ์ไม่พร้อมใช้งาน

NativeDevice

สรุป

คลาสที่ซ้อนกัน

ค่าคงที่

ทุ่ง

เครื่องมือสร้างสาธารณะ

เมธอดสาธารณะ

วิธีการที่ได้รับการป้องกัน

ค่าคงที่

DEBUGFS_PATH

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

SD_CARD

STORAGE_EMULATED

ทุ่ง

mOptions

mStateMonitor

เครื่องมือสร้างสาธารณะ

NativeDevice

เมธอดสาธารณะ

adbInstallPackage

adbInstallPackage

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetworkIfNeededWithResult

connectToWifiNetworkIfNeededWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

createUser

createUser

createUser

createUserNoThrow

debugDeviceNotAvailable

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

disableAdbRoot

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

doesFileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

executeAdbCommand

executeAdbCommand

executeAdbCommand

executeAdbV2Command

executeAdbV2Command

executeAdbV2Command

executeAdbV2Command

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootOemRamdumpNow