อุปกรณ์ที่มาพร้อมเครื่อง

public class NativeDevice
extends Object implements IManagedTestDevice, IConfigurationReceiver, ITestLoggerReceiver

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

คลาสย่อยโดยตรงที่รู้จัก อุปกรณ์ทดสอบ อุปกรณ์ทดสอบ การใช้ ITestDevice สำหรับอุปกรณ์ Android ทั้งสแต็ก

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

---

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

สรุป

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

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

ช่อง
public static final String	DEBUGFS_PATH
protected static final String	SD_CARD
protected static final String	STORAGE_EMULATED
protected TestDeviceOptions	mOptions
protected final IDeviceStateMonitor	mStateMonitor

ช่างก่อสร้างสาธารณะ
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor) สร้าง TestDevice

วิธีการสาธารณะ
void	batchPrefetchStartupBuildProps() การเพิ่มประสิทธิภาพย่อย (ประมาณ 400 มิลลิวินาที) โดยการดึงข้อมูลอุปกรณ์ประกอบทั้งหมดที่เราต้องการแทนการเรียกใช้ "adb getprop" สำหรับแต่ละรายการ
boolean	canSwitchToHeadlessSystemUser() แสดงผลว่าจะอนุญาตให้เปลี่ยนไปใช้ผู้ใช้ SYSTEM แบบไม่มีส่วนหัวหรือไม่
boolean	checkApiLevelAgainstNextRelease(int strictMinLevel) ตรวจสอบว่าปัจจุบันมีฟีเจอร์ที่ได้รับการสนับสนุนในระดับที่สนับสนุนน้อยที่สุดหรือไม่
boolean	checkConnectivity() ตรวจสอบว่าอุปกรณ์มีการเชื่อมต่อเครือข่าย
boolean	clearErrorDialogs() พยายามปิดกล่องโต้ตอบข้อผิดพลาดใดๆ ที่แสดงอยู่ใน UI ของอุปกรณ์
void	clearLastConnectedWifiNetwork() ล้างเครือข่าย Wi-Fi ที่เชื่อมต่อล่าสุด
void	clearLogcat() ลบข้อมูล Logcat ที่รวบรวมไว้
boolean	connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid) เชื่อมต่อกับเครือข่าย Wi-Fi
boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk) เชื่อมต่อกับเครือข่าย Wi-Fi
boolean	connectToWifiNetwork( wifiSsidToPsk) เชื่อมต่อกับเครือข่าย Wi-Fi
boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid) เชื่อมต่อกับเครือข่าย Wi-Fi
boolean	connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid) ตัวแปรของ connectToWifiNetwork(String, String) ที่จะเชื่อมต่อเฉพาะเมื่ออุปกรณ์ไม่มีการเชื่อมต่อเครือข่ายในขณะนี้
boolean	connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk) ตัวแปรของ connectToWifiNetwork(String, String) ที่จะเชื่อมต่อเฉพาะเมื่ออุปกรณ์ไม่มีการเชื่อมต่อเครือข่ายในขณะนี้
int	createUser(String name, boolean guest, boolean ephemeral) สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ระบุ
int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ระบุ
int	createUser(String name) สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0
int	createUserNoThrow(String name) สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0
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) เมธอดของตัวช่วยในการตรวจสอบว่าอุปกรณ์เริ่มใหม่แบบชั่วคราวหรือไม่ตั้งแต่เวลา UTC ตั้งแต่ Epoch จากอุปกรณ์และ ERROR(/TimeUnit)
boolean	disableAdbRoot() ปิดราก adb
void	disableKeyguard() ความพยายามปิดใช้งานการล็อกปุ่ม
boolean	disableNetworkMonitor() ปิดใช้การตรวจสอบเครือข่ายในอุปกรณ์
boolean	disconnectFromWifi() ยกเลิกการเชื่อมต่อกับเครือข่าย Wi-Fi
boolean	doesFileExist(String deviceFilePath, int userId) เมธอดของตัวช่วยในการระบุว่าผู้ใช้หนึ่งๆ มีไฟล์อยู่ในอุปกรณ์หรือไม่
boolean	doesFileExist(String deviceFilePath) เมธอดของตัวช่วยในการตรวจสอบว่ามีไฟล์อยู่ในอุปกรณ์หรือไม่
File	dumpHeap(String process, String devicePath) พยายามดัมพ์ฮีปจาก system_server
boolean	enableAdbRoot() เปิดราก adb
boolean	enableNetworkMonitor() เปิดใช้การตรวจสอบเครือข่ายในอุปกรณ์
String	executeAdbCommand(long timeout, String... cmdArgs) เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบโดยมีระยะหมดเวลาที่ระบุไว้
String	executeAdbCommand(long timeout, envMap, String... cmdArgs) เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบโดยมีระยะหมดเวลาที่ระบุไว้
String	executeAdbCommand(String... cmdArgs) เมธอด Helper ซึ่งเรียกใช้คำสั่ง adb เป็นคำสั่งของระบบ
CommandResult	executeFastbootCommand(String... cmdArgs) เมธอด Helper ที่เรียกใช้คำสั่ง Fastboot เป็นคําสั่งระบบโดยมีระยะหมดเวลาเริ่มต้น 2 นาที
CommandResult	executeFastbootCommand(long timeout, String... cmdArgs) เมธอด Helper ที่เรียกใช้คำสั่ง Fastboot เป็นคําสั่งระบบ
CommandResult	executeLongFastbootCommand(String... cmdArgs) เมธอด Helper ซึ่งเรียกใช้คำสั่ง Fastboot ที่ใช้เวลานานเป็นคำสั่งของระบบ
CommandResult	executeLongFastbootCommand( envVarMap, String... cmdArgs) เมธอด Helper ซึ่งเรียกใช้คำสั่ง Fastboot ที่ใช้เวลานานเป็นคําสั่งของระบบพร้อมกับตัวแปรสภาพแวดล้อมของระบบ
String	executeShellCommand(String command) เมธอด Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลเอาต์พุตเป็น String
void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
void	executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
void	executeShellCommand(String command, IShellOutputReceiver receiver) เรียกใช้คำสั่งเชลล์ adb ที่กำหนด ลองใหม่หลายครั้งหากคำสั่งล้มเหลว
CommandResult	executeShellV2Command(String cmd) เมธอดของตัวช่วยที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult ซึ่งสร้างโดยมีเอาต์พุตสถานะคำสั่ง, stdout และ stderr อย่างถูกต้อง
CommandResult	executeShellV2Command(String cmd, OutputStream pipeToOutput) เมธอดของ Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult พร้อมเอาต์พุตสถานะคำสั่งและ stderr อย่างถูกต้อง
CommandResult	executeShellV2Command(String cmd, File pipeAsInput) เมธอดของตัวช่วยที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult ซึ่งสร้างโดยมีเอาต์พุตสถานะคำสั่ง, stdout และ stderr อย่างถูกต้อง
CommandResult	executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
CommandResult	executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit) เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
CommandResult	executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
CommandResult	executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts) เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
CommandResult	fastbootWipePartition(String partition) เมธอดของตัวช่วยที่จะล้างข้อมูลพาร์ติชันสำหรับอุปกรณ์
	getActiveApexes() ดึงข้อมูลเกี่ยวกับ APEX ที่เปิดใช้งานในอุปกรณ์
	getAllSettings(String namespace) แสดงผลคู่คีย์-ค่าของเนมสเปซที่ขอ
DeviceAllocationState	getAllocationState() แสดงสถานะการจัดสรรปัจจุบันของอุปกรณ์
String	getAndroidId(int userId) ค้นหาและแสดงผล android-id ที่เชื่อมโยงกับ userId หากไม่พบ
	getAndroidIds() สร้างแผนที่รหัส Android ที่พบรหัสผู้ใช้ที่ตรงกัน
int	getApiLevel() รับระดับ API ของอุปกรณ์
PackageInfo	getAppPackageInfo(String packageName) ดึงข้อมูลเกี่ยวกับแพ็กเกจที่ติดตั้งในอุปกรณ์
	getAppPackageInfos() ดึงข้อมูลของแพ็กเกจที่ติดตั้งในอุปกรณ์
String	getBasebandVersion() วิธีการที่สะดวกในการรับเวอร์ชันเบสแบนด์ (วิทยุ) ของอุปกรณ์นี้
Integer	getBattery() แสดงระดับแบตเตอรี่ปัจจุบันของอุปกรณ์หรือ Null หากไม่มีระดับแบตเตอรี่
boolean	getBooleanProperty(String name, boolean defaultValue) แสดงผลค่าบูลีนของพร็อพเพอร์ตี้ที่ระบุ
	getBootHistory() เมธอด Helper จะรวบรวมแมปประวัติการเปิดเครื่องพร้อมเวลาเปิดเครื่องและเหตุผลที่เปิดเครื่อง
	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 หรือ Null หากไม่มี
