NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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

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

สรุป

คลาสเรียนที่ซ้อนกัน

class NativeDevice.AdbAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) สำหรับเรียกใช้คำสั่ง OS "adb ...." 

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) สำหรับการรีบูตอุปกรณ์ 

ค่าคงที่

String DEBUGFS_PATH

int INVALID_USER_ID

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

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

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

String SD_CARD

String STORAGE_EMULATED

ช่อง

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

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

NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

สร้าง TestDevice

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

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)

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

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

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

int createUser(String name)

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

int createUserNoThrow(String name)

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

DeviceInspectionResult debugDeviceNotAvailable()

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

void deleteFile(String deviceFilePath, int userId)

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

void deleteFile(String deviceFilePath)

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

void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

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

boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

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

boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

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

boolean disableAdbRoot()

ปิดรูท adb

void disableKeyguard()

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

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)

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

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

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

String executeAdbCommand(String... cmdArgs)

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

CommandResult executeAdbV2Command(String... cmdArgs)

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

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

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

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

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

CommandResult executeFastbootCommand(String... cmdArgs)

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

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

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

CommandResult executeLongFastbootCommand(String... cmdArgs)

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

CommandResult executeLongFastbootCommand( envVarMap, String... cmdArgs)

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

String executeShellCommand(String command)

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

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

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

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

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

void executeShellCommand(String command, IShellOutputReceiver receiver)

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

CommandResult executeShellV2Command(String cmd)

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

CommandResult executeShellV2Command(String cmd, OutputStream pipeToOutput)

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

CommandResult executeShellV2Command(String cmd, File pipeAsInput)

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

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

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

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

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

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

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

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

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

CommandResult fastbootWipePartition(String partition)

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

getActiveApexes()

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

String getAdbPath()

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

getAllSettings(String namespace)

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

DeviceAllocationState getAllocationState()

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

String getAndroidId(int userId)

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

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 หรือค่าว่างหากไม่มี

DeviceFoldableState getCurrentFoldableState()

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

int getCurrentUser()

แสดงรหัสของผู้ใช้ที่กำลังเรียกใช้

String getDeviceClass()

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

long getDeviceDate()

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

DeviceDescriptor getDeviceDescriptor()

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

DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

TestDeviceState getDeviceState()

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

long getDeviceTimeOffset(Date date)

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

InputStreamSource getEmulatorOutput()

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

Process getEmulatorProcess()

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

final File getExecuteShellCommandLog()

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

long getExternalStoreFreeSpace()

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

String getFastbootPath()

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

String getFastbootProductType()

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

String getFastbootProductVariant()

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

String getFastbootSerialNumber()

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

String getFastbootVariable(String variableName)

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

String getFastbootVersion()

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

IFileEntry getFileEntry(String path)

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

IFileEntry getFileEntry(FileListingService.FileEntry entry)

โปรแกรมช่วยที่ไม่เป็นทางการในการรับ FileEntry จากเส้นทางที่ไม่ใช่รูท

getFoldableStates()

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

IDevice getIDevice()

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

getInstalledPackageNames()

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

long getIntProperty(String name, long defaultValue)

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

String getIpAddress()

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

KeyguardControllerState getKeyguardState()

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

long getLastExpectedRebootTimeMillis()

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

int getLaunchApiLevel()

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

InputStreamSource getLogcat()

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

InputStreamSource getLogcat(int maxBytes)

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

InputStreamSource getLogcatDump()

รับการดัมพ์ของ Logcat ปัจจุบันสำหรับอุปกรณ์

InputStreamSource getLogcatSince(long date)

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

String getMacAddress()

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

Integer getMainUserId()

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

getMainlineModuleInfo()

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

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)

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

Integer getPrimaryUserId()

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

ProcessInfo getProcessByName(String processName)

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

String getProcessPid(String process)

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

String getProductType()

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

String getProductVariant()

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

String getProperty(String name)

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

ITestDevice.RecoveryMode getRecoveryMode()

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

InputStreamSource getScreenshot(long displayId)

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

InputStreamSource getScreenshot(String format)

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

InputStreamSource getScreenshot(String format, boolean rescale)

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

InputStreamSource getScreenshot()

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

String getSerialNumber()

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

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

แสดงค่าของการตั้งค่าที่ขอ

String getSetting(String namespace, String key)

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

String getSimOperator()

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

String getSimState()

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

getTombstones()

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

long getTotalMemory()

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

String getTrackingSerial()

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

getUninstallablePackageNames()

ดึงข้อมูลชื่อแพ็กเกจแอปพลิเคชันที่ถอนการติดตั้งได้

boolean getUseFastbootErase()

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

int getUserFlags(int userId)

ค้นหาและแสดงผลการแจ้งของผู้ใช้ที่ระบุ

getUserInfos()

รับแผนที่ของ useId ไปยัง UserInfo ในอุปกรณ์

int getUserSerialNumber(int userId)

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

IManagedTestDevice.DeviceEventResponse handleAllocationEvent(DeviceEvent event)

ประมวลผล DeviceEvent ที่ระบุ

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

boolean hasFeature(String feature)

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

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

เริ่มการเชื่อมต่อกับอุปกรณ์

