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

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

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

IManagedTestDevice, ITestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice

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

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

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

สรุป

ค่าคงที่
`int`	`UNKNOWN_API_LEVEL` ค่าเริ่มต้นเมื่อตรวจหาระดับ API ไม่ได้

เมธอดสาธารณะ
`abstract boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` ตรวจสอบว่าระบบรองรับฟีเจอร์ในปัจจุบันหรือไม่ โดยพิจารณาจากระดับที่รองรับขั้นต่ำ
`abstract void`	`clearLogcat()` ลบข้อมูล Logcat ที่สะสมไว้
`abstract void`	`deleteFile(String deviceFilePath)` วิธีการช่วยลบไฟล์หรือไดเรกทอรีในอุปกรณ์
`abstract void`	`deleteFile(String deviceFilePath, int userId)` วิธีการช่วยในการลบไฟล์หรือไดเรกทอรีในอุปกรณ์
`abstract boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` วิธีการช่วยตรวจสอบว่าอุปกรณ์รีสตาร์ทแบบซอฟต์หรือไม่โดยการเปรียบเทียบ system_server ปัจจุบันกับ system_server ก่อนหน้า`ProcessInfo`
`abstract boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` เมธอดตัวช่วยในการตรวจสอบว่าอุปกรณ์รีสตาร์ทแบบซอฟต์หรือไม่นับตั้งแต่เวลา UTC ตั้งแต่ Epoch จาก อุปกรณ์และ `ERROR(/TimeUnit)`
`abstract boolean`	`disableAdbRoot()` ปิดรูท adb
`abstract boolean`	`doesFileExist(String deviceFilePath)` เมธอดตัวช่วยในการตรวจสอบว่ามีไฟล์ในอุปกรณ์หรือไม่
`abstract boolean`	`enableAdbRoot()` เปิดรูท adb
`abstract String`	`executeAdbCommand(long timeout, String... commandArgs)` เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา
`abstract String`	`executeAdbCommand(String... commandArgs)` เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบ
`abstract String`	`executeAdbCommand(long timeout, envMap, String... commandArgs)` เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา
`abstract CommandResult`	`executeAdbV2Command(long timeout, envMap, String... commandArgs)` เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา
`abstract CommandResult`	`executeAdbV2Command(String... commandArgs)` เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบ
`abstract CommandResult`	`executeAdbV2Command(long timeout, String... commandArgs)` เมธอดช่วยที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบที่มีการระบุการหมดเวลา
`abstract CommandResult`	`executeFastbootCommand(long timeout, String... commandArgs)` เมธอด Helper ที่เรียกใช้คำสั่ง fastboot เป็นคำสั่งของระบบ
`abstract CommandResult`	`executeFastbootCommand(String... commandArgs)` เมธอดตัวช่วยที่เรียกใช้คำสั่ง fastboot เป็นคำสั่งของระบบโดยมีระยะหมดเวลาเริ่มต้น 2 นาที
`abstract CommandResult`	`executeLongFastbootCommand(String... commandArgs)` เมธอดช่วยที่เรียกใช้คำสั่ง fastboot ที่ทำงานเป็นเวลานานในฐานะคำสั่งของระบบ
`abstract CommandResult`	`executeLongFastbootCommand( envVarMap, String... commandArgs)` เมธอด Helper ซึ่งเรียกใช้คำสั่ง fastboot ที่ทำงานเป็นเวลานานในฐานะคำสั่งของระบบที่มีตัวแปรสภาพแวดล้อมของระบบ
`abstract String`	`executeShellCommand(String command)` เมธอดช่วยที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น `String`
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` เรียกใช้คำสั่ง adb shell ที่ระบุ โดยจะลองอีกหลายครั้งหากคำสั่งล้มเหลว
`abstract CommandResult`	`executeShellV2Command(String command)` เมธอด Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น `CommandResult` ที่มีเอาต์พุตสถานะคำสั่ง, stdout และ stderr อย่างถูกต้อง
`abstract CommandResult`	`executeShellV2Command(String command, OutputStream pipeToOutput)` เมธอด Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น `CommandResult` ที่มีเอาต์พุตสถานะคำสั่งและ stderr อย่างถูกต้อง
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput)` เมธอด Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น `CommandResult` ที่มีเอาต์พุตสถานะคำสั่ง, stdout และ stderr อย่างถูกต้อง
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)` เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` เรียกใช้คำสั่ง adb shell โดยมีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
`abstract CommandResult`	`fastbootWipePartition(String partition)` วิธีการช่วยล้างพาร์ติชันสำหรับอุปกรณ์
`abstract int`	`getApiLevel()` รับระดับ API ของอุปกรณ์
`abstract String`	`getBasebandVersion()` วิธีการที่สะดวกในการรับเวอร์ชันเบสแบนด์ (วิทยุ) ของอุปกรณ์นี้
`abstract Integer`	`getBattery()` แสดงระดับแบตเตอรี่ปัจจุบันของอุปกรณ์หรือ Null หากระดับแบตเตอรี่ไม่พร้อมใช้งาน
`abstract boolean`	`getBooleanProperty(String name, boolean defaultValue)` แสดงค่าบูลีนของพร็อพเพอร์ตี้ที่ระบุ
`abstract`	`getBootHistory()` เมธอด Helper จะรวบรวมแผนที่ประวัติการบูตพร้อมเวลาและเหตุผลในการบูต
`abstract`	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` เมธอด Helper จะรวบรวมแผนที่ประวัติการเปิดเครื่องพร้อมเวลาเปิดเครื่องและเหตุผลในการเปิดเครื่องตั้งแต่เวลาที่ระบุ นับตั้งแต่เวลา Epoch จากอุปกรณ์และหน่วยเวลาที่ระบุ
`abstract String`	`getBootloaderVersion()` วิธีที่สะดวกในการรับเวอร์ชัน Bootloader ของอุปกรณ์นี้
`abstract String`	`getBuildAlias()` ดึงข้อมูลชื่อแทนของบิลด์ที่อุปกรณ์กำลังใช้อยู่
`abstract String`	`getBuildFlavor()` ดึงข้อมูลรสชาติของบิลด์สำหรับอุปกรณ์
`abstract String`	`getBuildId()` เรียกข้อมูลบิลด์ที่อุปกรณ์ใช้อยู่ในปัจจุบัน
`abstract String`	`getBuildSigningKeys()` แสดงประเภทคีย์ที่ใช้ลงนามในอิมเมจของอุปกรณ์ โดยปกติแล้ว อุปกรณ์ Android อาจลงนามด้วยคีย์ทดสอบ (เช่น ใน AOSP) หรือคีย์รุ่น (ควบคุมโดยผู้ผลิตอุปกรณ์แต่ละราย)
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor()` แสดงผล `DeviceDescriptor` ที่แคชไว้หากมีการจัดสรรอุปกรณ์ มิเช่นนั้นจะแสดงผล `DeviceDescriptor` ปัจจุบัน
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` แสดงผล `DeviceDescriptor` ที่แคชไว้หากมีการจัดสรรอุปกรณ์ มิเช่นนั้นจะแสดงผล `DeviceDescriptor` ปัจจุบัน
`abstract String[]`	`getChildren(String deviceFilePath)` ทางเลือกแทนการใช้ `IFileEntry` ซึ่งบางครั้งอาจใช้ไม่ได้เนื่องจากสิทธิ์
`abstract AbstractConnection`	`getConnection()` แสดงผลการเชื่อมต่อที่เชื่อมโยงกับอุปกรณ์
`abstract String`	`getDeviceClass()` รับคลาสอุปกรณ์
`abstract long`	`getDeviceDate()` แสดงผลวันที่ของอุปกรณ์เป็นมิลลิวินาทีตั้งแต่ Epoch
`abstract DeviceDescriptor`	`getDeviceDescriptor()` ส่งคืน `DeviceDescriptor` จากข้อมูลอุปกรณ์เพื่อรับข้อมูลเกี่ยวกับอุปกรณ์โดยไม่ต้อง ส่งออบเจ็กต์อุปกรณ์จริง
`abstract DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` ส่งคืน `DeviceDescriptor` จากข้อมูลอุปกรณ์เพื่อรับข้อมูลเกี่ยวกับอุปกรณ์โดยไม่ต้อง ส่งออบเจ็กต์อุปกรณ์จริง
`abstract TestDeviceState`	`getDeviceState()` รับสถานะของอุปกรณ์
`abstract long`	`getDeviceTimeOffset(Date date)` Helper เพื่อรับความแตกต่างของเวลาระหว่างอุปกรณ์กับ `ERROR(/Date)` ที่ระบุ
`abstract InputStreamSource`	`getEmulatorOutput()` รับสตรีม stdout และ stderr ของโปรแกรมจำลอง
`abstract long`	`getExternalStoreFreeSpace()` เมธอดตัวช่วยในการกำหนดจำนวนพื้นที่ว่างในที่เก็บข้อมูลภายนอกของอุปกรณ์
`abstract String`	`getFastbootProductType()` วิธีที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้เมื่ออยู่ในโหมด Fastboot
`abstract String`	`getFastbootProductVariant()` วิธีที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้เมื่ออยู่ในโหมด Fastboot
`abstract String`	`getFastbootSerialNumber()` แสดงผลหมายเลขซีเรียลของ Fastboot Mode
`abstract String`	`getFastbootVariable(String variableName)` ดึงค่าตัวแปร fastboot ที่ระบุจากอุปกรณ์
`abstract IFileEntry`	`getFileEntry(String path)` เรียกข้อมูลการอ้างอิงไปยังไฟล์ระยะไกลในอุปกรณ์
`abstract IDevice`	`getIDevice()` แสดงผลการอ้างอิงไปยัง ddmlib ที่เกี่ยวข้อง `IDevice`
`abstract long`	`getIntProperty(String name, long defaultValue)` แสดงผลค่าจำนวนเต็มของพร็อพเพอร์ตี้ที่ระบุจากอุปกรณ์
`abstract long`	`getLastExpectedRebootTimeMillis()` แสดงเวลาล่าสุดที่ API ของ Tradefed ทริกเกอร์การรีบูตเป็นมิลลิวินาทีตั้งแต่ EPOCH ตามที่ `System.currentTimeMillis()` แสดงผล
`abstract int`	`getLaunchApiLevel()` รับระดับ API ที่เปิดตัวครั้งแรกของอุปกรณ์
`abstract InputStreamSource`	`getLogcat()` ดึงสตรีมภาพรวมของข้อมูล Logcat
`abstract InputStreamSource`	`getLogcat(int maxBytes)` ดึงสตรีมสแนปชอตของข้อมูล Logcat ที่บันทึกไว้ล่าสุด `maxBytes`
`abstract InputStreamSource`	`getLogcatDump()` รับการดัมพ์ของ Logcat ปัจจุบันสำหรับอุปกรณ์
`abstract InputStreamSource`	`getLogcatSince(long date)` ดึงสตรีมสแนปชอตของข้อมูล Logcat ที่บันทึกไว้โดยเริ่มจากวันที่ที่ระบุ
`abstract String`	`getMountPoint(String mountName)` แสดงผลจุดต่อเชื่อม
`abstract ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` แสดง `MountPointInfo` ที่สอดคล้องกับเส้นทางของจุดต่อเชื่อมที่ระบุ หรือ `null` หากเส้นทางนั้นไม่มีการต่อเชื่อมใดๆ หรือไม่ปรากฏใน /proc/mounts เป็นจุดต่อเชื่อม
`abstract`	`getMountPointInfo()` แสดงผลข้อมูลใน /proc/mounts บนอุปกรณ์ในเวอร์ชันที่แยกวิเคราะห์แล้ว
`abstract long`	`getPartitionFreeSpace(String partition)` วิธีการช่วยในการกำหนดปริมาณพื้นที่ว่างในพาร์ติชันของอุปกรณ์
`abstract ProcessInfo`	`getProcessByName(String processName)` เมธอด Helper จะเรียกใช้คำสั่ง "pidof" และ "stat" และแสดงผลออบเจ็กต์ `ProcessInfo` ที่มี PID และเวลาเริ่มต้นของกระบวนการที่ระบุ
`abstract String`	`getProcessPid(String process)` แสดง PID ของบริการหรือค่าว่างหากเกิดข้อผิดพลาด
`abstract String`	`getProductType()` วิธีการที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้
`abstract String`	`getProductVariant()` วิธีที่สะดวกในการรับรายละเอียดปลีกย่อยของผลิตภัณฑ์ของอุปกรณ์นี้
`abstract String`	`getProperty(String name)` ดึงค่าพร็อพเพอร์ตี้ที่ระบุจากอุปกรณ์
`abstract ITestDevice.RecoveryMode`	`getRecoveryMode()` รับโหมดการกู้คืนปัจจุบันที่ใช้สำหรับอุปกรณ์
`abstract String`	`getSerialNumber()` วิธีที่สะดวกในการรับหมายเลขซีเรียลของอุปกรณ์นี้
`abstract`	`getTombstones()` ดึงและแสดงรายการเครื่องหมายหลุมศพจากอุปกรณ์
`abstract long`	`getTotalMemory()` แสดงขนาดหน่วยความจำจริงทั้งหมดในหน่วยไบต์หรือ -1 ในกรณีที่เกิดข้อผิดพลาดภายใน
`default String`	`getTrackingSerial()` เพื่อวัตถุประสงค์ในการจัดการอุปกรณ์ ให้รับหมายเลขซีเรียลที่ใช้ในการติดตามอุปกรณ์
`abstract boolean`	`getUseFastbootErase()` ดูว่าจะใช้ fastboot erase หรือ fastboot format เพื่อล้างพาร์ติชันในอุปกรณ์หรือไม่
`abstract boolean`	`isAdbRoot()`
`abstract boolean`	`isAdbTcp()`
`abstract boolean`	`isAppEnumerationSupported()` ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการแจงนับแอปหรือไม่
`abstract boolean`	`isBypassLowTargetSdkBlockSupported()` ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการข้ามการบล็อก SDK เป้าหมายต่ำในการติดตั้งแอปหรือไม่
`abstract boolean`	`isDebugfsMounted()` ตรวจสอบว่ามีการติดตั้ง debugfs หรือไม่
`abstract boolean`	`isDeviceEncrypted()` แสดงว่าอุปกรณ์มีการเข้ารหัสหรือไม่
`abstract boolean`	`isDirectory(String deviceFilePath)` แสดงค่าเป็น True หากเส้นทางในอุปกรณ์เป็นไดเรกทอรี หากไม่ แสดงค่าเป็น False
`abstract boolean`	`isEncryptionSupported()` แสดงว่าอุปกรณ์รองรับการเข้ารหัสหรือไม่
`abstract boolean`	`isExecutable(String fullPath)` แสดงค่าเป็น True หากเส้นทางไฟล์ในอุปกรณ์เป็นไฟล์ที่เรียกใช้งานได้ หากไม่ แสดงค่าเป็น False
`abstract boolean`	`isHeadless()` แสดงค่าเป็นจริงหากอุปกรณ์ไม่มีส่วนหัว (ไม่มีหน้าจอ) และแสดงค่าเป็นเท็จในกรณีอื่นๆ
`abstract boolean`	`isRuntimePermissionSupported()` ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการให้สิทธิ์รันไทม์หรือไม่
`abstract boolean`	`isStateBootloaderOrFastbootd()` แสดงค่าเป็น "จริง" หากอุปกรณ์อยู่ใน `TestDeviceState.FASTBOOT` หรือ `TestDeviceState.FASTBOOTD`
`abstract boolean`	`logAnrs(ITestLogger logger)` รวบรวมและบันทึก ANR จากอุปกรณ์
`abstract void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` บันทึกข้อความใน Logcat ของอุปกรณ์
`abstract void`	`mountDebugfs()` เมานต์ debugfs
`abstract void`	`nonBlockingReboot()` ออกคำสั่งเพื่อรีบูตอุปกรณ์และกลับมาเมื่อคำสั่งเสร็จสมบูรณ์และเมื่อ adb ไม่เห็นอุปกรณ์อีกต่อไป
`abstract void`	`postBootSetup()` ทำตามวิธีการเพื่อกำหนดค่าอุปกรณ์สำหรับการทดสอบทุกครั้งหลังจากการบูต
`default void`	`postInvocationTearDown()` เลิกใช้เมธอดนี้แล้ว โปรดใช้ `postInvocationTearDown(Throwable)` แทน
`abstract void`	`postInvocationTearDown(Throwable invocationException)` ขั้นตอนเพิ่มเติมสำหรับการล้างข้อมูลที่จำเป็นสำหรับอุปกรณ์โดยเฉพาะ ซึ่งจะดำเนินการหลังจากเรียกใช้ เสร็จแล้ว
`default void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` ขั้นตอนเพิ่มเติมสำหรับการตั้งค่าที่จำเป็นเฉพาะอุปกรณ์ซึ่งจะดำเนินการในอุปกรณ์ก่อน ขั้นตอนการเรียกใช้
`abstract boolean`	`pullDir(String deviceFilePath, File localDir)` ดึงเนื้อหาในไดเรกทอรีจากอุปกรณ์แบบเรียกซ้ำ
`abstract boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` ดึงเนื้อหาในไดเรกทอรีจากอุปกรณ์แบบเรียกซ้ำ
`abstract File`	`pullFile(String remoteFilePath, int userId)` ดึงไฟล์จากอุปกรณ์ จัดเก็บไว้ใน`ERROR(/File)`ชั่วคราวในเครื่อง และส่งคืน`File`
`abstract File`	`pullFile(String remoteFilePath)` ดึงไฟล์จากอุปกรณ์ จัดเก็บไว้ใน`ERROR(/File)`ชั่วคราวในเครื่อง และส่งคืน`File`
`abstract boolean`	`pullFile(String remoteFilePath, File localFile)` ดึงไฟล์ออกจากอุปกรณ์
`abstract boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` ดึงไฟล์ออกจากอุปกรณ์
`abstract String`	`pullFileContents(String remoteFilePath)` ดึงไฟล์ออกจากอุปกรณ์และแสดงผลเนื้อหา
`abstract File`	`pullFileFromExternal(String remoteFilePath)` เป็นวิธีที่สะดวกในการดึงไฟล์จากที่เก็บข้อมูลภายนอกของอุปกรณ์ จัดเก็บไว้ใน `ERROR(/File)`ชั่วคราวในเครื่อง และส่งคืนการอ้างอิงไปยัง `File` นั้น
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, int userId)` ส่งเนื้อหาในไดเรกทอรีไปยังอุปกรณ์แบบเรียกซ้ำ
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, excludedDirectories)` ส่งเนื้อหาในไดเรกทอรีไปยังอุปกรณ์แบบเรียกซ้ำพร้อมยกเว้นไดเรกทอรีบางรายการที่ กรองแล้ว
`abstract boolean`	`pushDir(File localDir, String deviceFilePath)` ส่งเนื้อหาไดเรกทอรีไปยังอุปกรณ์แบบเรียกซ้ำ
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)` รูปแบบของ `pushFile(File, String)` ซึ่งอาจพิจารณาประเมินความจำเป็น สำหรับผู้ให้บริการเนื้อหาได้
`abstract boolean`	`pushFile(File localFile, String deviceFilePath)` พุชไฟล์ไปยังอุปกรณ์
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, int userId)` พุชไฟล์ไปยังอุปกรณ์
`abstract boolean`	`pushString(String contents, String deviceFilePath)` ส่งไฟล์ที่สร้างจากสตริงไปยังอุปกรณ์
`abstract void`	`reboot()` รีบูตอุปกรณ์เข้าสู่โหมด adb
`abstract void`	`reboot(String reason)` รีบูตอุปกรณ์เข้าสู่โหมด adb โดยมี `reason` ที่กำหนดเพื่อคงไว้หลังการรีบูต
`abstract void`	`rebootIntoBootloader()` รีบูตอุปกรณ์เข้าสู่โหมด Bootloader
`abstract void`	`rebootIntoFastbootd()` รีบูตอุปกรณ์เข้าสู่โหมด fastbootd
`abstract void`	`rebootIntoRecovery()` รีบูตอุปกรณ์เข้าสู่โหมดการกู้คืน adb
`abstract void`	`rebootIntoSideload(boolean autoReboot)` รีบูตอุปกรณ์เข้าสู่โหมดการโหลดจากแหล่งที่ไม่รู้จักของ adb (โปรดทราบว่านี่คือโหมดพิเศษภายใต้การกู้คืน) บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดการโหลดแอปจากแหล่งที่ไม่รู้จัก
`abstract void`	`rebootIntoSideload()` รีบูตอุปกรณ์เข้าสู่โหมดการโหลดจากแหล่งที่ไม่รู้จักของ adb (โปรดทราบว่านี่คือโหมดพิเศษภายใต้การกู้คืน) บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดการโหลดแอปจากแหล่งที่ไม่รู้จัก
`abstract void`	`rebootUntilOnline()` ทางเลือกแทน `reboot()` ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น กล่าวคือมองเห็นได้ใน adb
`abstract void`	`rebootUntilOnline(String reason)` ทางเลือกแทน `reboot()` ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น เช่น มองเห็นได้ใน adb
`abstract void`	`rebootUserspace()` รีบูตเฉพาะส่วน Userspace ของอุปกรณ์
`abstract void`	`rebootUserspaceUntilOnline()` ทางเลือกแทน `rebootUserspace()` ()} ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น ซึ่งจะมองเห็นได้ใน adb
`abstract void`	`remountSystemReadOnly()` ทำให้พาร์ติชันระบบในอุปกรณ์เป็นแบบอ่านอย่างเดียว
`abstract void`	`remountSystemWritable()` ทำให้พาร์ติชันระบบในอุปกรณ์เขียนได้
`abstract void`	`remountVendorReadOnly()` ทำให้พาร์ติชันของผู้ให้บริการในอุปกรณ์เป็นแบบอ่านอย่างเดียว
`abstract void`	`remountVendorWritable()` ทำให้พาร์ติชันของผู้ให้บริการในอุปกรณ์เขียนได้
`abstract boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` วิธีที่สะดวกในการดำเนินการ `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` โดยส่งผู้ฟังอย่างน้อย 1 คนเป็นพารามิเตอร์
`abstract boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` เรียกใช้การทดสอบการวัดคุมและให้การกู้คืนอุปกรณ์
`abstract boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)` เหมือนกับ `ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection))` แต่ เรียกใช้การทดสอบสำหรับผู้ใช้ที่ระบุ
`abstract boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` เหมือนกับ `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)` แต่จะเรียกใช้การทดสอบสำหรับผู้ใช้ที่ระบุ
`abstract void`	`setDate(Date date)` ตั้งวันที่ในอุปกรณ์ หมายเหตุ: การตั้งค่าวันที่ในอุปกรณ์ต้องใช้สิทธิ์รูท
`abstract void`	`setOptions(TestDeviceOptions options)` ตั้งค่า `TestDeviceOptions` สำหรับอุปกรณ์
`abstract boolean`	`setProperty(String propKey, String propValue)` ตั้งค่าพร็อพเพอร์ตี้ที่ระบุในอุปกรณ์
`abstract void`	`setRecovery(IDeviceRecovery recovery)` ตั้งค่า `IDeviceRecovery` ที่จะใช้สำหรับอุปกรณ์นี้
`abstract void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` ตั้งค่าโหมดการกู้คืนปัจจุบันที่จะใช้กับอุปกรณ์
`abstract void`	`setTrackingSerial(String trackingSerial)` เพื่อวัตถุประสงค์ในการจัดการอุปกรณ์ ให้ติดตามหมายเลขซีเรียลที่เราใช้เพื่ออ้างอิงอุปกรณ์
`abstract void`	`setUseFastbootErase(boolean useFastbootErase)` ตั้งค่าว่าจะใช้ fastboot erase หรือ fastboot format เพื่อล้างพาร์ติชันในอุปกรณ์หรือไม่
`abstract void`	`startLogcat()` เริ่มบันทึกเอาต์พุต Logcat จากอุปกรณ์ในเบื้องหลัง
`abstract boolean`	`startTradeInModeTesting(int timeoutMs)` เปิดใช้โหมดทดสอบการแลกรับข้อเสนอ
`abstract void`	`stopEmulatorOutput()` ปิดและลบเอาต์พุตของโปรแกรมจำลอง
`abstract void`	`stopLogcat()` หยุดการบันทึกเอาต์พุต Logcat จากอุปกรณ์ และทิ้งข้อมูล Logcat ที่บันทึกไว้ในปัจจุบัน
`abstract void`	`stopTradeInModeTesting()` หยุดการทดสอบโหมดแลกซื้อเครื่องใหม่
`abstract String`	`switchToAdbTcp()` เปลี่ยนอุปกรณ์เป็นโหมด adb-over-tcp
`abstract boolean`	`switchToAdbUsb()` เปลี่ยนอุปกรณ์เป็นโหมด adb ผ่าน USB
`abstract boolean`	`syncFiles(File localFileDir, String deviceFilePath)` ซิงค์เนื้อหาของไดเรกทอรีไฟล์ในเครื่องกับอุปกรณ์ทีละรายการ
`abstract boolean`	`unlockDevice()` ปลดล็อกอุปกรณ์หากอุปกรณ์อยู่ในสถานะที่เข้ารหัส
`abstract void`	`unmountDebugfs()` ยกเลิกการเชื่อมต่อ debugfs
`abstract boolean`	`waitForBootComplete(long timeOut)` บล็อกจนกว่าจะมีการตั้งค่าสถานะการบูตอุปกรณ์เสร็จสมบูรณ์
`abstract boolean`	`waitForDeviceAvailable()` รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ
`abstract boolean`	`waitForDeviceAvailable(long waitTime)` รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ
`abstract boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` รอให้อุปกรณ์ตอบสนองและพร้อมใช้งานโดยไม่พิจารณาเส้นทางการกู้คืน
`abstract void`	`waitForDeviceBootloader()` บล็อกจนกว่าอุปกรณ์จะมองเห็นผ่าน fastboot
`abstract boolean`	`waitForDeviceInRecovery(long waitTime)` บล็อกไม่ให้อุปกรณ์อยู่ในสถานะ "การกู้คืน adb" (โปรดทราบว่าสถานะนี้แตกต่างจาก `IDeviceRecovery`)
`abstract boolean`	`waitForDeviceInSideload(long waitTime)` บล็อกไม่ให้อุปกรณ์อยู่ในสถานะ "adb sideload"
`abstract boolean`	`waitForDeviceNotAvailable(long waitTime)` บล็อกไม่ให้อุปกรณ์พร้อมใช้งาน เช่น ไม่มีใน adb
`abstract void`	`waitForDeviceOnline()` บล็อกจนกว่าอุปกรณ์จะมองเห็นผ่าน adb
`abstract void`	`waitForDeviceOnline(long waitTime)` บล็อกจนกว่าอุปกรณ์จะมองเห็นผ่าน adb
`abstract boolean`	`waitForDeviceShell(long waitTime)` รอให้อุปกรณ์ตอบสนองต่อคำสั่ง adb shell พื้นฐาน

ค่าคงที่

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

ค่าเริ่มต้นเมื่อตรวจหาระดับ API ไม่ได้

ค่าคงที่ -1 (0xffffffff)

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

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

clearLogcat

public abstract void clearLogcat ()

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath)

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

การขว้าง
`RuntimeException`	หากอุปกรณ์มีเหตุผลในการบูตที่ผิดปกติ
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

การขว้าง
`RuntimeException`	หากอุปกรณ์มีเหตุผลในการบูตที่ผิดปกติ
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableAdbRoot

public abstract boolean disableAdbRoot ()

ปิดรูท adb

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

คิกรีเทิร์น
`boolean`	`true` หากสำเร็จ

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

คิกรีเทิร์น
`boolean`	`true` หากสำเร็จ

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeAdbCommand

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

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeAdbCommand

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                 envMap, 
                String... commandArgs)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeAdbV2Command

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeFastbootCommand

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

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeLongFastbootCommand

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

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeShellCommand

public abstract String executeShellCommand (String command)

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

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

คิกรีเทิร์น
`String`	เอาต์พุตของเชลล์

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeShellCommand

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

ดูเพิ่มเติม:

executeShellCommand

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

ดูเพิ่มเติม:

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

คิกรีเทิร์น
`CommandResult`	ผลการค้นหาในภาษา`CommandResult`

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

คิกรีเทิร์น
`CommandResult`	ผลการค้นหาในภาษา`CommandResult`

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

คิกรีเทิร์น
`CommandResult`	ผลการค้นหาในภาษา`CommandResult`

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

executeShellV2Command

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

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

คิกรีเทิร์น
`CommandResult`

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

ดูเพิ่มเติม:

executeShellV2Command

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

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

คิกรีเทิร์น
`CommandResult`

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

ดูเพิ่มเติม:

executeShellV2Command

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

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

คิกรีเทิร์น
`CommandResult`

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

ดูเพิ่มเติม:

executeShellV2Command

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

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

คิกรีเทิร์น
`CommandResult`

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

ดูเพิ่มเติม:

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

วิธีการช่วยล้างพาร์ติชันสำหรับอุปกรณ์

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getApiLevel

public abstract int getApiLevel ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายและกู้คืนไม่ได้

getBattery

public abstract Integer getBattery ()

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

คิกรีเทิร์น
`Integer`

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

แสดงค่าบูลีนของพร็อพเพอร์ตี้ที่ระบุ

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

คิกรีเทิร์น
`boolean`	`true` หากพร็อพเพอร์ตี้มีค่า `"1"`, `"y"`, `"yes"`, `"on"` หรือ `"true"`, `false` หากพร็อพเพอร์ตี้มีค่า `"0"`, `"n"`, `"no"`, `"off"`, `"false"` หรือ `defaultValue` มิฉะนั้น

การขว้าง
`DeviceNotAvailableException`

getBootHistory

public abstract  getBootHistory ()

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

คิกรีเทิร์น
	แผนที่ของเวลาบูต (เวลา UTC เป็นวินาทีนับตั้งแต่ Epoch) และเหตุผลในการบูต

การขว้าง
`DeviceNotAvailableException`

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

คิกรีเทิร์น
	แผนที่ของเวลาบูต (เวลา UTC เป็นวินาทีนับตั้งแต่ Epoch) และเหตุผลในการบูต

การขว้าง
`DeviceNotAvailableException`

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildId

public abstract String getBuildId ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

คิกรีเทิร์น
`DeviceDescriptor`

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

คิกรีเทิร์น
`DeviceDescriptor`

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getConnection

public abstract AbstractConnection getConnection ()

แสดงผลการเชื่อมต่อที่เชื่อมโยงกับอุปกรณ์

คิกรีเทิร์น
`AbstractConnection`

getDeviceClass

public abstract String getDeviceClass ()

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

คิกรีเทิร์น
`String`	`String` คลาสอุปกรณ์

getDeviceDate

public abstract long getDeviceDate ()

แสดงผลวันที่ของอุปกรณ์เป็นมิลลิวินาทีตั้งแต่ Epoch

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

คิกรีเทิร์น
`DeviceDescriptor`

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

คิกรีเทิร์น
`DeviceDescriptor`

getDeviceState

public abstract TestDeviceState getDeviceState ()

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

คิกรีเทิร์น
`TestDeviceState`

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

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

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

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

การขว้าง
`DeviceNotAvailableException`

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

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

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

คิกรีเทิร์น
`long`	ปริมาณพื้นที่ว่างในหน่วย KB

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

คิกรีเทิร์น
`String`	`String` ชื่อประเภทผลิตภัณฑ์หรือ `null` หากระบุไม่ได้

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

คิกรีเทิร์น
`String`	`String` ชื่อประเภทผลิตภัณฑ์หรือ `null` หากระบุไม่ได้

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

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

คิกรีเทิร์น
`String`

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

การขว้าง
	UnsupportedOperationException
`DeviceNotAvailableException`

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getIDevice

public abstract IDevice getIDevice ()

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

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

คิกรีเทิร์น
`IDevice`	`IDevice`

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

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

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

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

การขว้าง
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

คิกรีเทิร์น
`long`

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getLogcat

public abstract InputStreamSource getLogcat ()

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

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

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

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

คิกรีเทิร์น
`InputStreamSource`

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

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

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

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

คิกรีเทิร์น
`InputStreamSource`

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

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

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

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

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

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

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

คิกรีเทิร์น
`InputStreamSource`

getMountPoint

public abstract String getMountPoint (String mountName)

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

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

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

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

คิกรีเทิร์น
`String`	จุดต่อเชื่อมหรือ `null`

ดูเพิ่มเติม:

IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

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

คิกรีเทิร์น
`ITestDevice.MountPointInfo`	`ERROR(/List)` ของ `MountPointInfo` ที่มีข้อมูลใน "/proc/mounts"

การขว้าง
`DeviceNotAvailableException`

ดูเพิ่มเติม:

getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

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

คิกรีเทิร์น
	`ERROR(/List)` ของ `MountPointInfo` ที่มีข้อมูลใน "/proc/mounts"

การขว้าง
`DeviceNotAvailableException`

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

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

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

คิกรีเทิร์น
`long`	ปริมาณพื้นที่ว่างในหน่วย KB

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

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

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

คิกรีเทิร์น
`ProcessInfo`	ProcessInfo ของ processName ที่ระบุ

การขว้าง
`DeviceNotAvailableException`

getProcessPid

public abstract String getProcessPid (String process)

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

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

คิกรีเทิร์น
`String`

การขว้าง
`DeviceNotAvailableException`

getProductType

public abstract String getProductType ()

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

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

คิกรีเทิร์น
`String`	`String`ชื่อประเภทผลิตภัณฑ์ จะไม่เป็นค่าว่าง

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายและกู้คืนไม่ได้ หรือหากระบุประเภทผลิตภัณฑ์ไม่ได้

getProductVariant

public abstract String getProductVariant ()

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

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

คิกรีเทิร์น
`String`	`String`ชื่อผลิตภัณฑ์ย่อยหรือ `null` หากระบุไม่ได้

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getProperty

public abstract String getProperty (String name)

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

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

getSerialNumber

public abstract String getSerialNumber ()

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

คิกรีเทิร์น
`String`	`String` หมายเลขซีเรียล

getTombstones

public abstract  getTombstones ()

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

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

คิกรีเทิร์น
	รายการไฟล์หลุมศพ ซึ่งจะว่างเปล่าหากไม่มีไฟล์หลุมศพ

การขว้าง
`DeviceNotAvailableException`

ดูเพิ่มเติม:

เอกสารประกอบเกี่ยวกับ Tombstone

getTotalMemory

public abstract long getTotalMemory ()

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

คิกรีเทิร์น
`long`

getTrackingSerial

public String getTrackingSerial ()

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

คิกรีเทิร์น
`String`

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

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

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

ดูเพิ่มเติม:

fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

คิกรีเทิร์น
`boolean`	`true` หากอุปกรณ์มีการรูท adb อยู่ `false` มิฉะนั้น

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

isAdbTcp

public abstract boolean isAdbTcp ()

คิกรีเทิร์น
`boolean`	`true` หากอุปกรณ์เชื่อมต่อกับ adb-over-tcp `false` มิฉะนั้น

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

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

คิกรีเทิร์น
`boolean`	เป็นจริงหากระบบรองรับการแจงนับแอป เป็นเท็จในกรณีอื่นๆ

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

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

คิกรีเทิร์น
`boolean`	`true` หากมีการติดตั้ง debugfs

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

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

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

คิกรีเทิร์น
`boolean`

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isExecutable

public abstract boolean isExecutable (String fullPath)

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

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

คิกรีเทิร์น
`boolean`

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isHeadless

public abstract boolean isHeadless ()

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

คิกรีเทิร์น
`boolean`

การขว้าง
`DeviceNotAvailableException`

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

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

คิกรีเทิร์น
`boolean`

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

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

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

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

การขว้าง
`DeviceNotAvailableException`

logOnDevice

public abstract 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 abstract void mountDebugfs ()

เมานต์ debugfs

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

nonBlockingReboot

public abstract void nonBlockingReboot ()

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postBootSetup

public abstract void postBootSetup ()

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

postInvocationTearDown

public void postInvocationTearDown ()

เลิกใช้เมธอดนี้แล้ว
โปรดใช้ postInvocationTearDown(Throwable) แทน

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

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

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

preInvocationSetup

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

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

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

การขว้าง
	com.android.tradefed.targetprep.TargetSetupError
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pullDir

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pullFile

public abstract File pullFile (String remoteFilePath)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pullFile

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

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

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

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

การขว้าง
`DeviceNotAvailableException`

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                int userId)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushDir

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushFile

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                int userId)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

รีบูต

public abstract void reboot ()

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

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

การขว้าง
`DeviceNotAvailableException`	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

รีบูต

public abstract void reboot (String reason)

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

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

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

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

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

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

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

การขว้าง
`DeviceNotAvailableException`	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

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

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

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

การขว้าง
`DeviceNotAvailableException`	หากอุปกรณ์ไม่ได้อยู่ในโหมด Sideload หลังจากรีบูต

rebootIntoSideload

public abstract void rebootIntoSideload ()

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

การขว้าง
`DeviceNotAvailableException`	หากอุปกรณ์ไม่ได้อยู่ในโหมด Sideload หลังจากรีบูต

รีบูตจนกว่าจะออนไลน์

public abstract void rebootUntilOnline ()

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

การขว้าง
`DeviceNotAvailableException`	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

รีบูตจนกว่าจะออนไลน์

public abstract void rebootUntilOnline (String reason)

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

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

การขว้าง
`DeviceNotAvailableException`	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

ดูเพิ่มเติม:

reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

รีบูตเฉพาะส่วน Userspace ของอุปกรณ์

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

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

การขว้าง
`DeviceNotAvailableException`	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

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

การขว้าง
`DeviceNotAvailableException`	หากอุปกรณ์ไม่พร้อมใช้งานหลังจากรีบูต

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

remountSystemWritable

public abstract void remountSystemWritable ()

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

remountVendorWritable

public abstract void remountVendorWritable ()

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

runInstrumentationTests

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

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

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

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

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

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

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

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

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

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

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

runInstrumentationTestsAsUser

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

เหมือนกับ ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) แต่ เรียกใช้การทดสอบสำหรับผู้ใช้ที่ระบุ

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

คิกรีเทิร์น
`boolean`

การขว้าง
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

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

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

คิกรีเทิร์น
`boolean`

การขว้าง
`DeviceNotAvailableException`

setDate

public abstract void setDate (Date date)

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

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setOptions

public abstract void setOptions (TestDeviceOptions options)

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

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

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

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

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

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

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

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

setTrackingSerial

public abstract void setTrackingSerial (String trackingSerial)

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

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

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

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

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

ดูเพิ่มเติม:

fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

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

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

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

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

startTradeInModeTesting

public abstract boolean startTradeInModeTesting (int timeoutMs)

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

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

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

stopLogcat

public abstract void stopLogcat ()

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

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

stopTradeInModeTesting

public abstract void stopTradeInModeTesting ()

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

switchToAdbTcp

public abstract String switchToAdbTcp ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

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

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

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

syncFiles

public abstract 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`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