DeviceFoldableState	getCurrentFoldableState() แสดงผลสถานะปัจจุบันของอุปกรณ์หรือค่า Null หากเกิดปัญหาขึ้น
int	getCurrentUser() แสดงผล ID ของผู้ใช้ปัจจุบันที่กำลังทำงานอยู่
String	getDeviceClass() ดูคลาสของอุปกรณ์
long	getDeviceDate() แสดงวันที่ของอุปกรณ์เป็นมิลลิวินาทีตั้งแต่ Epoch
DeviceDescriptor	getDeviceDescriptor() แสดง DeviceDescriptor จากข้อมูลอุปกรณ์เพื่อรับข้อมูลโดยไม่ผ่านออบเจ็กต์อุปกรณ์จริง
DeviceDescriptor	getDeviceDescriptor(boolean shortDescriptor) แสดง DeviceDescriptor จากข้อมูลอุปกรณ์เพื่อรับข้อมูลโดยไม่ผ่านออบเจ็กต์อุปกรณ์จริง
TestDeviceState	getDeviceState() ดูสถานะของอุปกรณ์
long	getDeviceTimeOffset(Date date) ผู้ช่วยในการดูความแตกต่างของเวลาระหว่างอุปกรณ์กับ ERROR(/Date) ที่ระบุ
InputStreamSource	getEmulatorOutput() รับสตรีมโปรแกรมจำลอง stdout และ stderr
Process	getEmulatorProcess() แสดงผล Process ที่เกี่ยวข้องกับโปรแกรมจำลองนี้
final File	getExecuteShellCommandLog() บันทึกที่มีบันทึก executeShellCommand(String) ทั้งหมด
long	getExternalStoreFreeSpace() วิธีของตัวช่วยระบุปริมาณพื้นที่ว่างในที่จัดเก็บข้อมูลภายนอกของอุปกรณ์
String	getFastbootPath() แสดงผลเส้นทางของไบนารี Fastboot ที่ใช้
String	getFastbootProductType() วิธีที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้เมื่ออยู่ใน Fastboot Mode
String	getFastbootProductVariant() วิธีที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้เมื่ออยู่ใน Fastboot Mode
String	getFastbootSerialNumber() แสดงหมายเลขซีเรียล Fastboot Mode
String	getFastbootVariable(String variableName) ดึงค่าตัวแปร Fastboot ที่ระบุจากอุปกรณ์
String	getFastbootVersion() แสดงผลสตริงเวอร์ชันของไบนารี Fastboot ที่ใช้
IFileEntry	getFileEntry(String path) ดึงข้อมูลการอ้างอิงไปยังไฟล์ระยะไกลในอุปกรณ์
IFileEntry	getFileEntry(FileListingService.FileEntry entry) ผู้ช่วยอย่างไม่เป็นทางการในการรับ FileEntry จากเส้นทางที่ไม่ใช่รูท
	getFoldableStates() แสดงรายการสถานะพับได้ในอุปกรณ์
IDevice	getIDevice() แสดงผลการอ้างอิงไปยัง IDevice ddmlib ที่เกี่ยวข้อง
	getInstalledPackageNames() ดึงข้อมูลชื่อแพ็กเกจของแอปพลิเคชันที่มีอยู่ในอุปกรณ์
long	getIntProperty(String name, long defaultValue) แสดงผลค่าจำนวนเต็มของคุณสมบัติที่ระบุจากอุปกรณ์
String	getIpAddress() รับที่อยู่ IP ของอุปกรณ์
KeyguardControllerState	getKeyguardState() แสดงผลออบเจ็กต์เพื่อรับสถานะปัจจุบันของคีย์การ์ดหรือ Null หากไม่รองรับ
long	getLastExpectedRebootTimeMillis() แสดงผลเวลาล่าสุดที่ Tradefed API ที่ทริกเกอร์การรีบูตในหน่วยมิลลิวินาทีตั้งแต่ EPOCH ที่แสดงผลโดย System.currentTimeMillis()
int	getLaunchApiLevel() รับระดับ API ที่เปิดใช้งานครั้งแรกของอุปกรณ์
InputStreamSource	getLogcat() ดึงสตรีมสแนปชอตของข้อมูล Logcat
InputStreamSource	getLogcat(int maxBytes) จับสตรีมสแนปชอตของ maxBytes ล่าสุดของข้อมูล Logcat ที่บันทึกไว้
InputStreamSource	getLogcatDump() รับดัมพ์ของ Logcat ปัจจุบันสำหรับอุปกรณ์
InputStreamSource	getLogcatSince(long date) ดึงสตรีมสแนปชอตของข้อมูล Logcat ที่บันทึกไว้โดยเริ่มตั้งแต่วันที่ที่ระบุ
String	getMacAddress() แสดงผลที่อยู่ MAC ของอุปกรณ์ ค่าว่างในกรณีที่ค้นหาจากอุปกรณ์ไม่สำเร็จ
Integer	getMainUserId() แสดงผล User-ID หลัก
	getMainlineModuleInfo() ดูข้อมูลเกี่ยวกับโมดูลเมนไลน์ที่ติดตั้งในอุปกรณ์
int	getMaxNumberOfRunningUsersSupported() รับจำนวนผู้ใช้งานพร้อมกันที่รองรับสูงสุด
int	getMaxNumberOfUsersSupported() รับจํานวนผู้ใช้ที่รองรับสูงสุด
Process	getMicrodroidProcess()
IDeviceStateMonitor	getMonitor() ส่งคืน IDeviceStateMonitor ที่เชื่อมโยงกับอุปกรณ์
String	getMountPoint(String mountName) แสดงผลจุดต่อเชื่อม
ITestDevice.MountPointInfo	getMountPointInfo(String mountpoint) แสดงผล MountPointInfo ที่สอดคล้องกับเส้นทางจุดต่อเชื่อมที่ระบุ หรือ null หากเส้นทางนั้นไม่มีการต่อเชื่อมหรือไม่ปรากฏใน /proc/mounts เป็นจุดต่อเชื่อม
	getMountPointInfo() ส่งคืนข้อมูลเวอร์ชันแยกวิเคราะห์ใน /proc/mounts บนอุปกรณ์
TestDeviceOptions	getOptions() ดึงข้อมูลตัวเลือกการทดสอบสำหรับอุปกรณ์
long	getPartitionFreeSpace(String partition) เมธอด Helper เพื่อกำหนดพื้นที่ว่างในพาร์ติชันอุปกรณ์
Integer	getPrimaryUserId() แสดงผล User-ID หลัก
ProcessInfo	getProcessByName(String processName) เมธอด Helper จะเรียกใช้คำสั่ง "pidof" และ "stat" และแสดงผลออบเจ็กต์ ProcessInfo ที่มี PID และเวลาเริ่มต้นของการประมวลผลของกระบวนการที่ระบุ
String	getProcessPid(String process) แสดงผล PID ของบริการหรือ Null หากเกิดข้อผิดพลาด
String	getProductType() วิธีการที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้
String	getProductVariant() วิธีการที่สะดวกในการรับรายละเอียดปลีกย่อยของผลิตภัณฑ์ของอุปกรณ์นี้
String	getProperty(String name) ดึงข้อมูลค่าคุณสมบัติที่ระบุจากอุปกรณ์
ITestDevice.RecoveryMode	getRecoveryMode() รับโหมดการกู้คืนปัจจุบันที่ใช้สำหรับอุปกรณ์
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() แสดงสถานะซิมการ์ดหรือค่าว่างหากไม่มีหรืออุปกรณ์ไม่พร้อมใช้งาน
	getTombstones() ดึงข้อมูลและส่งคืนรายการ Tombstone จากอุปกรณ์ต่างๆ
long	getTotalMemory() แสดงขนาดหน่วยความจำทางกายภาพทั้งหมดเป็นไบต์หรือ -1 ในกรณีที่เกิดข้อผิดพลาดภายใน
	getUninstallablePackageNames() เรียกชื่อแพ็กเกจแอปพลิเคชันที่สามารถถอนการติดตั้งได้
boolean	getUseFastbootErase() รับว่าจะใช้รูปแบบ Fastboot Delete หรือ Fastboot เพื่อล้างข้อมูลพาร์ติชันในอุปกรณ์หรือไม่
int	getUserFlags(int userId) ค้นหาและแสดงธงของผู้ใช้ที่ต้องการ
	getUserInfos() เรียกดูแมปของ useId ไปยัง UserInfo ในอุปกรณ์
int	getUserSerialNumber(int userId) แสดงผลหมายเลขซีเรียลที่เชื่อมโยงกับ userId หากพบ ซึ่งก็คือ -10000 ในกรณีอื่นๆ
IManagedTestDevice.DeviceEventResponse	handleAllocationEvent(DeviceEvent event) ประมวลผล DeviceEvent ที่ระบุ ประมวลผล DeviceEvent ซึ่งอาจเปลี่ยนหรือไม่เปลี่ยนอุปกรณ์นี้เป็นสถานะการจัดสรรใหม่
boolean	hasFeature(String feature) ตรวจสอบว่าฟีเจอร์พร้อมใช้งานในอุปกรณ์หรือไม่
String	installPackage(File packageFile, boolean reinstall, String... extraArgs) ติดตั้งแพ็กเกจ Android ในอุปกรณ์
String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) ติดตั้งแพ็กเกจ Android ในอุปกรณ์
String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) ติดตั้งแพ็กเกจ Android ในอุปกรณ์สำหรับผู้ใช้ที่กำหนด
String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) ติดตั้งแพ็กเกจ Android ในอุปกรณ์สำหรับผู้ใช้ที่กำหนด
void	invalidatePropertyCache()
boolean	isAdbRoot()
boolean	isAdbTcp()
boolean	isAppEnumerationSupported() ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการแจกแจงแอปหรือไม่
boolean	isBypassLowTargetSdkBlockSupported() ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการข้ามการบล็อก SDK เป้าหมายต่ำในการติดตั้งแอปหรือไม่
boolean	isDebugfsMounted() ตรวจสอบว่าได้ต่อเชื่อม debugf หรือไม่
boolean	isDeviceEncrypted() แสดงผลหากอุปกรณ์เข้ารหัส
boolean	isDirectory(String path) แสดงผล "จริง" หากเส้นทางในอุปกรณ์เป็นไดเรกทอรี มิเช่นนั้นจะเป็น "เท็จ"
boolean	isEnableAdbRoot()
boolean	isEncryptionSupported() แสดงผลหากอุปกรณ์รองรับการเข้ารหัส
boolean	isExecutable(String fullPath) แสดงผลเป็น "จริง" หากเส้นทางของไฟล์ในอุปกรณ์เป็นไฟล์ปฏิบัติการ หรือเป็นเท็จ
boolean	isFastbootEnabled() แสดงผลหาก Fastboot พร้อมใช้งานสำหรับอุปกรณ์
boolean	isHeadless() แสดงผลเป็น "จริง" หากอุปกรณ์ไม่มีส่วนหัว (ไม่มีหน้าจอ) หรือเป็นเท็จ
boolean	isHeadlessSystemUserMode() แสดงผลว่าอุปกรณ์ใช้โหมดผู้ใช้ระบบแบบไม่มีส่วนหัวหรือไม่
boolean	isMainUserPermanentAdmin() จะแสดงผลว่าผู้ใช้หลักเป็นผู้ดูแลระบบแบบถาวร และจะลบหรือดาวน์เกรดเป็นสถานะที่ไม่ใช่ผู้ดูแลระบบไม่ได้
boolean	isMultiUserSupported() กำหนดว่ารองรับผู้ใช้หลายคนหรือไม่
boolean	isPackageInstalled(String packageName, String userId) ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจและรหัสผู้ใช้ที่กำหนดเพื่อตรวจสอบว่าอุปกรณ์ได้รับการติดตั้งอยู่หรือไม่สำหรับผู้ใช้รายนั้น
boolean	isPackageInstalled(String packageName) ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจที่ระบุเพื่อตรวจสอบว่าอุปกรณ์ติดตั้งอยู่หรือไม่
boolean	isRuntimePermissionSupported() ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการให้สิทธิ์รันไทม์หรือไม่
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 อยู่หรือไม่
	listDisplayIds() รวบรวมรายการรหัสแสดงที่มีอยู่ในอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger"
	listDisplayIdsForStartingVisibleBackgroundUsers() รับรายการจอแสดงผลที่ใช้เพื่อstart a user visible in the backgroundได้
	listUsers() รับรายชื่อผู้ใช้ในอุปกรณ์