String installPackage(File packageFile, boolean reinstall, 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 ในอุปกรณ์สำหรับผู้ใช้ที่ระบุ

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

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

void invalidatePropertyCache()
boolean isAdbRoot()

boolean isAdbTcp()
boolean isAppEnumerationSupported()

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

boolean isBypassLowTargetSdkBlockSupported()

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

boolean isDebugfsMounted()

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

boolean isDeviceEncrypted()

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

boolean isDirectory(String path)

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

boolean isEnableAdbRoot()
boolean isEncryptionSupported()

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

boolean isExecutable(String fullPath)

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

boolean isFastbootEnabled()

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

boolean isHeadless()

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

boolean isHeadlessSystemUserMode()

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

boolean isMainUserPermanentAdmin()

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

boolean isMultiUserSupported()

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

boolean isPackageInstalled(String packageName, String userId)

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

boolean isPackageInstalled(String packageName)

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

boolean isRuntimePermissionSupported()

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

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

เมานต์ debugfs

void nonBlockingReboot()

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

void postAdbRootAction()

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

void postAdbUnrootAction()

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

void postBootSetup()

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

void postInvocationTearDown(Throwable exception)

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

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

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

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

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

boolean pullDir(String deviceFilePath, File localDir)

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

boolean 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

void rebootIntoRecovery()

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

void rebootIntoSideload()

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

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

void rebootIntoSideload(boolean autoReboot)

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

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

void rebootUntilOnline()

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

void rebootUntilOnline(String reason)

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

void rebootUserspace()

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

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)) โดยส่งผู้ฟังอย่างน้อย 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 setAdbPath(String adbPath)

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

void setConfiguration(IConfiguration configuration)

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

final void setConnectionAvdInfo(GceAvdInfo avdInfo)
void setDate(Date date)

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

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

boolean setDeviceOwner(String componentName, int userId)

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

void setDeviceState(TestDeviceState deviceState)

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

void setEmulatorOutputStream(SizeLimitedOutputStream output)

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

void setEmulatorProcess(Process p)

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

void setFastbootEnabled(boolean fastbootEnabled)

ตั้งค่าตัวเลือก fastboot สำหรับอุปกรณ์

void setFastbootPath(String fastbootPath)

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

void setIDevice(IDevice newDevice)

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

void setLogStartDelay(int delay)

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

void setOptions(TestDeviceOptions options)

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

boolean setProperty(String propKey, String propValue)

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

void setRecovery(IDeviceRecovery recovery)

ตั้งค่า IDeviceRecovery ที่จะใช้สำหรับอุปกรณ์นี้

void setRecoveryMode(ITestDevice.RecoveryMode mode)

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

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

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

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

เพิ่มค่าการตั้งค่าลงในเนมสเปซของผู้ใช้ที่ต้องการ

void setTestLogger(ITestLogger testLogger)

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

void setTrackingSerial(String trackingSerial)

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

void setUseFastbootErase(boolean useFastbootErase)

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

void startLogcat()

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

boolean startTradeInModeTesting(int timeoutMs)

เปิดใช้โหมดทดสอบการแลกรับข้อเสนอ

boolean startUser(int userId)

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

boolean startUser(int userId, boolean waitFlag)

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

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

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

void stopEmulatorOutput()

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

void stopLogcat()

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

void stopTradeInModeTesting()

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

boolean stopUser(int userId)

หยุดผู้ใช้ที่ระบุ

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

หยุดผู้ใช้ที่ระบุ

String switchToAdbTcp()

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

boolean switchToAdbUsb()

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

boolean switchUser(int userId)

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

boolean switchUser(int userId, long timeout)

เปลี่ยนไปใช้ userId อื่นโดยมีระยะหมดเวลาที่ระบุเป็นกำหนดเวลา

boolean syncFiles(File localFileDir, String deviceFilePath)

ซิงค์เนื้อหาของไดเรกทอรีไฟล์ในเครื่องกับอุปกรณ์ทีละรายการ

Bugreport takeBugreport()

ใช้รายงานข้อบกพร่องและส่งคืนภายในออบเจ็กต์ Bugreport เพื่อจัดการ

String uninstallPackage(String packageName)

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

String uninstallPackageForUser(String packageName, int userId)

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

boolean unlockDevice()

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

void unmountDebugfs()

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

boolean waitForBootComplete(long timeOut)

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

boolean waitForDeviceAvailable()

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

boolean waitForDeviceAvailable(long waitTime)

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

boolean waitForDeviceAvailableInRecoverPath(long waitTime)

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

void waitForDeviceBootloader()

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

void waitForDeviceFastbootD()
boolean waitForDeviceInRecovery(long waitTime)

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

boolean waitForDeviceInSideload(long waitTime)

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

boolean waitForDeviceNotAvailable(long waitTime)

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

void waitForDeviceOnline()

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

void waitForDeviceOnline(long waitTime)

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

boolean waitForDeviceShell(long waitTime)

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

วิธีการที่ได้รับการป้องกัน

void addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
String[] buildAdbShellCommand(String command, boolean forceExitStatusDetection)

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

void checkApiLevelAgainst(String feature, int strictMinLevel)
NativeDevice.RebootDeviceAction createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)

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

IRunUtil createRunUtil()
void doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)

ดำเนินการรีบูต adb