ปลดล็อกอุปกรณ์

public abstract boolean unlockDevice ()

ปลดล็อกอุปกรณ์หากอุปกรณ์อยู่ในสถานะที่เข้ารหัส

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

คิกรีเทิร์น
`boolean`	`true` หากสำเร็จหรือหากอุปกรณ์ไม่ได้เข้ารหัส

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้
`UnsupportedOperationException`	หากอุปกรณ์ไม่รองรับการเข้ารหัส

unmountDebugfs

public abstract void unmountDebugfs ()

ยกเลิกการเชื่อมต่อ debugfs

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

บล็อกจนกว่าจะมีการตั้งค่าสถานะการบูตอุปกรณ์เสร็จสมบูรณ์

พารามิเตอร์
`timeOut`	`long`: เวลาเป็นมิลลิวินาทีที่รอให้ตั้งค่า Flag

คิกรีเทิร์น
`boolean`	จริง หากตั้งค่าสถานะการบูตของอุปกรณ์เสร็จสมบูรณ์ภายในระยะหมดเวลา

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

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

คิกรีเทิร์น
`boolean`	เป็นจริงหากอุปกรณ์พร้อมใช้งาน เป็นเท็จหากปิดใช้การกู้คืนและไม่พร้อมใช้งาน

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

คิกรีเทิร์น
`boolean`	เป็นจริงหากอุปกรณ์พร้อมใช้งาน เป็นเท็จหากปิดใช้การกู้คืนและไม่พร้อมใช้งาน