boolean	logAnrs(ITestLogger logger) รวบรวมและบันทึก ANR จากอุปกรณ์
boolean	logBugreport(String dataName, ITestLogger listener) วิธีการของตัวช่วยในการรับรายงานข้อบกพร่องและบันทึกรายงานให้ผู้รายงาน
void	logOnDevice(String tag, Log.LogLevel level, String format, Object... args) บันทึกข้อความใน Logcat ของอุปกรณ์
void	mountDebugfs() ต่อเชื่อม debugf
void	nonBlockingReboot() ออกคำสั่งให้รีบูตอุปกรณ์และส่งคืนเมื่อคำสั่งเสร็จสมบูรณ์ และเมื่ออุปกรณ์ไม่แสดงต่อ adb อีกต่อไป
void	postAdbRootAction() ลบล้างในกรณีที่อุปกรณ์ต้องดำเนินการบางอย่างหลังจากรูท adb และก่อนที่อุปกรณ์จะออนไลน์อีกครั้ง
void	postAdbUnrootAction() ลบล้างในกรณีที่อุปกรณ์จำเป็นต้องดำเนินการบางอย่างหลังจากยกเลิกการรูทและก่อนที่อุปกรณ์จะออนไลน์อีกครั้ง
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	pullFile(String remoteFilePath, File localFile) ดึงข้อมูลไฟล์ออกจากอุปกรณ์
File	pullFile(String remoteFilePath, int userId) เรียกดูไฟล์จากอุปกรณ์ จัดเก็บไว้ใน ERROR(/File) ชั่วคราวในเครื่อง และส่งคืน File นั้น
File	pullFile(String remoteFilePath) เรียกดูไฟล์จากอุปกรณ์ จัดเก็บไว้ใน ERROR(/File) ชั่วคราวในเครื่อง และส่งคืน File นั้น
boolean	pullFile(String remoteFilePath, File localFile, int userId) ดึงข้อมูลไฟล์ออกจากอุปกรณ์
String	pullFileContents(String remoteFilePath) ดึงไฟล์ออกจากอุปกรณ์ และแสดงเนื้อหา
File	pullFileFromExternal(String remoteFilePath) วิธีที่สะดวกในการดึงข้อมูลไฟล์จากพื้นที่เก็บข้อมูลภายนอกของอุปกรณ์ จัดเก็บไฟล์ไว้ใน ERROR(/File) ชั่วคราวในเครื่อง และส่งกลับการอ้างอิงไปยัง File นั้น
boolean	pushDir(File localFileDir, String deviceFilePath, excludedDirectories) พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์ซ้ำๆ ขณะที่ยกเว้นบางไดเรกทอรีที่มีการกรอง
boolean	pushDir(File localFileDir, String deviceFilePath) พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์ซ้ำ
boolean	pushDir(File localFileDir, String deviceFilePath, int userId) พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์ซ้ำ
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 ที่ให้ไว้เพื่อให้คงอยู่ตลอดในการรีบูต
void	reboot() รีบูตอุปกรณ์ให้เข้าสู่โหมด adb
void	rebootIntoBootloader() รีบูตอุปกรณ์ให้เข้าสู่โหมด Bootloader
void	rebootIntoFastbootd() รีบูตอุปกรณ์ให้เข้าสู่ Fastbootd Mode
void	rebootIntoRecovery() รีบูตอุปกรณ์ให้เข้าสู่โหมดการกู้คืน adb
void	rebootIntoSideload() รีบูตอุปกรณ์ให้เข้าสู่โหมด adb Sideload (โปรดทราบว่านี่เป็นโหมดพิเศษที่อยู่ภายใต้การกู้คืน) บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดโหลดจากแหล่งที่ไม่รู้จัก
void	rebootIntoSideload(boolean autoReboot) รีบูตอุปกรณ์ให้เข้าสู่โหมด adb Sideload (โปรดทราบว่านี่เป็นโหมดพิเศษที่อยู่ภายใต้การกู้คืน) บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดโหลดจากแหล่งที่ไม่รู้จัก
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, ITestLifeCycleReceiver... listeners) วิธีการที่สะดวกในการทำ ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) ที่มี Listener อย่างน้อย 1 รายการที่ส่งผ่านเป็นพารามิเตอร์
boolean	runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners) ทดสอบการใช้เครื่องมือและกู้คืนอุปกรณ์
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)) แต่เรียกใช้การทดสอบสำหรับผู้ใช้ที่ระบุ
boolean	runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) เหมือนกับ ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) แต่ทำการทดสอบสำหรับผู้ใช้ที่ระบุ
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	setUseFastbootErase(boolean useFastbootErase) ตั้งค่าว่าจะใช้รูปแบบ Fastboot หากต้องการลบหรือ Fastboot เพื่อล้างข้อมูลพาร์ติชันในอุปกรณ์
void	startLogcat() เริ่มบันทึกเอาต์พุต Logcat จากอุปกรณ์ในเบื้องหลัง
boolean	startUser(int userId) เริ่มต้นผู้ใช้หนึ่งๆ ในพื้นหลังหากหยุดทำงานอยู่
boolean	startUser(int userId, boolean waitFlag) เริ่มต้นผู้ใช้หนึ่งๆ ในพื้นหลังหากหยุดทำงานอยู่
boolean	startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag) เริ่มใช้งานผู้ใช้ที่กำหนดในเบื้องหลัง ซึ่งมองเห็นได้ในจอแสดงผลที่กำหนด (ซึ่งอนุญาตให้ผู้ใช้เปิดกิจกรรมในจอแสดงผลนั้น)
void	stopEmulatorOutput() ปิดและลบเอาต์พุตของโปรแกรมจำลอง
void	stopLogcat() หยุดบันทึกเอาต์พุต Logcat จากอุปกรณ์และทิ้งข้อมูล Logcat ที่บันทึกไว้ในปัจจุบัน
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) เปลี่ยนไปใช้รหัสผู้ใช้อื่นโดยกำหนดระยะหมดเวลาที่กำหนดไว้เป็นกำหนดเวลา
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() ยกเลิกการต่อเชื่อม debugf
boolean	waitForBootComplete(long timeOut) บล็อกจนกว่าจะมีการตั้งค่าสถานะการเปิดเครื่องของอุปกรณ์เสร็จสมบูรณ์
boolean	waitForDeviceAvailable() รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ
boolean	waitForDeviceAvailable(long waitTime) รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ
boolean	waitForDeviceAvailableInRecoverPath(long waitTime) รอให้อุปกรณ์ตอบสนองและพร้อมใช้งานโดยไม่คำนึงถึงเส้นทางการกู้คืน
void	waitForDeviceBootloader() บล็อกจนกว่าอุปกรณ์จะมองเห็นได้ผ่าน Fastboot
boolean	waitForDeviceInRecovery(long waitTime) การบล็อกสำหรับอุปกรณ์ให้อยู่ในสถานะ "การกู้คืน adb" (โปรดทราบว่าจะแตกต่างจาก IDeviceRecovery)
boolean	waitForDeviceInSideload(long waitTime) การบล็อกสำหรับอุปกรณ์ให้อยู่ในสถานะ "adb ไซด์โหลด"
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) สร้างคำสั่งระบบปฏิบัติการสำหรับเซสชันคำสั่งเชลล์ adb และอาร์กิวเมนต์ที่ระบุ
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() เมธอด Helper ในการส่งข้อยกเว้นหากไม่รองรับสิทธิ์รันไทม์
int	getApiLevelSafe()
ITestLogger	getLogger()
IRunUtil	getRunUtil() รับอินสแตนซ์ RunUtil เพื่อใช้งาน
void	initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
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() การดำเนินการเพิ่มเติมที่อาจทำได้หลังจากการรีบูต
void	prePostBootSetup() อนุญาตให้อุปกรณ์แต่ละประเภท (AndroidNativeDevice, TestDevice) ลบล้างเมธอดนี้สำหรับ การตั้งค่าหลังการเปิดเครื่องที่เจาะจง
boolean	pullFileInternal(String remoteFilePath, File localFile)
void	setClock(Clock clock) ตั้งค่าอินสแตนซ์ของนาฬิกาที่จะใช้
void	setMicrodroidProcess(Process process) ทำเครื่องหมาย TestDevice เป็น Microdroid และกำหนด CID
void	setTestDeviceOptions( deviceOptions)
CommandResult	simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd) เรียกใช้คำสั่ง Fastboot ง่ายๆ กับตัวแปรสภาพแวดล้อมและรายงานสถานะของคําสั่ง
CommandResult	simpleFastbootCommand(long timeout, String[] fullCmd) เรียกใช้คำสั่ง Fastboot ง่ายๆ และรายงานสถานะของคําสั่ง
boolean	waitForDeviceNotAvailable(String operationDesc, long time) รอดูว่าอุปกรณ์ไม่พร้อมใช้งาน (หยุดการรายงานไปยัง adb)