void ensureRuntimePermissionSupported()

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

int getApiLevelSafe()
ITestLogger getLogger()
IRunUtil getRunUtil()

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

String internalGetProperty(String propName, String fastbootVar, String description)

ดึงข้อมูลพร็อพเพอร์ตี้ของอุปกรณ์จากแคช ddmlib โดยค่าเริ่มต้น และกลับไปใช้ `adb shell getprop` หรือ `fastboot getvar` ขึ้นอยู่กับว่าอุปกรณ์อยู่ใน Fastboot หรือไม่

boolean isInRebootCallback()

แสดงว่าขณะนี้มีการเรียกกลับการรีบูตหรือไม่

boolean isNewer(File localFile, IFileEntry entry)

แสดงผล true หากไฟล์ในเครื่องใหม่กว่าไฟล์ระยะไกล

void notifyRebootEnded()

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

void notifyRebootStarted()

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

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

ดำเนินการในอุปกรณ์นี้

void postAdbReboot(NativeDevice.RebootMode rebootMode)

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

void prePostBootSetup()

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

boolean pullFileInternal(String remoteFilePath, File localFile)
void setClock(Clock 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)

ค่าคงที่

DEBUGFS_PATH

public static final String DEBUGFS_PATH

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

INVALID_USER_ID

public static final int INVALID_USER_ID

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

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

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

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

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

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

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

SD_CARD

protected static final String SD_CARD

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

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

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

ช่อง

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

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

NativeDevice

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

สร้าง TestDevice

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

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

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

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

การขว้าง
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

checkConnectivity

public boolean checkConnectivity ()

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

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

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

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

clearLogcat

public void clearLogcat ()

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

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

connectToWifiNetwork

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

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

พารามิเตอร์
wifiSsid String: SSID ของ Wi-Fi ที่จะเชื่อมต่อ
wifiPsk String: รหัสผ่าน PSK หรือ null หากไม่ได้เข้ารหัส
คิกรีเทิร์น
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ
การขว้าง
DeviceNotAvailableException

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

พารามิเตอร์
wifiSsidToPsk : แผนที่ของ SSID ของ Wi-Fi ไปยังรหัสผ่าน
คิกรีเทิร์น
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ
การขว้าง
DeviceNotAvailableException

connectToWifiNetwork

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

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

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

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

connectToWifiNetworkIfNeeded

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

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

พารามิเตอร์
scanSsid boolean: จะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่
คิกรีเทิร์น
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ
การขว้าง
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

createUser

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

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

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

createUser

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

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

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

createUser

public int createUser (String name)

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

พารามิเตอร์
name String: ของผู้ใช้เพื่อสร้างในอุปกรณ์
คิกรีเทิร์น
int จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้น
การขว้าง
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

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

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

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

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

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

deleteFile

public void deleteFile (String deviceFilePath)

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

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

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

พารามิเตอร์
prevSystemServerProcess ProcessInfo: กระบวนการ system_server ก่อนหน้า ProcessInfo
คิกรีเทิร์น
boolean true หากอุปกรณ์รีสตาร์ทแบบซอฟต์รีเซ็ต
การขว้าง
DeviceNotAvailableException

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

disableAdbRoot

public boolean disableAdbRoot ()

ปิดรูท adb

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

คิกรีเทิร์น
boolean true หากสำเร็จ
การขว้าง
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

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

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

การขว้าง
DeviceNotAvailableException

disableNetworkMonitor

public boolean disableNetworkMonitor ()

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

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

disconnectFromWifi

public boolean disconnectFromWifi ()

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

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

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

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

พารามิเตอร์
deviceFilePath String: เส้นทางแบบเต็มของไฟล์ในอุปกรณ์ที่จะตรวจสอบ
คิกรีเทิร์น
boolean true หากมีไฟล์อยู่ false มิฉะนั้น
การขว้าง
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

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

enableAdbRoot

public boolean enableAdbRoot ()

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

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

คิกรีเทิร์น
boolean true หากสำเร็จ
การขว้าง
DeviceNotAvailableException

enableNetworkMonitor

public boolean enableNetworkMonitor ()

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

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

executeAdbCommand

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

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

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

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

executeAdbCommand

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

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

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

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

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

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

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

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

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

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

executeAdbV2Command

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

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

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

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

executeAdbV2Command

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

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

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

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

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

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

executeFastbootCommand

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

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

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

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

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

executeLongFastbootCommand

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

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

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

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

executeShellCommand

public String executeShellCommand (String command)

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

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

executeShellCommand

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

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

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

executeShellCommand

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

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

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

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

พารามิเตอร์
cmd String: คำสั่งที่ควรเรียกใช้
คิกรีเทิร์น
CommandResult ผลการค้นหาในภาษาCommandResult
การขว้าง
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

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

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

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

executeShellV2Command

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

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

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

การขว้าง
DeviceNotAvailableException

executeShellV2Command

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

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

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

การขว้าง
DeviceNotAvailableException

executeShellV2Command

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

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

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

การขว้าง
DeviceNotAvailableException

executeShellV2Command

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

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

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

การขว้าง
DeviceNotAvailableException

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

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

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