การขว้าง
`DeviceNotAvailableException`	หากอุปกรณ์ยังคงไม่ตอบสนองหลังจาก waitTime หมดอายุ

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

พารามิเตอร์
`waitTime`	`long`

คิกรีเทิร์น
`boolean`	เป็นจริงหากอุปกรณ์พร้อมใช้งาน เป็นเท็จหากไม่พร้อมใช้งาน

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

บล็อกจนกว่าอุปกรณ์จะมองเห็นผ่าน fastboot ใช้ระยะหมดเวลาเริ่มต้น

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

บล็อกไม่ให้อุปกรณ์อยู่ในสถานะ "การกู้คืน adb" (โปรดทราบว่าสถานะนี้แตกต่างจาก IDeviceRecovery)

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

คิกรีเทิร์น
`boolean`	`true` หากอุปกรณ์บูตเข้าสู่การกู้คืนก่อนเวลาหมด `false` มิฉะนั้น

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

บล็อกไม่ให้อุปกรณ์อยู่ในสถานะ "adb sideload"

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

คิกรีเทิร์น
`boolean`	`true` หากอุปกรณ์บูตเข้าสู่การโหลดจากแหล่งที่ไม่รู้จักก่อนเวลาหมดอายุ `false` มิฉะนั้น

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

บล็อกไม่ให้อุปกรณ์พร้อมใช้งาน เช่น ไม่มีใน adb

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

คิกรีเทิร์น
`boolean`	`true` หากอุปกรณ์ไม่พร้อมใช้งานก่อนเวลาหมดอายุ `false` มิฉะนั้น

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

บล็อกจนกว่าอุปกรณ์จะมองเห็นผ่าน adb ใช้ระยะหมดเวลาเริ่มต้น

โปรดทราบว่าอุปกรณ์อาจไม่ตอบสนองต่อคำสั่งเมื่อดำเนินการเสร็จสมบูรณ์ โปรดใช้ waitForDeviceAvailable() แทน

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

บล็อกจนกว่าอุปกรณ์จะมองเห็นผ่าน adb

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

การขว้าง
`DeviceNotAvailableException`	หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

รอให้อุปกรณ์ตอบสนองต่อคำสั่ง adb shell พื้นฐาน

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

คิกรีเทิร์น
`boolean`	`true` หากอุปกรณ์ตอบสนองก่อนที่ `waitTime` จะหมดเวลา