ค่าคงที่

รหัสผู้ใช้ไม่ถูกต้อง

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)

ช่อง

DEBUGFS_PATH

public static final String DEBUGFS_PATH

การ์ด SD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

ตัวเลือก

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

ช่างก่อสร้างสาธารณะ

อุปกรณ์ที่มาพร้อมเครื่อง

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

สร้าง TestDevice

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

วิธีการสาธารณะ

BundlePrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

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

ผู้ใช้ระบบเปลี่ยนส่วนหัวได้

public boolean canSwitchToHeadlessSystemUser ()

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

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

การขว้าง
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

ตรวจสอบว่าปัจจุบันมีฟีเจอร์ที่ได้รับการสนับสนุนในระดับที่สนับสนุนน้อยที่สุดหรือไม่ เมธอดนี้จะคํานึงถึงฟีเจอร์ที่ยังไม่ได้เปิดตัวก่อนที่จะเพิ่มระดับ API

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

คิกรีเทิร์น
boolean	เป็นจริงหากระบบรองรับระดับ เป็นเท็จ

การขว้าง
DeviceNotAvailableException

ตรวจสอบการเชื่อมต่อ

public boolean checkConnectivity ()

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

คิกรีเทิร์น
boolean	true หากอุปกรณ์มีการเชื่อมต่อเครือข่ายที่ใช้งานได้ ให้falseข้ามด้าน

การขว้าง
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

การขว้าง
DeviceNotAvailableException

ล้างเครือข่าย Wi-Fi ที่เชื่อมต่อล่าสุด

public void clearLastConnectedWifiNetwork ()

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

clearLogcat

public void clearLogcat ()

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

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

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

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

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

คิกรีเทิร์น
boolean	true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ อีก false

การขว้าง
DeviceNotAvailableException

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

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

พารามิเตอร์
wifiSsid	String: SSD ของ Wi-Fi ที่จะเชื่อมต่อ
wifiPsk	String: รหัสผ่าน PSK หรือค่าว่างหากไม่มีการเข้ารหัส

คิกรีเทิร์น
boolean	true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ อีก false

การขว้าง
DeviceNotAvailableException

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

public boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

พารามิเตอร์
wifiSsidToPsk	: แมป SSID ของ Wi-Fi กับรหัสผ่าน

คิกรีเทิร์น
boolean	true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ อีก false

การขว้าง
DeviceNotAvailableException

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

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

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

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

คิกรีเทิร์น
boolean	true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ อีก false

การขว้าง
DeviceNotAvailableException

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

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

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

คิกรีเทิร์น
boolean	true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ อีก false

การขว้าง
DeviceNotAvailableException

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

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

คิกรีเทิร์น
boolean	true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ อีก false

การขว้าง
DeviceNotAvailableException

สร้างผู้ใช้

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

สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ระบุ

พารามิเตอร์
name	String: ของผู้ใช้ที่จะสร้างในอุปกรณ์
guest	boolean: เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --ผู้ใช้ชั่วคราวระหว่างการสร้าง
ephemeral	boolean: เปิดใช้การตั้งค่าสถานะผู้ใช้ -- ชั่วคราวระหว่างการสร้าง

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

การขว้าง
DeviceNotAvailableException

สร้างผู้ใช้

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

สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ระบุ

พารามิเตอร์
name	String: ของผู้ใช้ที่จะสร้างในอุปกรณ์
guest	boolean: เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --ผู้ใช้ชั่วคราวระหว่างการสร้าง
ephemeral	boolean: เปิดใช้การตั้งค่าสถานะผู้ใช้ -- ชั่วคราวระหว่างการสร้าง
forTesting	boolean: เปิดใช้ Test Flag --สำหรับการทดสอบระหว่างการสร้าง

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

การขว้าง
DeviceNotAvailableException

สร้างผู้ใช้

public int createUser (String name)

สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0

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

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

การขว้าง
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0

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

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

การขว้าง
DeviceNotAvailableException

ลบไฟล์

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

การขว้าง
DeviceNotAvailableException

ลบไฟล์

public void deleteFile (String deviceFilePath)

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

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

การขว้าง
DeviceNotAvailableException

ยกเลิกการลงทะเบียนอุปกรณ์การดำเนินการรับ

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

พารามิเตอร์
deviceActionReceiver	IDeviceActionReceiver: IDeviceActionReceiver ที่จะถูกนำออก

อุปกรณ์ที่ซอฟต์รีสตาร์ท

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

คิกรีเทิร์น
boolean	true หากรีเซ็ตอุปกรณ์ชั่วคราว

การขว้าง
DeviceNotAvailableException

deviceSoftรีสตาร์ทตั้งแต่

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

คิกรีเทิร์น
boolean	true หากรีเซ็ตอุปกรณ์ชั่วคราว

การขว้าง
DeviceNotAvailableException

ปิดใช้AdbRoot

public boolean disableAdbRoot ()

ปิดราก adb

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

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

การขว้าง
DeviceNotAvailableException

disabledKeyguard

public void disableKeyguard ()

ความพยายามปิดใช้งานการล็อกปุ่ม

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

การขว้าง
DeviceNotAvailableException

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

public boolean disableNetworkMonitor ()

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

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

การขว้าง
DeviceNotAvailableException

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

public boolean disconnectFromWifi ()

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

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

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

การขว้าง
DeviceNotAvailableException

doFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

เมธอดของตัวช่วยในการระบุว่าผู้ใช้หนึ่งๆ มีไฟล์อยู่ในอุปกรณ์หรือไม่

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

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

การขว้าง
DeviceNotAvailableException

doFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

การขว้าง
DeviceNotAvailableException

ดัมพ์ฮีป

public File dumpHeap (String process, 
                String devicePath)

พยายามดัมพ์ฮีปจาก system_server ผู้โทรจะมีหน้าที่ล้างข้อมูลไฟล์ที่ถ่ายโอนแล้ว

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

คิกรีเทิร์น
File	ERROR(/File) ที่มีรายงานนั้นอยู่ เป็นค่าว่าง หากล้มเหลว

การขว้าง
DeviceNotAvailableException

enabledAdbRoot

public boolean enableAdbRoot ()

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

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

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

การขว้าง
DeviceNotAvailableException

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

public boolean enableNetworkMonitor ()

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

คิกรีเทิร์น
boolean	trueหากเปิดใช้การตรวจสอบเรียบร้อยแล้ว false หากไม่สำเร็จ

การขว้าง
DeviceNotAvailableException

actionsAdbCommand

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

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

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

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

คิกรีเทิร์น
String	Stdout จากคำสั่ง null หากเรียกใช้คำสั่งไม่สำเร็จ

การขว้าง
DeviceNotAvailableException

actionsAdbCommand

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

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

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

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

คิกรีเทิร์น
String	Stdout จากคำสั่ง null หากเรียกใช้คำสั่งไม่สำเร็จ

การขว้าง
DeviceNotAvailableException

actionsAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

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

คิกรีเทิร์น
String	Stdout จากคำสั่ง null หากเรียกใช้คำสั่งไม่สำเร็จ

การขว้าง
DeviceNotAvailableException

ปฏิบัติการFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

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

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

การขว้าง
DeviceNotAvailableException

ปฏิบัติการFastbootCommand

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

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

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

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

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

การขว้าง
DeviceNotAvailableException

ดำเนินการLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

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

การขว้าง
DeviceNotAvailableException

ดำเนินการLongFastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

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

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

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

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

การขว้าง
DeviceNotAvailableException

ปฏิบัติการเชลล์คำสั่ง

public String executeShellCommand (String command)

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

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

คิกรีเทิร์น
String	เอาต์พุต Shell

การขว้าง
DeviceNotAvailableException

ปฏิบัติการเชลล์คำสั่ง

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

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

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

การขว้าง
DeviceNotAvailableException

ปฏิบัติการเชลล์คำสั่ง

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

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

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

การขว้าง
DeviceNotAvailableException

ปฏิบัติการเชลล์คำสั่ง

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

เรียกใช้คำสั่งเชลล์ adb ที่กำหนด ลองใหม่หลายครั้งหากคำสั่งล้มเหลว

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

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

การขว้าง
DeviceNotAvailableException

สั่งการShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

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

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

การขว้าง
DeviceNotAvailableException

สั่งการShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

พารามิเตอร์
cmd	String: คำสั่งที่ควรเรียกใช้
pipeToOutput	OutputStream: ERROR(/OutputStream) ซึ่งจะเปลี่ยนเส้นทางเอาต์พุต std หรือไม่มีข้อมูล

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

การขว้าง
DeviceNotAvailableException

สั่งการShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

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

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

การขว้าง
DeviceNotAvailableException

สั่งการShellV2Command

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

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

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

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

การขว้าง
DeviceNotAvailableException

สั่งการShellV2Command

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

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

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

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

การขว้าง
DeviceNotAvailableException

สั่งการShellV2Command

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

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