พารามิเตอร์
partition String: พาร์ติชันที่จะล้างข้อมูล
คิกรีเทิร์น
CommandResult CommandResult ที่มีเอาต์พุตของคำสั่ง
การขว้าง
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

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

getAdbPath

public String getAdbPath ()

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

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

getAllSettings

public  getAllSettings (String namespace)

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

พารามิเตอร์
namespace String: ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ {"system", "secure", "global"}
คิกรีเทิร์น
แผนที่ของคู่คีย์-ค่า เป็น Null หากไม่รองรับเนมสเปซ
การขว้าง
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

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

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

getAndroidId

public String getAndroidId (int userId)

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

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

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

การขว้าง
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

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

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

getApiLevel

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

getBasebandVersion

public String getBasebandVersion ()

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

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

getBattery

public Integer getBattery ()

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

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

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

พารามิเตอร์
name String: ชื่อพร็อพเพอร์ตี้
defaultValue boolean: ค่าเริ่มต้นที่จะแสดงหากพร็อพเพอร์ตี้ว่างเปล่าหรือไม่มีอยู่
คิกรีเทิร์น
boolean true หากพร็อพเพอร์ตี้มีค่า "1", "y", "yes", "on" หรือ "true", false หากพร็อพเพอร์ตี้มีค่า "0", "n", "no", "off", "false" หรือ defaultValue มิฉะนั้น
การขว้าง
DeviceNotAvailableException

getBootHistory

public  getBootHistory ()

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

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

getBootHistorySince

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

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

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

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

getBuildAlias

public String getBuildAlias ()

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

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

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

getBuildFlavor

public String getBuildFlavor ()

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

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

getBuildId

public String getBuildId ()

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

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

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

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

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

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

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

getChildren

public String[] getChildren (String path)

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

พารามิเตอร์
path String: คือเส้นทางในอุปกรณ์ที่จะทำการค้นหา
คิกรีเทิร์น
String[] อาร์เรย์ของสตริงที่มีไฟล์ทั้งหมดในเส้นทางบนอุปกรณ์
การขว้าง
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

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

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

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

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

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

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

การขว้าง
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

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

การขว้าง
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

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

การขว้าง
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

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

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

getDeviceDate

public long getDeviceDate ()

แสดงผลวันที่ของอุปกรณ์เป็นมิลลิวินาทีตั้งแต่ 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

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

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

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

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

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

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

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

getEmulatorProcess

public Process getEmulatorProcess ()

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

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

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

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

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

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

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

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

getFastbootPath

public String getFastbootPath ()

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

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

getFastbootProductType

public String getFastbootProductType ()

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

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

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

getFastbootProductVariant

public String getFastbootProductVariant ()

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

ใช้วิธีนี้ในกรณีที่อุปกรณ์ควรอยู่ในโหมด 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 ที่ใช้ หรือเป็น Null หากเกิดข้อผิดพลาด

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

getFileEntry

public IFileEntry getFileEntry (String path)

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

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

การขว้าง
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

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

พารามิเตอร์
entry FileListingService.FileEntry: FileEntry ไม่จำเป็นต้องเป็นรูทตามที่ Ddmlib ต้องการ
คิกรีเทิร์น
IFileEntry FileEntryWrapper ที่แสดง FileEntry
การขว้าง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

คิกรีเทิร์น
การขว้าง
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

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

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

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

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

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

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

getLaunchApiLevel

public int getLaunchApiLevel ()

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

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

getLogcat