พารามิเตอร์
cmd	String: คำสั่ง Shell adb ที่จะเรียกใช้
pipeAsInput	File: ERROR(/File) ที่จะส่งไปยังอินพุตเป็นอินพุตหรือ Null
pipeToOutput	OutputStream: ERROR(/OutputStream) ซึ่งจะเปลี่ยนเส้นทางเอาต์พุต std หรือไม่มีข้อมูล
maxTimeoutForCommand	long: ระยะหมดเวลาสูงสุดของคำสั่งให้ดำเนินการ หน่วยตามที่ระบุไว้ใน timeUnit
timeUnit	TimeUnit: หน่วยสำหรับ maxTimeToOutputShellResponse
retryAttempts	int: จำนวนครั้งสูงสุดในการลองใช้คำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะส่ง DeviceNotResponseException หากดำเนินการ retryAttempts ไม่สำเร็จ

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

การขว้าง
DeviceNotAvailableException

สั่งการShellV2Command

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

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

พารามิเตอร์
cmd	String: คำสั่ง Shell adb ที่จะเรียกใช้
pipeAsInput	File: ERROR(/File) ที่จะส่งไปยังอินพุตเป็นอินพุตหรือ Null
pipeToOutput	OutputStream: ERROR(/OutputStream) ซึ่งจะเปลี่ยนเส้นทางเอาต์พุต std หรือไม่มีข้อมูล
pipeToError	OutputStream: ERROR(/OutputStream) ซึ่งจะเปลี่ยนเส้นทางข้อผิดพลาด STD หรือไม่มีข้อมูล
maxTimeoutForCommand	long: ระยะหมดเวลาสูงสุดของคำสั่งให้ดำเนินการ หน่วยตามที่ระบุไว้ใน timeUnit
timeUnit	TimeUnit: หน่วยสำหรับ maxTimeToOutputShellResponse
retryAttempts	int: จำนวนครั้งสูงสุดในการลองใช้คำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะส่ง DeviceNotResponseException หากดำเนินการ retryAttempts ไม่สำเร็จ

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

การขว้าง
DeviceNotAvailableException

FastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

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

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

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

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

การขว้าง
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

คิกรีเทิร์น
	ERROR(/Set) จาก ApexInfo เปิดใช้งานในอุปกรณ์อยู่ในขณะนี้

การขว้าง
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

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

พารามิเตอร์
namespace	String: ต้องเป็น {"system", "secure", "global"}

คิกรีเทิร์น
	แผนที่ของคู่คีย์-ค่า มีค่าว่างหากไม่รองรับเนมสเปซ

การขว้าง
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

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

คิกรีเทิร์น
DeviceAllocationState

รับรหัส Android

public String getAndroidId (int userId)

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

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

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

การขว้าง
DeviceNotAvailableException

รับรหัส Android

public  getAndroidIds ()

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

คิกรีเทิร์น
	แผนที่ของรหัส Android พบรหัสผู้ใช้ที่ตรงกัน

การขว้าง
DeviceNotAvailableException

ระดับ getApi

public int getApiLevel ()

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

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

การขว้าง
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

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

คิกรีเทิร์น
PackageInfo	PackageInfo หรือ null หากดึงข้อมูลไม่ได้

การขว้าง
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

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

คิกรีเทิร์น
	ติดตั้ง ERROR(/List) จาก PackageInfo รายการในอุปกรณ์แล้ว

การขว้าง
DeviceNotAvailableException

เวอร์ชันของ GetBase Band

public String getBasebandVersion ()

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

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

การขว้าง
DeviceNotAvailableException

รับแบตเตอรี่

public Integer getBattery ()

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

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

พร็อพเพอร์ตี้ GetBoolean

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

ประวัติการเปิดเครื่อง

public  getBootHistory ()

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

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

การขว้าง
DeviceNotAvailableException

getBootประวัติการเข้าชมตั้งแต่

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

การขว้าง
DeviceNotAvailableException

getBootloaderVersion

public String getBootloaderVersion ()

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

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

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

การขว้าง
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

รองรับเฉพาะ "เวอร์ชัน adb" > 1.0.36

คิกรีเทิร์น
InputStreamSource	InputStreamSource ของไฟล์ ZIP ที่มี Bugreportz แสดงผล Null ในกรณีที่เกิดข้อผิดพลาด

getBuildAlias

public String getBuildAlias ()

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

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

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

การขว้าง
DeviceNotAvailableException

getBuildFlavor

public String getBuildFlavor ()

เรียกข้อมูลเวอร์ชันบิลด์ของอุปกรณ์

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

การขว้าง
DeviceNotAvailableException

getBuildId

public String getBuildId ()

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

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

การขว้าง
DeviceNotAvailableException

คีย์การลงนามของการสร้างบิลด์

public String getBuildSigningKeys ()

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

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

คิกรีเทิร์น
String	คีย์การลงชื่อ หากพบ จะเป็นค่าว่าง

การขว้าง
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

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

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

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

รับเด็ก

public String[] getChildren (String path)

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

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

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

การขว้าง
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

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

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

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

แสดงผล ContentProviderHandler หรือ Null หากไม่มี

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

พารามิเตอร์
userId	int: รหัสผู้ใช้ที่จะใช้ในการเริ่มต้นผู้ให้บริการเนื้อหา

คิกรีเทิร์น
ContentProviderHandler

การขว้าง
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

แสดงผลสถานะปัจจุบันของอุปกรณ์หรือค่า Null หากเกิดปัญหาขึ้น

คิกรีเทิร์น
DeviceFoldableState

การขว้าง
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

คิกรีเทิร์น
int

การขว้าง
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

ดูคลาสของอุปกรณ์

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

getDeviceDate

public long getDeviceDate ()

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

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

การขว้าง
DeviceNotAvailableException

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

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

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

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

getDeviceState

public TestDeviceState getDeviceState ()

ดูสถานะของอุปกรณ์

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

รับเวลาของอุปกรณ์

public long getDeviceTimeOffset (Date date)

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

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

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

การขว้าง
DeviceNotAvailableException

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

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

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

getEmulatorProcess

public Process getEmulatorProcess ()

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

คิกรีเทิร์น
Process	Process หรือ null

บันทึกคำสั่ง getExecuteShell

public final File getExecuteShellCommandLog ()

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

คิกรีเทิร์น
File

เข้าถึงร้านค้าฟรีภายนอก

public long getExternalStoreFreeSpace ()

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

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

การขว้าง
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

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

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

getFastbootProductType

public String getFastbootProductType ()

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

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

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

การขว้าง
DeviceNotAvailableException

getFastbootProductVariant

public String getFastbootProductVariant ()

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

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

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

การขว้าง
DeviceNotAvailableException

getFastbootSerialNumber

public String getFastbootSerialNumber ()

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

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

getFastbootVariable

public String getFastbootVariable (String variableName)

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

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

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

การขว้าง
DeviceNotAvailableException

getFastbootVersion

public String getFastbootVersion ()

แสดงผลสตริงเวอร์ชันของไบนารี Fastboot ที่ใช้ หรือเป็นค่าว่างหากมีบางอย่างผิดปกติ

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

getFileEntry

public IFileEntry getFileEntry (String path)

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

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

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

การขว้าง
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

ผู้ช่วยอย่างไม่เป็นทางการในการรับ FileEntry จากเส้นทางที่ไม่ใช่รูท แก้ไข: เปลี่ยนโครงสร้างภายในระบบ FileEntry เพื่อให้พร้อมใช้งานจากทุกเส้นทาง (รวมถึงไม่ใช่รูท)

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

คิกรีเทิร์น
IFileEntry	FileEntryWrapper ที่แสดง FileEntry

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

getFoldableStates

public  getFoldableStates ()

แสดงรายการสถานะพับได้ในอุปกรณ์ จะได้รับด้วย "cmd device_state Print-states"

คิกรีเทิร์น

การขว้าง
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

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

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

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

getInstalledPackageNames

public  getInstalledPackageNames ()

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

คิกรีเทิร์น
	ERROR(/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 ()

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

คิกรีเทิร์น
KeyguardControllerState	KeyguardControllerState ที่มีภาพรวมของสถานะของคีย์การ์ดและแสดงผล Null หากระบบไม่รองรับคำค้นหา Keyguard

การขว้าง
DeviceNotAvailableException

getLastExpectรีบูตTime Millis

public long getLastExpectedRebootTimeMillis ()

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

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

ระดับ getLaunchApi

public int getLaunchApiLevel ()

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

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

การขว้าง
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

ดึงสตรีมสแนปชอตของข้อมูล Logcat

ทำงานใน 2 โหมดต่อไปนี้

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

มิฉะนั้น ระบบจะส่งคืนแบบคงที่ของข้อมูล Logcat หากอุปกรณ์ตอบสนองอยู่

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

getLogcat

public InputStreamSource getLogcat (int maxBytes)

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

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

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

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

getLogcatDump

public InputStreamSource getLogcatDump ()

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

มีข้อเสียตรงที่จะไม่ส่งคืนอุปกรณ์หากติดต่อไม่ได้

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

getLogcatหากยังไม่มี

public InputStreamSource getLogcatSince (long date)

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

พารามิเตอร์
date	long: เป็นมิลลิวินาทีตั้งแต่รูปแบบ Epoch ของเวลาที่จะเริ่มสแนปชอตจนถึงปัจจุบัน (รับได้โดยใช้ "วันที่ +%s")

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

getMacAddress

public String getMacAddress ()

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

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

รับรหัสผู้ใช้หลัก

public Integer getMainUserId ()

แสดงผล User-ID หลัก

คิกรีเทิร์น
Integer	userId ของผู้ใช้หลักหากมี และแสดงค่าว่างหากไม่มีผู้ใช้หลัก

การขว้าง
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

คิกรีเทิร์น
	ERROR(/Set) จาก String โมดูลหลักที่ติดตั้งอยู่ในปัจจุบันในอุปกรณ์

การขว้าง
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

การขว้าง
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

การขว้าง
DeviceNotAvailableException

getMicrodroidProcess

public Process getMicrodroidProcess ()

คิกรีเทิร์น
Process	แสดงผลการประมวลผลของ Microdroid VM หาก 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	ERROR(/List) จาก MountPointInfo ที่มีข้อมูลใน "/proc/mounts"

การขว้าง
DeviceNotAvailableException

getMountPointInfo

public  getMountPointInfo ()

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

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

การขว้าง
DeviceNotAvailableException

getOptions

public TestDeviceOptions getOptions ()

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

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

getพาร์ติชัน FreeSpace

public long getPartitionFreeSpace (String partition)

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

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

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

การขว้าง
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

แสดงผล User-ID หลัก

คิกรีเทิร์น
Integer	userId ของผู้ใช้หลักหากมี และแสดงค่าว่างหากไม่มีผู้ใช้หลัก

การขว้าง
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 ของบริการหรือ Null หากเกิดข้อผิดพลาด

พารามิเตอร์
process	String: สตริงชื่อโพรเซส

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

การขว้าง
DeviceNotAvailableException

getProductType

public String getProductType ()

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

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

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

การขว้าง
DeviceNotAvailableException

getProductVariant

public String getProductVariant ()

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

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

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

การขว้าง
DeviceNotAvailableException

GetProperty

public String getProperty (String name)

ดึงข้อมูลค่าคุณสมบัติที่ระบุจากอุปกรณ์

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

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

การขว้าง
DeviceNotAvailableException

โหมดกู้คืน

public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

รับภาพหน้าจอ

public InputStreamSource getScreenshot (String format)

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

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

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

การขว้าง
DeviceNotAvailableException

รับภาพหน้าจอ

public InputStreamSource getScreenshot (long displayId)

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

สิ่งที่ต้องทำ: ขยายการใช้งานข้างต้นเพื่อรองรับ "รูปแบบ" และ "ปรับขนาด"

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

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

การขว้าง
DeviceNotAvailableException

รับภาพหน้าจอ

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

การขว้าง
DeviceNotAvailableException

รับภาพหน้าจอ

public InputStreamSource getScreenshot ()

ดึงภาพหน้าจอจากอุปกรณ์

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

การขว้าง
DeviceNotAvailableException

getSerialNumber

public String getSerialNumber ()

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

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

GetSetting

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

แสดงผลค่าของการตั้งค่าที่ขอ Namespace ต้องเป็น {"system", "secure", "global"}

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

คิกรีเทิร์น
String	ค่าที่เชื่อมโยงกับเนมสเปซ:คีย์ของผู้ใช้ มีค่า 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 ()

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

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

GetTombstones

public  getTombstones ()

ดึงข้อมูลและส่งคืนรายการ Tombstone จากอุปกรณ์ต่างๆ ต้องใช้รูท

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

คิกรีเทิร์น
	รายการไฟล์ Tombstone ให้ว่างเปล่าหากไม่มี Tombstone

การขว้าง
DeviceNotAvailableException

getTotalMemory

public long getTotalMemory ()

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

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

getถอนการติดตั้งPackageNames

public  getUninstallablePackageNames ()

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

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

การขว้าง
DeviceNotAvailableException

getUseFastbootDELETE

public boolean getUseFastbootErase ()

รับว่าจะใช้รูปแบบ Fastboot Delete หรือ Fastboot เพื่อล้างข้อมูลพาร์ติชันในอุปกรณ์หรือไม่

คิกรีเทิร์น
boolean	true หากใช้การลบ Fastboot หรือ falseหากจะใช้รูปแบบ Fastboot

getUserFlags

public int getUserFlags (int userId)

ค้นหาและแสดงธงของผู้ใช้ที่ต้องการ การติดธงจะกำหนดไว้ในคลาส "android.content.pm.UserInfo" ในโปรเจ็กต์โอเพนซอร์สของ Android

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

คิกรีเทิร์น
int	ค่าสถานะที่เชื่อมโยงกับ UserId ที่ระบุ หากพบ คือ -10000 ในกรณีอื่นๆ

การขว้าง
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

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

คิกรีเทิร์น
	รายการออบเจ็กต์ UserInfo

การขว้าง
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

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

คิกรีเทิร์น
int

การขว้าง
DeviceNotAvailableException

จัดการเหตุการณ์การจัดสรร

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

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

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

คิกรีเทิร์น
IManagedTestDevice.DeviceEventResponse

มีฟีเจอร์

public boolean hasFeature (String feature)

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

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

คิกรีเทิร์น
boolean	จริงหากพบฟีเจอร์ เป็นเท็จ

การขว้าง
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

installPackage

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

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

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

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

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

การขว้าง
DeviceNotAvailableException

ติดตั้งแพ็กเกจสำหรับผู้ใช้

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

ติดตั้งแพ็กเกจสำหรับผู้ใช้

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

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

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

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

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

การขว้าง
DeviceNotAvailableException

ไม่สามารถใช้งานพร็อพเพอร์ตี้แคช

public void invalidatePropertyCache ()

ISAdbRoot

public boolean isAdbRoot ()

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

การขว้าง
DeviceNotAvailableException

ISAdbTcp

public boolean isAdbTcp ()

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

รองรับ isAppEnumeration

public boolean isAppEnumerationSupported ()

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

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

การขว้าง
DeviceNotAvailableException

รองรับการปิดกั้นเป้าหมาย SDK ต่ำ

public boolean isBypassLowTargetSdkBlockSupported ()

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

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

การขว้าง
DeviceNotAvailableException

ติดตั้ง isDebugfs

public boolean isDebugfsMounted ()

ตรวจสอบว่าได้ต่อเชื่อม debugf หรือไม่

คิกรีเทิร์น
boolean	true หากต่อเชื่อม debugf

การขว้าง
DeviceNotAvailableException

isDeviceEncrypted

public boolean isDeviceEncrypted ()

แสดงผลหากอุปกรณ์เข้ารหัส

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

การขว้าง
DeviceNotAvailableException

ไดเรกทอรี

public boolean isDirectory (String path)

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

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

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

การขว้าง
DeviceNotAvailableException

เปิดใช้ AdbRoot

public boolean isEnableAdbRoot ()

คิกรีเทิร์น
boolean	true หากควรเปิดใช้ adb Root ในอุปกรณ์

รองรับการเข้ารหัส

public boolean isEncryptionSupported ()

แสดงผลหากอุปกรณ์รองรับการเข้ารหัส

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

การขว้าง
DeviceNotAvailableException

เป็นไฟล์ปฏิบัติการ

public boolean isExecutable (String fullPath)

แสดงผลเป็น "จริง" หากเส้นทางของไฟล์ในอุปกรณ์เป็นไฟล์ปฏิบัติการ หรือเป็นเท็จ

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

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

การขว้าง
DeviceNotAvailableException

isFastbootEnabled

public boolean isFastbootEnabled ()

แสดงผลหาก Fastboot พร้อมใช้งานสำหรับอุปกรณ์

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

เป็นแบบไม่มีส่วนหัว

public boolean isHeadless ()

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

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

การขว้าง
DeviceNotAvailableException

โหมดผู้ใช้ระบบไม่มีส่วนหัว

public boolean isHeadlessSystemUserMode ()

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

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

การขว้าง
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

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

การขว้าง
DeviceNotAvailableException

รองรับผู้ใช้หลายคน

public boolean isMultiUserSupported ()

กำหนดว่ารองรับผู้ใช้หลายคนหรือไม่

คิกรีเทิร์น
boolean	จริง หากมีการสนับสนุนผู้ใช้หลายคน เป็นเท็จ

การขว้าง
DeviceNotAvailableException

ติดตั้งแพ็กเกจแล้ว

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

คิกรีเทิร์น
boolean	เป็นจริงหากมีการรายงานว่าแพ็กเกจติดตั้งแล้ว เป็นเท็จ

การขว้าง
DeviceNotAvailableException

ติดตั้งแพ็กเกจแล้ว

public boolean isPackageInstalled (String packageName)

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

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

คิกรีเทิร์น
boolean	เป็นจริงหากมีการรายงานว่าแพ็กเกจติดตั้งแล้ว เป็นเท็จ

การขว้าง
DeviceNotAvailableException

รองรับรันไทม์ไหม

public boolean isRuntimePermissionSupported ()

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

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

การขว้าง
DeviceNotAvailableException

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

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

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

ผู้ใช้กำลังทำงาน

public boolean isUserRunning (int userId)

ตรวจสอบว่าผู้ใช้ที่กำหนดกำลังทำงานอยู่หรือไม่

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

คิกรีเทิร์น
boolean	จริงหากผู้ใช้ทำงานอยู่ ค่าเป็นเท็จในกรณีอื่นๆ ทั้งหมด

การขว้าง
DeviceNotAvailableException

เป็นผู้ใช้รอง

public boolean isUserSecondary (int userId)

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

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

คิกรีเทิร์น
boolean	"จริง" หากผู้ใช้เป็นรอง หรือเป็นเท็จ

การขว้าง
DeviceNotAvailableException

มองเห็นได้

public boolean isUserVisible (int userId)

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

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

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

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

การขว้าง
DeviceNotAvailableException

เป็นUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

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

การขว้าง
DeviceNotAvailableException

VisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

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

การขว้าง
DeviceNotAvailableException

การแสดงข้อมูลพื้นหลังของผู้ใช้

public boolean isVisibleBackgroundUsersSupported ()

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

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

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

การขว้าง
DeviceNotAvailableException

เปิดใช้

public boolean isWifiEnabled ()

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

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

คิกรีเทิร์น
boolean	true หากเปิดใช้ Wi-Fi อยู่ false หากปิดใช้

การขว้าง
DeviceNotAvailableException

รายการรหัส Display

public  listDisplayIds ()

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

คิกรีเทิร์น
	รายการจอแสดงผล ค่าเริ่มต้นจะแสดงการแสดงผลเริ่มต้นเป็น 0 เสมอ

การขว้าง
DeviceNotAvailableException

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

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

คิกรีเทิร์น

การขว้าง
DeviceNotAvailableException

แสดงรายการผู้ใช้

public  listUsers ()

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

คิกรีเทิร์น
	รายการรหัสผู้ใช้

การขว้าง
DeviceNotAvailableException

LogAnrs

public boolean logAnrs (ITestLogger logger)

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

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

คิกรีเทิร์น
boolean	จริง หากการบันทึกสำเร็จ หรือเป็นเท็จ

การขว้าง
DeviceNotAvailableException

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

วิธีการของตัวช่วยในการรับรายงานข้อบกพร่องและบันทึกรายงานให้ผู้รายงาน

พารามิเตอร์
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()

mountDebugf

public void mountDebugfs ()

ต่อเชื่อม debugf

การขว้าง
DeviceNotAvailableException

รีบูตแบบไม่บล็อก

public void nonBlockingReboot ()

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

การขว้าง
DeviceNotAvailableException

AdbRootAction

public void postAdbRootAction ()

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

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

การดำเนินการ PostbUnrootAction

public void postAdbUnrootAction ()

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

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

การตั้งค่าหลังจากเปิดเครื่อง

public void postBootSetup ()

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

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

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

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

การขว้าง
DeviceNotAvailableException

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

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

ตั้งค่าการเรียกใช้ล่วงหน้า

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

PullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

ดึงข้อมูลไฟล์ออกจากอุปกรณ์

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

คิกรีเทิร์น
boolean	true หากเรียกข้อมูลไฟล์สำเร็จ จ่าย false

การขว้าง
DeviceNotAvailableException

PullFile

public File pullFile (String remoteFilePath, 
                int userId)

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

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

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

การขว้าง
DeviceNotAvailableException

PullFile

public File pullFile (String remoteFilePath)

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

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

คิกรีเทิร์น
File	ERROR(/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)

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

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

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

การขว้าง
DeviceNotAvailableException

พุชDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์ซ้ำๆ ขณะที่ยกเว้นบางไดเรกทอรีที่มีการกรอง

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

คิกรีเทิร์น
boolean	true หากพุชไฟล์สำเร็จ จ่าย false

การขว้าง
DeviceNotAvailableException

พุชDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์ซ้ำ

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

คิกรีเทิร์น
boolean	true หากพุชไฟล์สำเร็จ จ่าย false

การขว้าง
DeviceNotAvailableException

พุชDir

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

พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์ซ้ำ

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

คิกรีเทิร์น
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

สตริงพุช

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

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

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

การขว้าง
DeviceNotAvailableException

รีบูตIntoBootloader

public void rebootIntoBootloader ()

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

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

การขว้าง
DeviceNotAvailableException

รีบูตIntoFastbootd

public void rebootIntoFastbootd ()

รีบูตอุปกรณ์ให้เข้าสู่ Fastbootd Mode

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

การขว้าง
DeviceNotAvailableException

รีบูตIntoRecovery

public void rebootIntoRecovery ()

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

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

การขว้าง
DeviceNotAvailableException

BootIntoSideload

public void rebootIntoSideload ()

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

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

การขว้าง
DeviceNotAvailableException

BootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

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

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

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

การขว้าง
DeviceNotAvailableException

รีบูตจนถึงออนไลน์

public void rebootUntilOnline ()

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

การขว้าง
DeviceNotAvailableException

รีบูตจนถึงออนไลน์

public void rebootUntilOnline (String reason)

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

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

การขว้าง
DeviceNotAvailableException

รีบูตUserspace

public void rebootUserspace ()

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

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

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

การขว้าง
DeviceNotAvailableException

รีบูตผู้ใช้พื้นที่จนถึงออนไลน์

public void rebootUserspaceUntilOnline ()

ทางเลือกของ rebootUserspace() ()} ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น นั่นคือ การแสดงผลต่อ adb