public InputStreamSource getLogcat ()

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

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

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

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

    • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

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

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

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

    getLogcatDump

    public InputStreamSource getLogcatDump ()

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

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

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

    getLogcatSince

    public InputStreamSource getLogcatSince (long date)

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

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

    getMacAddress

    public String getMacAddress ()

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

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

    getMainUserId

    public Integer getMainUserId ()

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

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

    getMainlineModuleInfo

    public  getMainlineModuleInfo ()

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

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

    getMaxNumberOfRunningUsersSupported

    public int getMaxNumberOfRunningUsersSupported ()

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

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

    getMaxNumberOfUsersSupported

    public int getMaxNumberOfUsersSupported ()

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

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

    getMicrodroidProcess

    public Process getMicrodroidProcess ()

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

    getMonitor

    public IDeviceStateMonitor getMonitor ()

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

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

    getMountPoint

    public String getMountPoint (String mountName)

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

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

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

    พารามิเตอร์
    mountName String: ชื่อของจุดต่อเชื่อม
    คิกรีเทิร์น
    String จุดต่อเชื่อมหรือ null

    getMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

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

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

    getMountPointInfo

    public  getMountPointInfo ()

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

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

    getOptions

    public TestDeviceOptions getOptions ()

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

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

    getPartitionFreeSpace

    public long getPartitionFreeSpace (String partition)

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

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

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

    getPrimaryUserId

    public Integer getPrimaryUserId ()

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

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

    getProcessByName

    public ProcessInfo getProcessByName (String processName)

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

    พารามิเตอร์
    processName String: สตริงชื่อกระบวนการ
    คิกรีเทิร์น
    ProcessInfo ProcessInfo ของ processName ที่ระบุ
    การขว้าง
    DeviceNotAvailableException

    getProcessPid

    public String getProcessPid (String process)

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

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

    การขว้าง
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

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

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

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

    getProductVariant

    public String getProductVariant ()

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

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

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

    การขว้าง
    DeviceNotAvailableException

    getProperty

    public String getProperty (String name)

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

    พารามิเตอร์
    name String: ชื่อพร็อพเพอร์ตี้
    คิกรีเทิร์น
    String ค่าพร็อพเพอร์ตี้หรือ null หากไม่มี
    การขว้าง
    DeviceNotAvailableException

    getRecoveryMode

    public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    getScreenshot

    public InputStreamSource getScreenshot (long displayId)

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

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

    พารามิเตอร์
    displayId long: รหัสการแสดงผลของหน้าจอที่จะจับภาพหน้าจอ
    คิกรีเทิร์น
    InputStreamSource InputStreamSource ของภาพหน้าจอในรูปแบบ หรือ null หาก ภาพหน้าจอไม่สำเร็จ
    การขว้าง
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format)

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

    พารามิเตอร์
    format String: รองรับ PNG, JPEG
    คิกรีเทิร์น
    InputStreamSource InputStreamSource ของภาพหน้าจอในรูปแบบ หรือ null หาก ภาพหน้าจอไม่สำเร็จ
    การขว้าง
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

    getScreenshot

    public InputStreamSource getScreenshot ()

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

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

    getSerialNumber

    public String getSerialNumber ()

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

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

    getSetting

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

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

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

    namespace String

    key String

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

    getSetting

    public String getSetting (String namespace, 
                String key)

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

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

    key String

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

    การขว้าง
    DeviceNotAvailableException

    getSimOperator

    public String getSimOperator ()

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

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

    getSimState

    public String getSimState ()

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

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

    getTombstones

    public  getTombstones ()

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

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

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

    getTotalMemory

    public long getTotalMemory ()

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

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

    getTrackingSerial

    public String getTrackingSerial ()

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

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

    getUninstallablePackageNames

    public  getUninstallablePackageNames ()

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

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

    getUseFastbootErase

    public boolean getUseFastbootErase ()

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

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

    getUserFlags

    public int getUserFlags (int userId)

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

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

    คิกรีเทิร์น
    int the flags associated with the userId provided if found, -10000 in any other cases.
    การขว้าง
    DeviceNotAvailableException

    getUserInfos

    public  getUserInfos ()

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

    คิกรีเทิร์น
    รายการออบเจ็กต์ UserInfo
    การขว้าง
    DeviceNotAvailableException

    getUserSerialNumber

    public int getUserSerialNumber (int userId)

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

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

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

    การขว้าง
    DeviceNotAvailableException

    handleAllocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

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

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

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

    hasFeature

    public boolean hasFeature (String feature)

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

    พารามิเตอร์
    feature String: รูปแบบควรเป็น "feature:" หรือ "" โดยตรง
    คิกรีเทิร์น
    boolean เป็นจริงหากพบฟีเจอร์ เป็นเท็จหากไม่พบ
    การขว้าง
    DeviceNotAvailableException

    initializeConnection

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

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

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

    attributes MultiMap

    การขว้าง
    DeviceNotAvailableException
    TargetSetupError

    installPackage

    public String installPackage (File packageFile, 
                boolean reinstall, 
                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 ในอุปกรณ์

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

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

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

    installPackageForUser

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

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

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

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

    installPackageForUser

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

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

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

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

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

    installPackageWithIncrementalMode

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

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

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

    userId String

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

    การขว้าง
    DeviceNotAvailableException

    invalidatePropertyCache

    public void invalidatePropertyCache ()

    isAdbRoot

    public boolean isAdbRoot ()

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

    การขว้าง
    DeviceNotAvailableException

    isAdbTcp

    public boolean isAdbTcp ()

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

    isAppEnumerationSupported

    public boolean isAppEnumerationSupported ()

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

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

    isBypassLowTargetSdkBlockSupported

    public boolean isBypassLowTargetSdkBlockSupported ()

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

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

    isDebugfsMounted

    public boolean isDebugfsMounted ()

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

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

    isDeviceEncrypted

    public boolean isDeviceEncrypted ()

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

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

    isDirectory

    public boolean isDirectory (String path)

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

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

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

    การขว้าง
    DeviceNotAvailableException

    isEnableAdbRoot

    public boolean isEnableAdbRoot ()

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

    isEncryptionSupported

    public boolean isEncryptionSupported ()

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

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

    isExecutable

    public boolean isExecutable (String fullPath)

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

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

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

    การขว้าง
    DeviceNotAvailableException

    isFastbootEnabled

    public boolean isFastbootEnabled ()

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

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

    isHeadless

    public boolean isHeadless ()

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

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

    การขว้าง
    DeviceNotAvailableException

    isHeadlessSystemUserMode

    public boolean isHeadlessSystemUserMode ()

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

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

    การขว้าง
    DeviceNotAvailableException

    isMainUserPermanentAdmin

    public boolean isMainUserPermanentAdmin ()

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

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

    การขว้าง
    DeviceNotAvailableException

    isMultiUserSupported

    public boolean isMultiUserSupported ()

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

    คิกรีเทิร์น
    boolean จริงหากรองรับผู้ใช้หลายคน เท็จหากไม่รองรับ
    การขว้าง
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

    isPackageInstalled

    public boolean isPackageInstalled (String packageName)

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

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

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

    isRuntimePermissionSupported

    public boolean isRuntimePermissionSupported ()

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

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

    isStateBootloaderOrFastbootd

    public boolean isStateBootloaderOrFastbootd ()

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

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

    isUserRunning

    public boolean isUserRunning (int userId)

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

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

    คิกรีเทิร์น
    boolean จริง หากผู้ใช้กำลังวิ่ง เท็จในกรณีอื่นๆ
    การขว้าง
    DeviceNotAvailableException

    isUserSecondary

    public boolean isUserSecondary (int userId)

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

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

    คิกรีเทิร์น
    boolean จริง หากผู้ใช้เป็นผู้ใช้รอง เท็จ หากไม่ใช่
    การขว้าง
    DeviceNotAvailableException

    isUserVisible

    public boolean isUserVisible (int userId)

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

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

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

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

    การขว้าง
    DeviceNotAvailableException

    isUserVisibleOnDisplay

    public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

    displayId int

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

    การขว้าง
    DeviceNotAvailableException

    isVisibleBackgroundUsersOnDefaultDisplaySupported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

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

    การขว้าง
    DeviceNotAvailableException

    isVisibleBackgroundUsersSupported

    public boolean isVisibleBackgroundUsersSupported ()

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

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

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

    การขว้าง
    DeviceNotAvailableException

    isWifiEnabled

    public boolean isWifiEnabled ()

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

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

    คิกรีเทิร์น
    boolean true หากเปิดใช้ Wi-Fi false หากปิดใช้
    การขว้าง
    DeviceNotAvailableException

    listDisplayIds

    public  listDisplayIds ()

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

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

    listDisplayIdsForStartingVisibleBackgroundUsers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

    คิกรีเทิร์น
    การขว้าง
    DeviceNotAvailableException

    listUsers

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

    mountDebugfs

    public void mountDebugfs ()

    เมานต์ debugfs

    การขว้าง
    DeviceNotAvailableException

    nonBlockingReboot

    public void nonBlockingReboot ()

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

    การขว้าง
    DeviceNotAvailableException

    postAdbRootAction

    public void postAdbRootAction ()

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

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

    postAdbUnrootAction

    public void postAdbUnrootAction ()

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

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

    postBootSetup

    public void postBootSetup ()

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

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

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

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

    การขว้าง
    DeviceNotAvailableException

    postInvocationTearDown

    public void postInvocationTearDown (Throwable exception)

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

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

    preInvocationSetup

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

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

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

    pullDir

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

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

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

    pullDir

    public boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

    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

    pushDir

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

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

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

    pushDir

    public boolean pushDir (File localFileDir, 
                String deviceFilePath)

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

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

    pushDir

    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

    pushString

    public boolean pushString (String contents, 
                String remoteFilePath)

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

    พารามิเตอร์
    contents String: เนื้อหาของไฟล์ที่จะพุช
    remoteFilePath String: เส้นทางไฟล์แบบสัมบูรณ์ของปลายทางระยะไกล
    คิกรีเทิร์น
    boolean true หากส่งสตริงสำเร็จ false หรือไม่เช่นนั้น
    การขว้าง
    DeviceNotAvailableException

    รีบูต

    public void reboot (String reason)

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

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

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

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

    รีบูต

    public void reboot ()

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

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

    การขว้าง
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

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

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

    การขว้าง
    DeviceNotAvailableException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

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

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

    การขว้าง
    DeviceNotAvailableException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

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

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

    การขว้าง
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

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

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

    การขว้าง
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

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

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

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

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

    public void rebootUntilOnline ()

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

    การขว้าง
    DeviceNotAvailableException

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

    public void rebootUntilOnline (String reason)

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

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

    rebootUserspace

    public void rebootUserspace ()

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

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

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

    การขว้าง
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

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

    การขว้าง
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

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

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

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

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

    remountSystemReadOnly

    public void remountSystemReadOnly ()

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

    การขว้าง
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

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

    การขว้าง
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

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

    การขว้าง
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

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

    การขว้าง
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                int userId)

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

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

    removeOwners

    public void removeOwners ()

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

    การขว้าง
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

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

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

    resetContentProviderSetup

    public void resetContentProviderSetup ()

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

    runInstrumentationTests

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

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

    พารามิเตอร์
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner ที่ทำการทดสอบ
    listeners ITestLifeCycleReceiver: ผู้ฟังผลการทดสอบ
    คิกรีเทิร์น
    boolean true หากคำสั่งทดสอบเสร็จสมบูรณ์ false หากไม่สำเร็จ แต่การกู้คืนสำเร็จ
    การขว้าง
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

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

    หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปก่อนที่การทดสอบจะเสร็จสมบูรณ์ และการกู้คืนล้มเหลว ระบบจะแจ้งให้ผู้ฟังทั้งหมดทราบว่า 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

    setAdbPath

    public void setAdbPath (String adbPath)

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

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

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

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

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

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

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

    setDate

    public void setDate (Date date)

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

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

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

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

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

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

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

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

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

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

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

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

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

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

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

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

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

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

    setIDevice

    public void setIDevice (IDevice newDevice)

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

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

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

    setLogStartDelay

    public void setLogStartDelay (int delay)

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

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

    setOptions

    public void setOptions (TestDeviceOptions options)

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

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

    setProperty

    public boolean setProperty (String propKey, 
                String propValue)

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

    พารามิเตอร์
    propKey String: คีย์เป้าหมายที่จะตั้งค่า
    propValue String: ค่าพร็อพเพอร์ตี้ที่จะตั้งค่า
    คิกรีเทิร์น
    boolean จะแสดง True หากคำสั่ง setprop สำเร็จ หรือ False หากไม่สำเร็จ
    การขว้าง
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

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

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

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

    setSetting

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

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

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

    key String

    value String

    การขว้าง
    DeviceNotAvailableException

    setSetting

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

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

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

    namespace String

    key String

    value String

    การขว้าง
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

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

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

    setTrackingSerial

    public void setTrackingSerial (String trackingSerial)

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

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

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

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

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

    startLogcat

    public void startLogcat ()

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

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

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

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

    startTradeInModeTesting

    public boolean startTradeInModeTesting (int timeoutMs)

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

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

    คิกรีเทิร์น
    boolean เป็นจริงหากเราประสบความสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ
    การขว้าง
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId)

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

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

    startUser

    public boolean startUser (int userId, 
                boolean waitFlag)

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

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

    startVisibleBackgroundUser

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

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

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

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

    stopEmulatorOutput

    public void stopEmulatorOutput ()

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

    stopLogcat

    public void stopLogcat ()

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

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

    stopTradeInModeTesting

    public void stopTradeInModeTesting ()

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

    การขว้าง
    DeviceNotAvailableException

    stopUser

    public boolean stopUser (int userId)

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

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

    stopUser

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

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

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

    switchToAdbTcp

    public String switchToAdbTcp ()

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

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

    switchToAdbUsb

    public boolean switchToAdbUsb ()

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

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

    switchUser

    public boolean switchUser (int userId)

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

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

    คิกรีเทิร์น
    boolean จริง หาก userId ใหม่ตรงกับผู้ให้บริการ userId มิเช่นนั้นจะเป็น "เท็จ"
    การขว้าง
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId, 
                long timeout)

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

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

    timeout long: เพื่อรอให้การเปลี่ยนผู้ใช้ล้มเหลวก่อนที่จะส่งคืนค่าเป็นเท็จ
    คิกรีเทิร์น
    boolean จริง หาก userId ใหม่ตรงกับผู้ให้บริการ userId มิเช่นนั้นจะเป็น "เท็จ"
    การขว้าง
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

    ซิงค์เนื้อหาของไดเรกทอรีไฟล์ในเครื่องกับอุปกรณ์ทีละรายการ

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

    ระบบจะละเว้นไฟล์ที่ซ่อนอยู่ (ชื่อขึ้นต้นด้วย ".")

    ตัวอย่างการใช้งาน: syncFiles("/tmp/files", "/sdcard") จะสร้างไดเรกทอรี /sdcard/files หากยังไม่มี และจะพุชเนื้อหา /tmp/files ไปยัง /sdcard/files แบบเรียกซ้ำ

    พารามิเตอร์
    localFileDir File: ไดเรกทอรีไฟล์ในเครื่องที่มีไฟล์ที่จะพุชแบบเรียกซ้ำ
    deviceFilePath String: รูทเส้นทางแบบเต็มของไฟล์ปลายทางระยะไกล ต้องอ่านได้ทุกไดเรกทอรีในเส้นทางไฟล์เหล่านั้น เช่น การพุชไปยัง /data/local/tmp เมื่อ adb ไม่ใช่รูท จะล้มเหลว
    คิกรีเทิร์น
    boolean true หากซิงค์ไฟล์สำเร็จ false หรือไม่เช่นนั้น
    การขว้าง
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

    ใช้รายงานข้อบกพร่องและส่งคืนภายในออบเจ็กต์ Bugreport เพื่อจัดการ แสดงผล null ในกรณีที่มีปัญหา ต้องล้างไฟล์ที่อ้างอิงในออบเจ็กต์ Bugreport ผ่าน Bugreport.close()

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

    uninstallPackage

    public String uninstallPackage (String packageName)

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

    พารามิเตอร์
    packageName String: แพ็กเกจ Android ที่จะถอนการติดตั้ง
    คิกรีเทิร์น
    String String พร้อมรหัสข้อผิดพลาด หรือ null หากสำเร็จ
    การขว้าง
    DeviceNotAvailableException

    uninstallPackageForUser

    public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

    public boolean unlockDevice ()

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

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

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

    unmountDebugfs

    public void unmountDebugfs ()

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

    การขว้าง
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

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

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

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

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

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

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

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

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

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

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

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

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

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

    การขว้าง
    DeviceNotAvailableException

    waitForDeviceFastbootD

    public void waitForDeviceFastbootD ()

    การขว้าง
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

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

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

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

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

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

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

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

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

    waitForDeviceOnline

    public void waitForDeviceOnline ()

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

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

    การขว้าง
    DeviceNotAvailableException

    waitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

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

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

    พารามิเตอร์
    waitTime long: เวลาที่รอเป็นมิลลิวินาที
    การขว้าง
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

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

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

    วิธีการที่ได้รับการป้องกัน

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

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

    buildAdbShellCommand

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

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

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

    forceExitStatusDetection boolean

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

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

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

    strictMinLevel int

    createRebootDeviceAction

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

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

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

    createRunUtil

    protected IRunUtil createRunUtil ()

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

    doAdbReboot

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

    ดำเนินการรีบูต adb

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

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

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

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

    getApiLevelSafe

    protected int getApiLevelSafe ()

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

    getLogger

    protected ITestLogger getLogger ()

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

    getRunUtil

    protected IRunUtil getRunUtil ()

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

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

    internalGetProperty

    protected String internalGetProperty (String propName, 
                String fastbootVar, 
                String description)

    ดึงข้อมูลพร็อพเพอร์ตี้ของอุปกรณ์จากแคช ddmlib โดยค่าเริ่มต้น และกลับไปใช้ `adb shell getprop` หรือ `fastboot getvar` ขึ้นอยู่กับว่าอุปกรณ์อยู่ใน Fastboot หรือไม่

    พารามิเตอร์
    propName String: ชื่อของพร็อพเพอร์ตี้อุปกรณ์ตามที่ส่งคืนโดย `adb shell getprop`
    fastbootVar String: ชื่อของตัวแปร fastboot ที่เทียบเท่าเพื่อค้นหา หาก null, fastboot จะไม่พยายามค้นหา
    description String: คำอธิบายตัวแปรอย่างง่าย ตัวอักษรแรกควรเป็นตัวพิมพ์ใหญ่
    คิกรีเทิร์น
    String สตริงซึ่งอาจเป็น null หรือว่างเปล่า ซึ่งมีค่าของพร็อพเพอร์ตี้ที่ระบุ
    การขว้าง
    DeviceNotAvailableException

    isInRebootCallback

    protected boolean isInRebootCallback ()

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

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

    isNewer

    protected boolean isNewer (File localFile, 
                IFileEntry entry)

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

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

    entry IFileEntry

    คิกรีเทิร์น
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

    แจ้งเตือน IDeviceActionReceiver ทั้งหมดเกี่ยวกับเหตุการณ์สิ้นสุดการรีบูต

    การขว้าง
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    notifyRebootStarted

    protected void notifyRebootStarted ()

    แจ้งเตือน IDeviceActionReceiver ทั้งหมดเกี่ยวกับเหตุการณ์การเริ่มต้นรีบูต

    การขว้าง
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    performDeviceAction

    protected boolean performDeviceAction (String actionDescription, 
                NativeDevice.DeviceAction action, 
                int retryAttempts)

    ดำเนินการในอุปกรณ์นี้ พยายามกู้คืนอุปกรณ์และลองส่งคำสั่งอีกครั้ง (ไม่บังคับ) หาก การดำเนินการล้มเหลว

    พารามิเตอร์
    actionDescription String: คำอธิบายสั้นๆ ของการดำเนินการที่จะทำ ใช้เพื่อการบันทึกเท่านั้น
    action NativeDevice.DeviceAction: การดำเนินการที่จะทำ
    retryAttempts int: ความพยายามในการลองใหม่เพื่อดำเนินการหากล้มเหลวแต่การกู้คืนสำเร็จ
    คิกรีเทิร์น
    boolean true หากดำเนินการสำเร็จ
    การขว้าง
    DeviceNotAvailableException หากการพยายามกู้คืนไม่สำเร็จหรือพยายามกู้คืนจนครบจำนวนครั้งสูงสุดโดยไม่ สำเร็จ

    postAdbReboot

    protected void postAdbReboot (NativeDevice.RebootMode rebootMode)

    การดำเนินการเพิ่มเติมที่อาจทำได้หลังจากการรีบูต

    พารามิเตอร์
    rebootMode NativeDevice.RebootMode

    การขว้าง
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    prePostBootSetup

    protected void prePostBootSetup ()

    อนุญาตให้ประเภทอุปกรณ์แต่ละประเภท (AndroidNativeDevice, TestDevice) ลบล้างวิธีการนี้สำหรับ การตั้งค่าเฉพาะหลังการบูต

    การขว้าง
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pullFileInternal

    protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

    พารามิเตอร์
    remoteFilePath String

    localFile File

    คิกรีเทิร์น
    boolean

    การขว้าง
    DeviceNotAvailableException

    setClock

    protected void setClock (Clock clock)

    ตั้งค่าอินสแตนซ์ Clock ที่จะใช้

    พารามิเตอร์
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    ทำเครื่องหมาย TestDevice เป็น microdroid และตั้งค่า CID

    พารามิเตอร์
    process Process: กระบวนการของ VM Microdroid

    setTestDeviceOptions

    protected void setTestDeviceOptions ( 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

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

    รอจนกว่าอุปกรณ์จะใช้งานไม่ได้ (หยุดรายงานไปยัง adb)

    พารามิเตอร์
    operationDesc String: ชื่อของการดำเนินการที่รอให้พร้อมใช้งาน
    time long: เวลาที่รอให้สถานะ "ไม่พร้อมให้บริการ" เกิดขึ้น
    คิกรีเทิร์น
    boolean เป็นจริงหากอุปกรณ์ไม่พร้อมใช้งาน