การขว้าง
DeviceNotAvailableException

กู้คืนอุปกรณ์

public boolean recoverDevice ()

ความพยายามที่จะกู้คืนการสื่อสารกับอุปกรณ์

คิกรีเทิร์น
boolean	จริง หากพยายามกู้คืนแต่สําเร็จ แสดงผลเป็น "เท็จ" หากข้ามการกู้คืน

การขว้าง
DeviceNotAvailableException	หากอุปกรณ์ไม่พร้อมใช้งานอีกต่อไป

ตัวรับการดำเนินการของอุปกรณ์

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

นำผู้ดูแลระบบออก

public boolean removeAdmin (String componentName, 
                int userId)

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

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

คิกรีเทิร์น
boolean	จริง หากสำเร็จ หรือเป็นเท็จ

การขว้าง
DeviceNotAvailableException

นำเจ้าของออก

public void removeOwners ()

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

การขว้าง
DeviceNotAvailableException

นำผู้ใช้ออก

public boolean removeUser (int userId)

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

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

คิกรีเทิร์น
boolean	true หากเรานำผู้ใช้ออกจากระบบสำเร็จ มิฉะนั้นจะเป็นเท็จ

การขว้าง
DeviceNotAvailableException

รีเซ็ตContentProviderSetup

public void resetContentProviderSetup ()

รีเซ็ตธงของการตั้งค่าผู้ให้บริการเนื้อหาเพื่อให้ทริกเกอร์อีกครั้ง

RuninstrumentationTests

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

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

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

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

การขว้าง
DeviceNotAvailableException

RuninstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

ทดสอบการใช้เครื่องมือและกู้คืนอุปกรณ์

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

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

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

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

การขว้าง
DeviceNotAvailableException

RuninstrumentationTestsAsUser

public 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 boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                ITestLifeCycleReceiver... listeners)

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

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

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

การขว้าง
DeviceNotAvailableException

ตั้งค่าการกำหนดค่า

public void setConfiguration (IConfiguration configuration)

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

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

ตั้งค่าการเชื่อมต่อAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

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

setDate

public void setDate (Date date)

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

หมายเหตุ: การตั้งค่าวันที่ในอุปกรณ์จำเป็นต้องรูท

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

การขว้าง
DeviceNotAvailableException

ตั้งค่าอุปกรณ์เจ้าของ

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

คิกรีเทิร์น
boolean	จริง หากสำเร็จ หรือเป็นเท็จ

การขว้าง
DeviceNotAvailableException

ตั้งค่าสถานะของอุปกรณ์

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

ตั้งค่าอุปกรณ์

public void setIDevice (IDevice newDevice)

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

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

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

ตั้งค่าLogStartDelay

public void setLogStartDelay (int delay)

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

พารามิเตอร์
delay	int: ล่าช้าเป็นมิลลิวินาที

setOptions

public void setOptions (TestDeviceOptions options)

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

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

ตั้งค่าพร็อพเพอร์ตี้

public boolean setProperty (String propKey, 
                String propValue)

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

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

คิกรีเทิร์น
boolean	จะแสดงผล True หากคำสั่ง setprop สำเร็จ แสดงผลเป็น "เท็จ" หากไม่เป็นเช่นนั้น

การขว้าง
DeviceNotAvailableException

SetRecovery

public void setRecovery (IDeviceRecovery recovery)

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

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

ตั้งโหมดการกู้คืน

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

ตั้งค่าการตั้งค่า

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

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

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

การขว้าง
DeviceNotAvailableException

ตั้งค่าการตั้งค่า

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

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

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

การขว้าง
DeviceNotAvailableException

setTestLogger

public void setTestLogger (ITestLogger testLogger)

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

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

ตั้งค่าUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

ตั้งค่าว่าจะใช้รูปแบบ Fastboot หากต้องการลบหรือ Fastboot เพื่อล้างข้อมูลพาร์ติชันในอุปกรณ์

พารามิเตอร์
useFastbootErase	boolean: true หากควรใช้ Fastboot Delete หรือ false หากควรใช้รูปแบบ Fastboot

StartLogcat

public void startLogcat ()

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

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

เมื่อไม่มีการใช้งานอุปกรณ์แล้ว จะต้องโทรหา stopLogcat()

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

ผู้ใช้เริ่มต้น

public boolean startUser (int userId)

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

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

คิกรีเทิร์น
boolean	true ถ้าเริ่มต้นผู้ใช้ในเบื้องหลังสำเร็จ

การขว้าง
DeviceNotAvailableException

ผู้ใช้เริ่มต้น

public boolean startUser (int userId, 
                boolean waitFlag)

เริ่มต้นผู้ใช้หนึ่งๆ ในพื้นหลังหากหยุดทำงานอยู่ หากผู้ใช้ทำงานอยู่เบื้องหลังอยู่แล้ว วิธีนี้ก็เป็นแบบ NOOP สามารถใส่ Flag เพิ่มเติมเพื่อรอให้การดำเนินการมีผลได้

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

คิกรีเทิร์น
boolean	true ถ้าเริ่มต้นผู้ใช้ในเบื้องหลังสำเร็จ

การขว้าง
DeviceNotAvailableException

ผู้ใช้พื้นหลังที่ปรากฏ

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

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

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

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

คิกรีเทิร์น
boolean	true หากเริ่มแสดงผู้ใช้ในเบื้องหลังเรียบร้อยแล้ว

การขว้าง
DeviceNotAvailableException

StopEmulatorเอาต์พุต

public void stopEmulatorOutput ()

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

StopLogcat

public void stopLogcat ()

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

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

ผู้ใช้

public boolean stopUser (int userId)

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

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

คิกรีเทิร์น
boolean	true ถ้าหยุดผู้ใช้สำเร็จ

การขว้าง
DeviceNotAvailableException

ผู้ใช้

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

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

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

คิกรีเทิร์น
boolean	true ถ้าหยุดผู้ใช้สำเร็จ

การขว้าง
DeviceNotAvailableException

SwitchToAdbTcp

public String switchToAdbTcp ()

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

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

การขว้าง
DeviceNotAvailableException

สลับไปยัง AdbUsb

public boolean switchToAdbUsb ()

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

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

การขว้าง
DeviceNotAvailableException

เปลี่ยนผู้ใช้

public boolean switchUser (int userId)

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

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

คิกรีเทิร์น
boolean	เป็นจริงหากรหัสผู้ใช้ใหม่ตรงกับผู้ให้บริการรหัสผู้ใช้ เป็นเท็จ

การขว้าง
DeviceNotAvailableException

เปลี่ยนผู้ใช้

public boolean switchUser (int userId, 
                long timeout)

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

พารามิเตอร์
userId	int
timeout	long: เพื่อรอก่อนที่ระบบจะแสดงค่า "เท็จ" สำหรับผู้ใช้สวิตช์ไม่สำเร็จ

คิกรีเทิร์น
boolean	เป็นจริงหากรหัสผู้ใช้ใหม่ตรงกับผู้ให้บริการรหัสผู้ใช้ เป็นเท็จ

การขว้าง
DeviceNotAvailableException

ซิงค์ไฟล์

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

ถอนการติดตั้งแพ็คเกจ

public String uninstallPackage (String packageName)

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

พารามิเตอร์
packageName	String: แพ็กเกจ Android ที่จะถอนการติดตั้ง

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

การขว้าง
DeviceNotAvailableException

ถอนการติดตั้งPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

ถอนการติดตั้งแพ็กเกจ Android จากผู้ใช้รายหนึ่งๆ ออกจากอุปกรณ์

พารามิเตอร์
packageName	String: แพ็กเกจ Android ที่จะถอนการติดตั้ง
userId	int: รหัสผู้ใช้จำนวนเต็มที่จะถอนการติดตั้ง

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

การขว้าง
DeviceNotAvailableException

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

public boolean unlockDevice ()

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

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

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

การขว้าง
DeviceNotAvailableException

unmountDebugfs

public void unmountDebugfs ()

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

การขว้าง
DeviceNotAvailableException

รอสิ้นสุดการเปิดเครื่อง

public boolean waitForBootComplete (long timeOut)

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

พารามิเตอร์
timeOut	long: เวลาในหน่วยมิลลิวินาทีในการรอการตั้งค่าแฟล็ก

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

การขว้าง
DeviceNotAvailableException

รออุปกรณ์ที่พร้อมใช้งาน

public boolean waitForDeviceAvailable ()

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

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

การขว้าง
DeviceNotAvailableException

รออุปกรณ์ที่พร้อมใช้งาน

public boolean waitForDeviceAvailable (long waitTime)

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

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

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

การขว้าง
DeviceNotAvailableException

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

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

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

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

การขว้าง
DeviceNotAvailableException

รอสำหรับตัวโหลดอุปกรณ์

public void waitForDeviceBootloader ()

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

การขว้าง
DeviceNotAvailableException

รอการกู้คืนอุปกรณ์

public boolean waitForDeviceInRecovery (long waitTime)

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

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

คิกรีเทิร์น
boolean	true หากอุปกรณ์เปิดเครื่องเข้าสู่การกู้คืนก่อนหมดเวลา จ่าย false

รออุปกรณ์ในไซด์โหลด

public boolean waitForDeviceInSideload (long waitTime)

การบล็อกสำหรับอุปกรณ์ให้อยู่ในสถานะ "adb ไซด์โหลด"

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

คิกรีเทิร์น
boolean	true หากอุปกรณ์เปิดเครื่องเข้าสู่ไซด์โหลดก่อนหมดเวลา จ่าย false

รออุปกรณ์ไม่พร้อมให้บริการ

public boolean waitForDeviceNotAvailable (long waitTime)

การบล็อกอุปกรณ์ไม่พร้อมใช้งานเนื่องจากขาดหายไปจาก adb

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

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

รออุปกรณ์ออนไลน์

public void waitForDeviceOnline ()

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

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

การขว้าง
DeviceNotAvailableException

รออุปกรณ์ออนไลน์

public void waitForDeviceOnline (long waitTime)

บล็อกจนกว่าอุปกรณ์จะแสดงผ่าน adb

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

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

การขว้าง
DeviceNotAvailableException

รอเชลล์อุปกรณ์

public boolean waitForDeviceShell (long waitTime)

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

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

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

วิธีการป้องกัน

เพิ่มการเชื่อมต่อเสริมการสร้างอาร์กิวเมนต์

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

พารามิเตอร์
builder	DefaultConnection.ConnectionBuilder

คำสั่ง BuildAdbShellCommand

protected String[] buildAdbShellCommand (String command, 
                boolean forceExitStatusDetection)

สร้างคำสั่งระบบปฏิบัติการสำหรับเซสชันคำสั่งเชลล์ adb และอาร์กิวเมนต์ที่ระบุ

พารามิเตอร์
command	String
forceExitStatusDetection	boolean

คิกรีเทิร์น
String[]

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

พารามิเตอร์
feature	String
strictMinLevel	int

สร้างการดำเนินการใหม่ของอุปกรณ์

protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                String reason)

สร้าง RebootDeviceAction ไว้ใช้เมื่อดำเนินการรีบูต

พารามิเตอร์
rebootMode	NativeDevice.RebootMode: โหมดของการรีบูตนี้
reason	String: สำหรับการรีบูตนี้

คิกรีเทิร์น
NativeDevice.RebootDeviceAction	RebootDeviceAction ที่สร้างขึ้น

สร้าง RunUtil

protected IRunUtil createRunUtil ()

คิกรีเทิร์น
IRunUtil

รีบูต doAdb

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

ทำการรีบูต adb

พารามิเตอร์
rebootMode	NativeDevice.RebootMode: โหมดของการรีบูตนี้
reason	String: สำหรับการรีบูตนี้

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

ตรวจสอบให้แน่ใจว่ารันไทม์รองรับ

protected void ensureRuntimePermissionSupported ()

เมธอด Helper ในการส่งข้อยกเว้นหากไม่รองรับสิทธิ์รันไทม์

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

getApiLevelSafe

protected int getApiLevelSafe ()

คิกรีเทิร์น
int

getLogger

protected ITestLogger getLogger ()

คิกรีเทิร์น
ITestLogger

GetRunUtil

protected IRunUtil getRunUtil ()

รับอินสแตนซ์ RunUtil เพื่อใช้งาน

คิกรีเทิร์น
IRunUtil

เริ่มต้นการเชื่อมต่อ

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

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

การขว้าง
DeviceNotAvailableException
TargetSetupError

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

isInรีบูตCallback

protected boolean isInRebootCallback ()

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

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

ใหม่กว่า

protected boolean isNewer (File localFile, 
                IFileEntry entry)

แสดงผล true หากไฟล์ในเครื่องเก่ากว่าไฟล์ระยะไกล IFileEntry มีความแม่นยำในระดับนาทีเดียว ในกรณีที่เวลาเท่ากัน จะถือว่าไฟล์ใหม่กว่า

พารามิเตอร์
localFile	File
entry	IFileEntry

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

แจ้งเตือนรีบูตจบแล้ว

protected void notifyRebootEnded ()

แจ้ง IDeviceActionReceiver ทั้งหมดเกี่ยวกับเหตุการณ์สิ้นสุดการรีบูต

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

แจ้งเตือนการเริ่มต้นใหม่

protected void notifyRebootStarted ()

แจ้ง IDeviceActionReceiver ทั้งหมดเกี่ยวกับเหตุการณ์เริ่มต้นการรีบูต

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

ดำเนินการของอุปกรณ์

protected boolean performDeviceAction (String actionDescription, 
                NativeDevice.DeviceAction action, 
                int retryAttempts)

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

พารามิเตอร์
actionDescription	String: คำอธิบายสั้นๆ เกี่ยวกับการดำเนินการที่ต้องทำ ใช้เพื่อการบันทึกเท่านั้น
action	NativeDevice.DeviceAction: การดำเนินการที่ต้องทำ
retryAttempts	int: ความพยายามที่จะดําเนินการอีกครั้งหากไม่สำเร็จแต่การกู้คืนสําเร็จ

คิกรีเทิร์น
boolean	true หากดำเนินการเรียบร้อยแล้ว

การขว้าง
DeviceNotAvailableException	หากการพยายามกู้คืนไม่สำเร็จ หรือการดำเนินการสูงสุดที่ทำได้โดยไม่ สำเร็จ

รีบูต postAdb

protected void postAdbReboot ()

การดำเนินการเพิ่มเติมที่อาจทำได้หลังจากการรีบูต

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

ตั้งค่า PrePostBootSetup

protected void prePostBootSetup ()

อนุญาตให้อุปกรณ์แต่ละประเภท (AndroidNativeDevice, TestDevice) ลบล้างเมธอดนี้สำหรับ การตั้งค่าหลังการเปิดเครื่องที่เจาะจง

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

PullFile Internal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

พารามิเตอร์
remoteFilePath	String
localFile	File

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

การขว้าง
DeviceNotAvailableException

ตั้งนาฬิกา

protected void setClock (Clock clock)

ตั้งค่าอินสแตนซ์ของนาฬิกาที่จะใช้

พารามิเตอร์
clock	Clock

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

ทำเครื่องหมาย TestDevice เป็น Microdroid และกำหนด CID

พารามิเตอร์
process	Process: กระบวนการของ Microdroid VM

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

พารามิเตอร์
deviceOptions

SimpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                 envVarMap, 
                String[] fullCmd)

เรียกใช้คำสั่ง Fastboot ง่ายๆ กับตัวแปรสภาพแวดล้อมและรายงานสถานะของคําสั่ง

พารามิเตอร์
timeout	long
envVarMap
fullCmd	String

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

SimpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                String[] fullCmd)

เรียกใช้คำสั่ง Fastboot ง่ายๆ และรายงานสถานะของคําสั่ง

พารามิเตอร์
timeout	long
fullCmd	String

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

รออุปกรณ์ไม่พร้อมให้บริการ

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

รอดูว่าอุปกรณ์ไม่พร้อมใช้งาน (หยุดการรายงานไปยัง adb)

พารามิเตอร์
operationDesc	String: ชื่อของการดำเนินการที่รออยู่
time	long: เวลาที่ต้องรอจนกว่าจะไม่พร้อมให้บริการ

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