อุปกรณ์ที่มาพร้อมเครื่อง
public
class
NativeDevice
extends Object
implements
IManagedTestDevice,
IConfigurationReceiver,
ITestLoggerReceiver
java.lang.Object | |
↳ | com.android.tradefed.device.NativeDevice |
การใช้งานเริ่มต้นของอุปกรณ์ Android สแต็กที่ไม่เต็มรูปแบบ ITestDevice
เครื่อง
สรุป
ชั้นเรียนที่ซ้อนกัน | |
---|---|
class |
NativeDevice.AdbAction
|
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
ค่าคงที่ | |
---|---|
int |
INVALID_USER_ID
ค่าที่ส่งคืนสำหรับรหัสผู้ใช้ที่ไม่ถูกต้อง/ไม่พบ: UserHandle ได้กำหนดค่า -10000 |
long |
MAX_HOST_DEVICE_TIME_OFFSET
|
int |
MAX_RETRY_ATTEMPTS
จำนวนความพยายามตามคำสั่งอีกครั้งที่เป็นค่าเริ่มต้น |
ช่อง | |
---|---|
public
static
final
String |
DEBUGFS_PATH
|
protected
static
final
String |
SD_CARD
|
protected
static
final
String |
STORAGE_EMULATED
|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
ช่างก่อสร้างสาธารณะ | |
---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
สร้าง |
วิธีการสาธารณะ | |
---|---|
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(
เชื่อมต่อกับเครือข่าย Wi-Fi |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
เชื่อมต่อกับเครือข่าย Wi-Fi |
boolean
|
connectToWifiNetwork(
เชื่อมต่อกับเครือข่าย Wi-Fi |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
เชื่อมต่อกับเครือข่าย Wi-Fi |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
ตัวแปรของ |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
ตัวแปรของ |
int
|
createUser(String name, boolean guest, boolean ephemeral)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ระบุ |
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ระบุ |
int
|
createUser(String name)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0 |
int
|
createUserNoThrow(String name)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0 |
void
|
deleteFile(String deviceFilePath, int userId)
วิธีของตัวช่วยในการลบไฟล์หรือไดเรกทอรีในอุปกรณ์ |
void
|
deleteFile(String deviceFilePath)
วิธีของตัวช่วยในการลบไฟล์หรือไดเรกทอรีในอุปกรณ์ |
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
นำ |
boolean
|
deviceSoftRestarted(ProcessInfo prevSystemServerProcess)
วิธีการของตัวช่วยในการตรวจสอบว่าอุปกรณ์เริ่มต้นอีกครั้งหรือไม่โดยการเปรียบเทียบ system_server ปัจจุบันกับ system_server |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
เมธอดของตัวช่วยในการตรวจสอบว่าอุปกรณ์เริ่มใหม่แบบชั่วคราวหรือไม่ตั้งแต่เวลา UTC ตั้งแต่ Epoch จากอุปกรณ์และ |
boolean
|
disableAdbRoot()
ปิดราก adb |
void
|
disableKeyguard()
ความพยายามปิดใช้งานการล็อกปุ่ม |
boolean
|
disableNetworkMonitor()
ปิดใช้การตรวจสอบเครือข่ายในอุปกรณ์ |
boolean
|
disconnectFromWifi()
ยกเลิกการเชื่อมต่อกับเครือข่าย Wi-Fi |
boolean
|
doesFileExist(String deviceFilePath, int userId)
เมธอดของตัวช่วยในการระบุว่าผู้ใช้หนึ่งๆ มีไฟล์อยู่ในอุปกรณ์หรือไม่ |
boolean
|
doesFileExist(String deviceFilePath)
เมธอดของตัวช่วยในการตรวจสอบว่ามีไฟล์อยู่ในอุปกรณ์หรือไม่ |
File
|
dumpHeap(String process, String devicePath)
พยายามดัมพ์ฮีปจาก system_server |
boolean
|
enableAdbRoot()
เปิดราก adb |
boolean
|
enableNetworkMonitor()
เปิดใช้การตรวจสอบเครือข่ายในอุปกรณ์ |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบโดยมีระยะหมดเวลาที่ระบุไว้ |
String
|
executeAdbCommand(long timeout,
เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบโดยมีระยะหมดเวลาที่ระบุไว้ |
String
|
executeAdbCommand(String... cmdArgs)
เมธอด Helper ซึ่งเรียกใช้คำสั่ง adb เป็นคำสั่งของระบบ |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
เมธอด Helper ที่เรียกใช้คำสั่ง Fastboot เป็นคําสั่งระบบโดยมีระยะหมดเวลาเริ่มต้น 2 นาที |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
เมธอด Helper ที่เรียกใช้คำสั่ง Fastboot เป็นคําสั่งระบบ |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
เมธอด Helper ซึ่งเรียกใช้คำสั่ง Fastboot ที่ใช้เวลานานเป็นคำสั่งของระบบ |
CommandResult
|
executeLongFastbootCommand(
เมธอด Helper ซึ่งเรียกใช้คำสั่ง Fastboot ที่ใช้เวลานานเป็นคําสั่งของระบบพร้อมกับตัวแปรสภาพแวดล้อมของระบบ |
String
|
executeShellCommand(String command)
เมธอด Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลเอาต์พุตเป็น |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
เรียกใช้คำสั่งเชลล์ adb ที่กำหนด ลองใหม่หลายครั้งหากคำสั่งล้มเหลว |
CommandResult
|
executeShellV2Command(String cmd)
เมธอดของตัวช่วยที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น |
CommandResult
|
executeShellV2Command(String cmd, OutputStream pipeToOutput)
เมธอดของ Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
เมธอดของตัวช่วยที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง |
CommandResult
|
fastbootWipePartition(String partition)
เมธอดของตัวช่วยที่จะล้างข้อมูลพาร์ติชันสำหรับอุปกรณ์ |
|
getActiveApexes()
ดึงข้อมูลเกี่ยวกับ APEX ที่เปิดใช้งานในอุปกรณ์ |
|
getAllSettings(String namespace)
แสดงผลคู่คีย์-ค่าของเนมสเปซที่ขอ |
DeviceAllocationState
|
getAllocationState()
แสดงสถานะการจัดสรรปัจจุบันของอุปกรณ์ |
String
|
getAndroidId(int userId)
ค้นหาและแสดงผล android-id ที่เชื่อมโยงกับ userId หากไม่พบ |
|
getAndroidIds()
สร้างแผนที่รหัส Android ที่พบรหัสผู้ใช้ที่ตรงกัน |
int
|
getApiLevel()
รับระดับ API ของอุปกรณ์ |
PackageInfo
|
getAppPackageInfo(String packageName)
ดึงข้อมูลเกี่ยวกับแพ็กเกจที่ติดตั้งในอุปกรณ์ |
|
getAppPackageInfos()
ดึงข้อมูลของแพ็กเกจที่ติดตั้งในอุปกรณ์ |
String
|
getBasebandVersion()
วิธีการที่สะดวกในการรับเวอร์ชันเบสแบนด์ (วิทยุ) ของอุปกรณ์นี้ |
Integer
|
getBattery()
แสดงระดับแบตเตอรี่ปัจจุบันของอุปกรณ์หรือ Null หากไม่มีระดับแบตเตอรี่ |
boolean
|
getBooleanProperty(String name, boolean defaultValue)
แสดงผลค่าบูลีนของพร็อพเพอร์ตี้ที่ระบุ |
|
getBootHistory()
เมธอด Helper จะรวบรวมแมปประวัติการเปิดเครื่องพร้อมเวลาเปิดเครื่องและเหตุผลที่เปิดเครื่อง |
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
เมธอด Helper จะรวบรวมแมปประวัติการเปิดเครื่องพร้อมเวลาเปิดเครื่องและเหตุผลที่เปิดเครื่องตั้งแต่เวลาที่ระบุตั้งแต่ Epoch จากอุปกรณ์และหน่วยเวลาที่ระบุ |
String
|
getBootloaderVersion()
วิธีการที่สะดวกในการรับเวอร์ชันของ Bootloader ของอุปกรณ์นี้ |
InputStreamSource
|
getBugreport()
เรียกรายงานข้อบกพร่องจากอุปกรณ์ |
InputStreamSource
|
getBugreportz()
ดึง Bugreportz จากอุปกรณ์ |
String
|
getBuildAlias()
เรียกข้อมูลชื่อแทนของบิลด์ที่อุปกรณ์ทำงานอยู่ |
String
|
getBuildFlavor()
เรียกข้อมูลเวอร์ชันบิลด์ของอุปกรณ์ |
String
|
getBuildId()
ดึงข้อมูลบิลด์ที่อุปกรณ์กำลังทำงานอยู่ |
String
|
getBuildSigningKeys()
แสดงประเภทคีย์ที่ใช้ในการลงนามรูปภาพของอุปกรณ์ โดยทั่วไปอุปกรณ์ Android อาจมีการรับรองด้วยคีย์ทดสอบ (เช่น ใน AOSP) หรือคีย์การเผยแพร่ (ควบคุมโดยผู้ผลิตอุปกรณ์แต่ละราย) |
DeviceDescriptor
|
getCachedDeviceDescriptor()
แสดงผล |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
แสดงผล |
String[]
|
getChildren(String path)
ทางเลือกในการใช้ |
AbstractConnection
|
getConnection()
การเชื่อมต่อปัจจุบันที่เชื่อมโยงกับอุปกรณ์ |
ContentProviderHandler
|
getContentProvider(int userId)
แสดงผล |
DeviceFoldableState
|
getCurrentFoldableState()
แสดงผลสถานะปัจจุบันของอุปกรณ์หรือค่า Null หากเกิดปัญหาขึ้น |
int
|
getCurrentUser()
แสดงผล ID ของผู้ใช้ปัจจุบันที่กำลังทำงานอยู่ |
String
|
getDeviceClass()
ดูคลาสของอุปกรณ์ |
long
|
getDeviceDate()
แสดงวันที่ของอุปกรณ์เป็นมิลลิวินาทีตั้งแต่ Epoch |
DeviceDescriptor
|
getDeviceDescriptor()
แสดง |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
แสดง |
TestDeviceState
|
getDeviceState()
ดูสถานะของอุปกรณ์ |
long
|
getDeviceTimeOffset(Date date)
ผู้ช่วยในการดูความแตกต่างของเวลาระหว่างอุปกรณ์กับ |
InputStreamSource
|
getEmulatorOutput()
รับสตรีมโปรแกรมจำลอง stdout และ stderr |
Process
|
getEmulatorProcess()
แสดงผล |
final
File
|
getExecuteShellCommandLog()
บันทึกที่มีบันทึก |
long
|
getExternalStoreFreeSpace()
วิธีของตัวช่วยระบุปริมาณพื้นที่ว่างในที่จัดเก็บข้อมูลภายนอกของอุปกรณ์ |
String
|
getFastbootPath()
แสดงผลเส้นทางของไบนารี Fastboot ที่ใช้ |
String
|
getFastbootProductType()
วิธีที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้เมื่ออยู่ใน Fastboot Mode |
String
|
getFastbootProductVariant()
วิธีที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้เมื่ออยู่ใน Fastboot Mode |
String
|
getFastbootSerialNumber()
แสดงหมายเลขซีเรียล Fastboot Mode |
String
|
getFastbootVariable(String variableName)
ดึงค่าตัวแปร Fastboot ที่ระบุจากอุปกรณ์ |
String
|
getFastbootVersion()
แสดงผลสตริงเวอร์ชันของไบนารี Fastboot ที่ใช้ |
IFileEntry
|
getFileEntry(String path)
ดึงข้อมูลการอ้างอิงไปยังไฟล์ระยะไกลในอุปกรณ์ |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
ผู้ช่วยอย่างไม่เป็นทางการในการรับ |
|
getFoldableStates()
แสดงรายการสถานะพับได้ในอุปกรณ์ |
IDevice
|
getIDevice()
แสดงผลการอ้างอิงไปยัง |
|
getInstalledPackageNames()
ดึงข้อมูลชื่อแพ็กเกจของแอปพลิเคชันที่มีอยู่ในอุปกรณ์ |
long
|
getIntProperty(String name, long defaultValue)
แสดงผลค่าจำนวนเต็มของคุณสมบัติที่ระบุจากอุปกรณ์ |
String
|
getIpAddress()
รับที่อยู่ IP ของอุปกรณ์ |
KeyguardControllerState
|
getKeyguardState()
แสดงผลออบเจ็กต์เพื่อรับสถานะปัจจุบันของคีย์การ์ดหรือ Null หากไม่รองรับ |
long
|
getLastExpectedRebootTimeMillis()
แสดงผลเวลาล่าสุดที่ Tradefed API ที่ทริกเกอร์การรีบูตในหน่วยมิลลิวินาทีตั้งแต่ EPOCH ที่แสดงผลโดย |
int
|
getLaunchApiLevel()
รับระดับ API ที่เปิดใช้งานครั้งแรกของอุปกรณ์ |
InputStreamSource
|
getLogcat()
ดึงสตรีมสแนปชอตของข้อมูล Logcat |
InputStreamSource
|
getLogcat(int maxBytes)
จับสตรีมสแนปชอตของ |
InputStreamSource
|
getLogcatDump()
รับดัมพ์ของ Logcat ปัจจุบันสำหรับอุปกรณ์ |
InputStreamSource
|
getLogcatSince(long date)
ดึงสตรีมสแนปชอตของข้อมูล Logcat ที่บันทึกไว้โดยเริ่มตั้งแต่วันที่ที่ระบุ |
String
|
getMacAddress()
แสดงผลที่อยู่ MAC ของอุปกรณ์ ค่าว่างในกรณีที่ค้นหาจากอุปกรณ์ไม่สำเร็จ |
Integer
|
getMainUserId()
แสดงผล User-ID หลัก |
|
getMainlineModuleInfo()
ดูข้อมูลเกี่ยวกับโมดูลเมนไลน์ที่ติดตั้งในอุปกรณ์ |
int
|
getMaxNumberOfRunningUsersSupported()
รับจำนวนผู้ใช้งานพร้อมกันที่รองรับสูงสุด |
int
|
getMaxNumberOfUsersSupported()
รับจํานวนผู้ใช้ที่รองรับสูงสุด |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
ส่งคืน |
String
|
getMountPoint(String mountName)
แสดงผลจุดต่อเชื่อม |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
แสดงผล |
|
getMountPointInfo()
ส่งคืนข้อมูลเวอร์ชันแยกวิเคราะห์ใน /proc/mounts บนอุปกรณ์ |
TestDeviceOptions
|
getOptions()
ดึงข้อมูลตัวเลือกการทดสอบสำหรับอุปกรณ์ |
long
|
getPartitionFreeSpace(String partition)
เมธอด Helper เพื่อกำหนดพื้นที่ว่างในพาร์ติชันอุปกรณ์ |
Integer
|
getPrimaryUserId()
แสดงผล User-ID หลัก |
ProcessInfo
|
getProcessByName(String processName)
เมธอด Helper จะเรียกใช้คำสั่ง "pidof" และ "stat" และแสดงผลออบเจ็กต์ |
String
|
getProcessPid(String process)
แสดงผล PID ของบริการหรือ Null หากเกิดข้อผิดพลาด |
String
|
getProductType()
วิธีการที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้ |
String
|
getProductVariant()
วิธีการที่สะดวกในการรับรายละเอียดปลีกย่อยของผลิตภัณฑ์ของอุปกรณ์นี้ |
String
|
getProperty(String name)
ดึงข้อมูลค่าคุณสมบัติที่ระบุจากอุปกรณ์ |
ITestDevice.RecoveryMode
|
getRecoveryMode()
รับโหมดการกู้คืนปัจจุบันที่ใช้สำหรับอุปกรณ์ |
InputStreamSource
|
getScreenshot(String format)
ดึงภาพหน้าจอจากอุปกรณ์ |
InputStreamSource
|
getScreenshot(long displayId)
ดึงภาพหน้าจอจากอุปกรณ์ที่ระบุรหัสการแสดงผล |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
ดึงภาพหน้าจอจากอุปกรณ์ |
InputStreamSource
|
getScreenshot()
ดึงภาพหน้าจอจากอุปกรณ์ |
String
|
getSerialNumber()
วิธีการที่สะดวกในการรับหมายเลขซีเรียลของอุปกรณ์นี้ |
String
|
getSetting(int userId, String namespace, String key)
แสดงผลค่าของการตั้งค่าที่ขอ |
String
|
getSetting(String namespace, String key)
ดู |
String
|
getSimOperator()
ส่งคืนผู้ให้บริการซิมการ์ดหรือค่า Null หากไม่มีหรืออุปกรณ์ไม่พร้อมใช้งาน |
String
|
getSimState()
แสดงสถานะซิมการ์ดหรือค่าว่างหากไม่มีหรืออุปกรณ์ไม่พร้อมใช้งาน |
|
getTombstones()
ดึงข้อมูลและส่งคืนรายการ Tombstone จากอุปกรณ์ต่างๆ |
long
|
getTotalMemory()
แสดงขนาดหน่วยความจำทางกายภาพทั้งหมดเป็นไบต์หรือ -1 ในกรณีที่เกิดข้อผิดพลาดภายใน |
|
getUninstallablePackageNames()
เรียกชื่อแพ็กเกจแอปพลิเคชันที่สามารถถอนการติดตั้งได้ |
boolean
|
getUseFastbootErase()
รับว่าจะใช้รูปแบบ Fastboot Delete หรือ Fastboot เพื่อล้างข้อมูลพาร์ติชันในอุปกรณ์หรือไม่ |
int
|
getUserFlags(int userId)
ค้นหาและแสดงธงของผู้ใช้ที่ต้องการ |
|
getUserInfos()
เรียกดูแมปของ useId ไปยัง |
int
|
getUserSerialNumber(int userId)
แสดงผลหมายเลขซีเรียลที่เชื่อมโยงกับ userId หากพบ ซึ่งก็คือ -10000 ในกรณีอื่นๆ |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
ประมวลผล DeviceEvent ที่ระบุ ประมวลผล DeviceEvent ซึ่งอาจเปลี่ยนหรือไม่เปลี่ยนอุปกรณ์นี้เป็นสถานะการจัดสรรใหม่ |
boolean
|
hasFeature(String feature)
ตรวจสอบว่าฟีเจอร์พร้อมใช้งานในอุปกรณ์หรือไม่ |
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์ |
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์ |
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์สำหรับผู้ใช้ที่กำหนด |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์สำหรับผู้ใช้ที่กำหนด |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการแจกแจงแอปหรือไม่ |
boolean
|
isBypassLowTargetSdkBlockSupported()
ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการข้ามการบล็อก SDK เป้าหมายต่ำในการติดตั้งแอปหรือไม่ |
boolean
|
isDebugfsMounted()
ตรวจสอบว่าได้ต่อเชื่อม debugf หรือไม่ |
boolean
|
isDeviceEncrypted()
แสดงผลหากอุปกรณ์เข้ารหัส |
boolean
|
isDirectory(String path)
แสดงผล "จริง" หากเส้นทางในอุปกรณ์เป็นไดเรกทอรี มิเช่นนั้นจะเป็น "เท็จ" |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
แสดงผลหากอุปกรณ์รองรับการเข้ารหัส |
boolean
|
isExecutable(String fullPath)
แสดงผลเป็น "จริง" หากเส้นทางของไฟล์ในอุปกรณ์เป็นไฟล์ปฏิบัติการ หรือเป็นเท็จ |
boolean
|
isFastbootEnabled()
แสดงผลหาก Fastboot พร้อมใช้งานสำหรับอุปกรณ์ |
boolean
|
isHeadless()
แสดงผลเป็น "จริง" หากอุปกรณ์ไม่มีส่วนหัว (ไม่มีหน้าจอ) หรือเป็นเท็จ |
boolean
|
isHeadlessSystemUserMode()
แสดงผลว่าอุปกรณ์ใช้โหมดผู้ใช้ระบบแบบไม่มีส่วนหัวหรือไม่ |
boolean
|
isMainUserPermanentAdmin()
จะแสดงผลว่าผู้ใช้หลักเป็นผู้ดูแลระบบแบบถาวร และจะลบหรือดาวน์เกรดเป็นสถานะที่ไม่ใช่ผู้ดูแลระบบไม่ได้ |
boolean
|
isMultiUserSupported()
กำหนดว่ารองรับผู้ใช้หลายคนหรือไม่ |
boolean
|
isPackageInstalled(String packageName, String userId)
ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจและรหัสผู้ใช้ที่กำหนดเพื่อตรวจสอบว่าอุปกรณ์ได้รับการติดตั้งอยู่หรือไม่สำหรับผู้ใช้รายนั้น |
boolean
|
isPackageInstalled(String packageName)
ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจที่ระบุเพื่อตรวจสอบว่าอุปกรณ์ติดตั้งอยู่หรือไม่ |
boolean
|
isRuntimePermissionSupported()
ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการให้สิทธิ์รันไทม์หรือไม่ |
boolean
|
isStateBootloaderOrFastbootd()
แสดงค่า "จริง" หากอุปกรณ์อยู่ใน |
boolean
|
isUserRunning(int userId)
ตรวจสอบว่าผู้ใช้ที่กำหนดกำลังทำงานอยู่หรือไม่ |
boolean
|
isUserSecondary(int userId)
แสดงผลว่าผู้ใช้ที่ระบุเป็นผู้ใช้รองตามการแจ้งว่าไม่เหมาะสมหรือไม่ |
boolean
|
isUserVisible(int userId)
ตรวจสอบว่าผู้ใช้ที่ระบุมองเห็นได้หรือไม่ |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
ตรวจสอบว่าผู้ใช้ที่ระบุปรากฏในจอแสดงผลหรือไม่ |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
แสดงผลว่าอุปกรณ์อนุญาตให้ผู้ใช้เริ่มแสดงการทำงานในเบื้องหลังหรือไม่ใน |
boolean
|
isVisibleBackgroundUsersSupported()
แสดงผลว่าอุปกรณ์อนุญาตให้เริ่มแสดงผู้ใช้ในเบื้องหลังหรือไม่ |
boolean
|
isWifiEnabled()
ทดสอบว่าเปิดใช้ Wi-Fi อยู่หรือไม่ |
|
listDisplayIds()
รวบรวมรายการรหัสแสดงที่มีอยู่ในอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger" |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
รับรายการจอแสดงผลที่ใช้เพื่อ |
|
listUsers()
รับรายชื่อผู้ใช้ในอุปกรณ์ |
boolean
|
logAnrs(ITestLogger logger)
รวบรวมและบันทึก ANR จากอุปกรณ์ |
boolean
|
logBugreport(String dataName, ITestLogger listener)
วิธีการของตัวช่วยในการรับรายงานข้อบกพร่องและบันทึกรายงานให้ผู้รายงาน |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
บันทึกข้อความใน Logcat ของอุปกรณ์ |
void
|
mountDebugfs()
ต่อเชื่อม debugf |
void
|
nonBlockingReboot()
ออกคำสั่งให้รีบูตอุปกรณ์และส่งคืนเมื่อคำสั่งเสร็จสมบูรณ์ และเมื่ออุปกรณ์ไม่แสดงต่อ adb อีกต่อไป |
void
|
postAdbRootAction()
ลบล้างในกรณีที่อุปกรณ์ต้องดำเนินการบางอย่างหลังจากรูท adb และก่อนที่อุปกรณ์จะออนไลน์อีกครั้ง |
void
|
postAdbUnrootAction()
ลบล้างในกรณีที่อุปกรณ์จำเป็นต้องดำเนินการบางอย่างหลังจากยกเลิกการรูทและก่อนที่อุปกรณ์จะออนไลน์อีกครั้ง |
void
|
postBootSetup()
ทำตามวิธีการกำหนดค่าอุปกรณ์สำหรับการทดสอบหลังจากเปิดเครื่องทุกครั้ง |
void
|
postInvocationTearDown(Throwable exception)
ขั้นตอนเพิ่มเติมสำหรับการทำความสะอาดที่จำเป็นเฉพาะอุปกรณ์ซึ่งจะดำเนินการหลังจากการเรียกใช้เสร็จสิ้นแล้ว |
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
ขั้นตอนเพิ่มเติมสำหรับการตั้งค่าที่จำเป็นเฉพาะอุปกรณ์ซึ่งจะดำเนินการในอุปกรณ์ก่อนขั้นตอนการเรียกใช้ |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์ซ้ำๆ |
boolean
|
pullDir(String deviceFilePath, File localDir)
ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์ซ้ำๆ |
boolean
|
pullFile(String remoteFilePath, File localFile)
ดึงข้อมูลไฟล์ออกจากอุปกรณ์ |
File
|
pullFile(String remoteFilePath, int userId)
เรียกดูไฟล์จากอุปกรณ์ จัดเก็บไว้ใน |
File
|
pullFile(String remoteFilePath)
เรียกดูไฟล์จากอุปกรณ์ จัดเก็บไว้ใน |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
ดึงข้อมูลไฟล์ออกจากอุปกรณ์ |
String
|
pullFileContents(String remoteFilePath)
ดึงไฟล์ออกจากอุปกรณ์ และแสดงเนื้อหา |
File
|
pullFileFromExternal(String remoteFilePath)
วิธีที่สะดวกในการดึงข้อมูลไฟล์จากพื้นที่เก็บข้อมูลภายนอกของอุปกรณ์ จัดเก็บไฟล์ไว้ใน |
boolean
|
pushDir(File localFileDir, String deviceFilePath,
พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์ซ้ำๆ ขณะที่ยกเว้นบางไดเรกทอรีที่มีการกรอง |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์ซ้ำ |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์ซ้ำ |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
ตัวแปรของ |
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 โดยใช้ |
void
|
reboot()
รีบูตอุปกรณ์ให้เข้าสู่โหมด adb |
void
|
rebootIntoBootloader()
รีบูตอุปกรณ์ให้เข้าสู่โหมด Bootloader |
void
|
rebootIntoFastbootd()
รีบูตอุปกรณ์ให้เข้าสู่ Fastbootd Mode |
void
|
rebootIntoRecovery()
รีบูตอุปกรณ์ให้เข้าสู่โหมดการกู้คืน adb |
void
|
rebootIntoSideload()
รีบูตอุปกรณ์ให้เข้าสู่โหมด adb Sideload (โปรดทราบว่านี่เป็นโหมดพิเศษที่อยู่ภายใต้การกู้คืน) บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดโหลดจากแหล่งที่ไม่รู้จัก |
void
|
rebootIntoSideload(boolean autoReboot)
รีบูตอุปกรณ์ให้เข้าสู่โหมด adb Sideload (โปรดทราบว่านี่เป็นโหมดพิเศษที่อยู่ภายใต้การกู้คืน) บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดโหลดจากแหล่งที่ไม่รู้จัก |
void
|
rebootUntilOnline()
ทางเลือกเป็น |
void
|
rebootUntilOnline(String reason)
ทางเลือกเป็น |
void
|
rebootUserspace()
รีบูตเฉพาะส่วนพื้นที่ผู้ใช้ของอุปกรณ์ |
void
|
rebootUserspaceUntilOnline()
ทางเลือกของ |
boolean
|
recoverDevice()
ความพยายามที่จะกู้คืนการสื่อสารกับอุปกรณ์ |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
ลงทะเบียน |
void
|
remountSystemReadOnly()
กำหนดให้พาร์ติชันระบบในอุปกรณ์เป็นแบบอ่านอย่างเดียว |
void
|
remountSystemWritable()
ทำให้พาร์ติชันระบบในอุปกรณ์เขียนได้ |
void
|
remountVendorReadOnly()
กำหนดพาร์ติชันผู้ให้บริการในอุปกรณ์เป็นแบบอ่านอย่างเดียว |
void
|
remountVendorWritable()
ทำให้พาร์ติชันผู้ให้บริการในอุปกรณ์เขียนได้ |
boolean
|
removeAdmin(String componentName, int userId)
นำผู้ดูแลระบบอุปกรณ์ที่กำหนดในผู้ใช้รายนั้นออก แล้วแสดงผล |
void
|
removeOwners()
นำเจ้าของโปรไฟล์อุปกรณ์ที่มีอยู่ทั้งหมดออกอย่างดีที่สุด |
boolean
|
removeUser(int userId)
นำผู้ใช้ที่ระบุออกจากอุปกรณ์ |
void
|
resetContentProviderSetup()
รีเซ็ตธงของการตั้งค่าผู้ให้บริการเนื้อหาเพื่อให้ทริกเกอร์อีกครั้ง |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
วิธีการที่สะดวกในการทำ |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
ทดสอบการใช้เครื่องมือและกู้คืนอุปกรณ์ |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
เหมือนกับ |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
เหมือนกับ |
void
|
setConfiguration(IConfiguration configuration)
แทรก |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
ตั้งค่าวันที่ในอุปกรณ์ หมายเหตุ: การตั้งค่าวันที่ในอุปกรณ์จำเป็นต้องรูท |
boolean
|
setDeviceOwner(String componentName, int userId)
ตั้งคอมโพเนนต์ผู้ดูแลระบบอุปกรณ์เป็นเจ้าของอุปกรณ์ในผู้ใช้ที่กำหนด |
void
|
setDeviceState(TestDeviceState deviceState)
อัปเดตสถานะของอุปกรณ์ |
void
|
setEmulatorOutputStream(SizeLimitedOutputStream output)
สำหรับโปรแกรมจำลอง ให้ตั้งค่า |
void
|
setEmulatorProcess(Process p)
ตั้งค่า |
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)
ตั้งค่า |
boolean
|
setProperty(String propKey, String propValue)
ตั้งค่าพร็อพเพอร์ตี้ที่ระบุในอุปกรณ์ |
void
|
setRecovery(IDeviceRecovery recovery)
ตั้งค่า |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
ตั้งค่าโหมดการกู้คืนปัจจุบันเพื่อใช้กับอุปกรณ์ |
void
|
setSetting(String namespace, String key, String value)
ดู |
void
|
setSetting(int userId, String namespace, String key, String value)
เพิ่มค่าการตั้งค่าไปยังเนมสเปซของผู้ใช้ที่กำหนด |
void
|
setTestLogger(ITestLogger testLogger)
แทรกอินสแตนซ์ |
void
|
setUseFastbootErase(boolean useFastbootErase)
ตั้งค่าว่าจะใช้รูปแบบ Fastboot หากต้องการลบหรือ Fastboot เพื่อล้างข้อมูลพาร์ติชันในอุปกรณ์ |
void
|
startLogcat()
เริ่มบันทึกเอาต์พุต Logcat จากอุปกรณ์ในเบื้องหลัง |
boolean
|
startUser(int userId)
เริ่มต้นผู้ใช้หนึ่งๆ ในพื้นหลังหากหยุดทำงานอยู่ |
boolean
|
startUser(int userId, boolean waitFlag)
เริ่มต้นผู้ใช้หนึ่งๆ ในพื้นหลังหากหยุดทำงานอยู่ |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
เริ่มใช้งานผู้ใช้ที่กำหนดในเบื้องหลัง ซึ่งมองเห็นได้ในจอแสดงผลที่กำหนด (ซึ่งอนุญาตให้ผู้ใช้เปิดกิจกรรมในจอแสดงผลนั้น) |
void
|
stopEmulatorOutput()
ปิดและลบเอาต์พุตของโปรแกรมจำลอง |
void
|
stopLogcat()
หยุดบันทึกเอาต์พุต Logcat จากอุปกรณ์และทิ้งข้อมูล Logcat ที่บันทึกไว้ในปัจจุบัน |
boolean
|
stopUser(int userId)
หยุดผู้ใช้ที่กำหนด |
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
หยุดผู้ใช้ที่กำหนด |
String
|
switchToAdbTcp()
เปลี่ยนอุปกรณ์เป็นโหมด adb-over-tcp |
boolean
|
switchToAdbUsb()
เปลี่ยนอุปกรณ์เป็น adb ผ่านโหมด USB |
boolean
|
switchUser(int userId)
เปลี่ยนเป็น userId อื่นที่มีระยะหมดเวลาเริ่มต้น |
boolean
|
switchUser(int userId, long timeout)
เปลี่ยนไปใช้รหัสผู้ใช้อื่นโดยกำหนดระยะหมดเวลาที่กำหนดไว้เป็นกำหนดเวลา |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
ซิงค์เนื้อหาของไดเรกทอรีไฟล์ในเครื่องบางส่วนกับอุปกรณ์ |
Bugreport
|
takeBugreport()
รับรายงานข้อบกพร่องและส่งคืนภายในออบเจ็กต์ |
String
|
uninstallPackage(String packageName)
ถอนการติดตั้งแพ็กเกจ Android จากอุปกรณ์ |
String
|
uninstallPackageForUser(String packageName, int userId)
ถอนการติดตั้งแพ็กเกจ Android จากผู้ใช้รายหนึ่งๆ ออกจากอุปกรณ์ |
boolean
|
unlockDevice()
ปลดล็อกอุปกรณ์หากอุปกรณ์อยู่ในสถานะเข้ารหัส |
void
|
unmountDebugfs()
ยกเลิกการต่อเชื่อม debugf |
boolean
|
waitForBootComplete(long timeOut)
บล็อกจนกว่าจะมีการตั้งค่าสถานะการเปิดเครื่องของอุปกรณ์เสร็จสมบูรณ์ |
boolean
|
waitForDeviceAvailable()
รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ |
boolean
|
waitForDeviceAvailable(long waitTime)
รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ |
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
รอให้อุปกรณ์ตอบสนองและพร้อมใช้งานโดยไม่คำนึงถึงเส้นทางการกู้คืน |
void
|
waitForDeviceBootloader()
บล็อกจนกว่าอุปกรณ์จะมองเห็นได้ผ่าน Fastboot |
boolean
|
waitForDeviceInRecovery(long waitTime)
การบล็อกสำหรับอุปกรณ์ให้อยู่ในสถานะ "การกู้คืน adb" (โปรดทราบว่าจะแตกต่างจาก |
boolean
|
waitForDeviceInSideload(long waitTime)
การบล็อกสำหรับอุปกรณ์ให้อยู่ในสถานะ "adb ไซด์โหลด" |
boolean
|
waitForDeviceNotAvailable(long waitTime)
การบล็อกอุปกรณ์ไม่พร้อมใช้งานเนื่องจากขาดหายไปจาก adb |
void
|
waitForDeviceOnline()
บล็อกจนกว่าอุปกรณ์จะแสดงผ่าน adb |
void
|
waitForDeviceOnline(long waitTime)
บล็อกจนกว่าอุปกรณ์จะแสดงผ่าน adb |
boolean
|
waitForDeviceShell(long waitTime)
รอให้อุปกรณ์ตอบสนองต่อคำสั่งเชลล์ adb พื้นฐาน |
วิธีการป้องกัน | |
---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection)
สร้างคำสั่งระบบปฏิบัติการสำหรับเซสชันคำสั่งเชลล์ adb และอาร์กิวเมนต์ที่ระบุ |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
สร้าง |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
ทำการรีบูต adb |
void
|
ensureRuntimePermissionSupported()
เมธอด Helper ในการส่งข้อยกเว้นหากไม่รองรับสิทธิ์รันไทม์ |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
รับอินสแตนซ์ |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
|
String
|
internalGetProperty(String propName, String fastbootVar, String description)
ดึงข้อมูลพร็อพเพอร์ตี้ของอุปกรณ์จากแคช ddmlib โดยค่าเริ่มต้น แล้วกลับไปใช้ "adb shell getprop" หรือ "fastboot getvar" โดยขึ้นอยู่กับว่าอุปกรณ์อยู่ใน Fastboot หรือไม่ |
boolean
|
isInRebootCallback()
แสดงผลว่ากำลังมีการดำเนินการเรียกการรีบูตหรือไม่ |
boolean
|
isNewer(File localFile, IFileEntry entry)
แสดงผล |
void
|
notifyRebootEnded()
แจ้ง |
void
|
notifyRebootStarted()
แจ้ง |
boolean
|
performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
ทำงานในอุปกรณ์นี้ |
void
|
postAdbReboot()
การดำเนินการเพิ่มเติมที่อาจทำได้หลังจากการรีบูต |
void
|
prePostBootSetup()
อนุญาตให้อุปกรณ์แต่ละประเภท (AndroidNativeDevice, TestDevice) ลบล้างเมธอดนี้สำหรับ การตั้งค่าหลังการเปิดเครื่องที่เจาะจง |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
ตั้งค่าอินสแตนซ์ของนาฬิกาที่จะใช้ |
void
|
setMicrodroidProcess(Process process)
ทำเครื่องหมาย TestDevice เป็น Microdroid และกำหนด CID |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
เรียกใช้คำสั่ง Fastboot ง่ายๆ กับตัวแปรสภาพแวดล้อมและรายงานสถานะของคําสั่ง |
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
เรียกใช้คำสั่ง Fastboot ง่ายๆ และรายงานสถานะของคําสั่ง |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
รอดูว่าอุปกรณ์ไม่พร้อมใช้งาน (หยุดการรายงานไปยัง adb) |
ค่าคงที่
รหัสผู้ใช้ไม่ถูกต้อง
public static final int INVALID_USER_ID
ค่าที่ส่งคืนสำหรับรหัสผู้ใช้ที่ไม่ถูกต้อง/ไม่พบ: UserHandle ได้กำหนดค่า -10000
ค่าคงที่: -10000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
ค่าคงที่: 5000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
จำนวนความพยายามตามคำสั่งอีกครั้งที่เป็นค่าเริ่มต้น
ค่าคงที่: 2 (0x00000002)
ช่อง
DEBUGFS_PATH
public static final String DEBUGFS_PATH
การ์ด SD
protected static final String SD_CARD
STORAGE_EMULATED
protected static final String STORAGE_EMULATED
ช่างก่อสร้างสาธารณะ
อุปกรณ์ที่มาพร้อมเครื่อง
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
สร้าง TestDevice
พารามิเตอร์ | |
---|---|
device |
IDevice : IDevice ที่เชื่อมโยง |
stateMonitor |
IDeviceStateMonitor : กลไก IDeviceStateMonitor ที่จะใช้ |
allocationMonitor |
IDeviceMonitor : IDeviceMonitor เพื่อแจ้งการเปลี่ยนแปลงสถานะการจัดสรร
อาจเป็นค่าว่าง |
วิธีการสาธารณะ
BundlePrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
การเพิ่มประสิทธิภาพย่อย (ประมาณ 400 มิลลิวินาที) โดยการดึงข้อมูลอุปกรณ์ประกอบทั้งหมดที่เราต้องการแทนการเรียกใช้ "adb getprop" สำหรับแต่ละรายการ เช่น การดึงข้อมูลพร็อพเพอร์ตี้ทั้งหมดทำได้เร็วพอๆ กับการดึงข้อมูลพร็อพเพอร์ตี้ 1 รายการ เช่น device.getApiLevel(), checkApiLevelAgainstNextRelease และ getBuildAlias เรียก "adb getprop" ให้มากขึ้นด้วย เราจะดึงข้อมูลในการโทรครั้งเดียวและเรียก NativeDevice.setProperty แม้ว่าเราจะไม่ดำเนินการดังกล่าว แต่ NativeDevice จะเรียกใช้ setProperty และแคชผลลัพธ์สำหรับการเรียกในอนาคตไว้ด้วยเช่นกัน เราเพิ่งดำเนินการไปไม่นาน หากอุปกรณ์อยู่ระหว่างการกู้คืนหรือมีข้อผิดพลาดอื่นๆ ในการดึงข้อมูลอุปกรณ์ประกอบฉาก เราก็ไม่ต้องสนใจอุปกรณ์เหล่านั้น
ผู้ใช้ระบบเปลี่ยนส่วนหัวได้
public boolean canSwitchToHeadlessSystemUser ()
แสดงผลว่าจะอนุญาตให้เปลี่ยนไปใช้ผู้ใช้ SYSTEM แบบไม่มีส่วนหัวหรือไม่
คิกรีเทิร์น | |
---|---|
boolean |
การขว้าง | |
---|---|
DeviceNotAvailableException |
checkApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
ตรวจสอบว่าปัจจุบันมีฟีเจอร์ที่ได้รับการสนับสนุนในระดับที่สนับสนุนน้อยที่สุดหรือไม่ เมธอดนี้จะคํานึงถึงฟีเจอร์ที่ยังไม่ได้เปิดตัวก่อนที่จะเพิ่มระดับ API
พารามิเตอร์ | |
---|---|
strictMinLevel |
int : ระดับขั้นต่ำที่เป็นไปได้ซึ่งรองรับฟีเจอร์นี้ |
คิกรีเทิร์น | |
---|---|
boolean |
เป็นจริงหากระบบรองรับระดับ เป็นเท็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ตรวจสอบการเชื่อมต่อ
public boolean checkConnectivity ()
ตรวจสอบว่าอุปกรณ์มีการเชื่อมต่อเครือข่าย
คิกรีเทิร์น | |
---|---|
boolean |
true หากอุปกรณ์มีการเชื่อมต่อเครือข่ายที่ใช้งานได้ ให้false ข้ามด้าน |
การขว้าง | |
---|---|
DeviceNotAvailableException |
clearErrorDialogs
public boolean clearErrorDialogs ()
พยายามปิดกล่องโต้ตอบข้อผิดพลาดใดๆ ที่แสดงอยู่ใน UI ของอุปกรณ์
คิกรีเทิร์น | |
---|---|
boolean |
true หากไม่มีกล่องโต้ตอบอยู่หรือล้างกล่องโต้ตอบได้สำเร็จ
จ่าย false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ล้างเครือข่าย Wi-Fi ที่เชื่อมต่อล่าสุด
public void clearLastConnectedWifiNetwork ()
ล้างเครือข่าย Wi-Fi ที่เชื่อมต่อล่าสุด ควรเรียกใช้เมื่อเริ่มต้นการเรียกใช้ใหม่เพื่อหลีกเลี่ยงการเชื่อมต่อกับเครือข่าย Wi-Fi ที่ใช้ในการทดสอบก่อนหน้านี้หลังจากที่อุปกรณ์รีบูต
clearLogcat
public void clearLogcat ()
ลบข้อมูล Logcat ที่รวบรวมไว้
วิธีนี้มีประโยชน์เมื่อคุณต้องการให้ ITestDevice#getLogcat()
แสดงผลข้อมูลบันทึกที่สร้างขึ้นหลังจากจุดหนึ่งๆ เท่านั้น (เช่น หลังจากแฟลชบิลด์ใหม่ของอุปกรณ์ใหม่ เป็นต้น)
เชื่อมต่อกับเครือข่าย Wi-Fi
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
เชื่อมต่อกับเครือข่าย Wi-Fi
เปิด Wi-Fi และบล็อกจนกว่าจะเชื่อมต่อกับเครือข่าย Wi-Fi เครือข่ายใดเครือข่ายหนึ่งที่ระบุในแผนที่ wifiSsidToPsk สำเร็จ เมื่อเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากการรีบูตทุกครั้งจนกว่าจะมีการเรียกใช้ ITestDevice#disconnectFromWifi()
หรือ ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ | |
---|---|
wifiSsidToPsk |
: แมป SSID ของ Wi-Fi กับรหัสผ่าน |
scanSsid |
boolean : ต้องการสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ อีก false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เชื่อมต่อกับเครือข่าย Wi-Fi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
เชื่อมต่อกับเครือข่าย Wi-Fi
เปิด Wi-Fi และบล็อกจนกว่าจะเชื่อมต่อกับเครือข่าย Wi-Fi ที่ระบุสำเร็จ
เมื่อทำการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากการรีบูตทุกครั้งจนกว่าจะมีการเรียกใช้ ITestDevice#disconnectFromWifi()
หรือ ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ | |
---|---|
wifiSsid |
String : SSD ของ Wi-Fi ที่จะเชื่อมต่อ |
wifiPsk |
String : รหัสผ่าน PSK หรือค่าว่างหากไม่มีการเข้ารหัส |
คิกรีเทิร์น | |
---|---|
boolean |
true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ อีก false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เชื่อมต่อกับเครือข่าย Wi-Fi
public boolean connectToWifiNetwork (wifiSsidToPsk)
เชื่อมต่อกับเครือข่าย Wi-Fi
เปิด Wi-Fi และบล็อกจนกว่าจะเชื่อมต่อกับเครือข่าย Wi-Fi เครือข่ายใดเครือข่ายหนึ่งที่ระบุในแผนที่ wifiSsidToPsk สำเร็จ เมื่อทำการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากการรีบูตทุกครั้งจนกว่าจะมีการเรียกใช้ ITestDevice#disconnectFromWifi()
หรือ ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ | |
---|---|
wifiSsidToPsk |
: แมป SSID ของ Wi-Fi กับรหัสผ่าน |
คิกรีเทิร์น | |
---|---|
boolean |
true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ อีก false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เชื่อมต่อกับเครือข่าย Wi-Fi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
เชื่อมต่อกับเครือข่าย Wi-Fi
เปิด Wi-Fi และบล็อกจนกว่าจะเชื่อมต่อกับเครือข่าย Wi-Fi ที่ระบุสำเร็จ
เมื่อทำการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากการรีบูตทุกครั้งจนกว่าจะมีการเรียกใช้ ITestDevice#disconnectFromWifi()
หรือ ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ | |
---|---|
wifiSsid |
String : SSD ของ Wi-Fi ที่จะเชื่อมต่อ |
wifiPsk |
String : รหัสผ่าน PSK หรือค่าว่างหากไม่มีการเข้ารหัส |
scanSsid |
boolean : ต้องการสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ อีก false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เชื่อมต่อกับเครือข่าย Wi-Fi หากต้องการ
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
ตัวแปรของ connectToWifiNetwork(String, String)
ที่จะเชื่อมต่อเฉพาะเมื่ออุปกรณ์ไม่มีการเชื่อมต่อเครือข่ายในขณะนี้
พารามิเตอร์ | |
---|---|
scanSsid |
boolean : ต้องการสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ อีก false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เชื่อมต่อกับเครือข่าย Wi-Fi หากต้องการ
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
ตัวแปรของ connectToWifiNetwork(String, String)
ที่จะเชื่อมต่อเฉพาะเมื่ออุปกรณ์ไม่มีการเชื่อมต่อเครือข่ายในขณะนี้
คิกรีเทิร์น | |
---|---|
boolean |
true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ อีก false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
สร้างผู้ใช้
public int createUser (String name, boolean guest, boolean ephemeral)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ระบุ
พารามิเตอร์ | |
---|---|
name |
String : ของผู้ใช้ที่จะสร้างในอุปกรณ์ |
guest |
boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --ผู้ใช้ชั่วคราวระหว่างการสร้าง |
ephemeral |
boolean : เปิดใช้การตั้งค่าสถานะผู้ใช้ -- ชั่วคราวระหว่างการสร้าง |
คิกรีเทิร์น | |
---|---|
int |
รหัสของผู้ใช้ที่สร้าง |
การขว้าง | |
---|---|
DeviceNotAvailableException |
สร้างผู้ใช้
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ระบุ
พารามิเตอร์ | |
---|---|
name |
String : ของผู้ใช้ที่จะสร้างในอุปกรณ์ |
guest |
boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --ผู้ใช้ชั่วคราวระหว่างการสร้าง |
ephemeral |
boolean : เปิดใช้การตั้งค่าสถานะผู้ใช้ -- ชั่วคราวระหว่างการสร้าง |
forTesting |
boolean : เปิดใช้ Test Flag --สำหรับการทดสอบระหว่างการสร้าง |
คิกรีเทิร์น | |
---|---|
int |
รหัสของผู้ใช้ที่สร้าง |
การขว้าง | |
---|---|
DeviceNotAvailableException |
สร้างผู้ใช้
public int createUser (String name)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0
พารามิเตอร์ | |
---|---|
name |
String : ของผู้ใช้ที่จะสร้างในอุปกรณ์ |
คิกรีเทิร์น | |
---|---|
int |
จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้น |
การขว้าง | |
---|---|
DeviceNotAvailableException |
createUserNoThrow
public int createUserNoThrow (String name)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0
พารามิเตอร์ | |
---|---|
name |
String : ของผู้ใช้ที่จะสร้างในอุปกรณ์ |
คิกรีเทิร์น | |
---|---|
int |
จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้นหรือ -1 สำหรับข้อผิดพลาด |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ลบไฟล์
public void deleteFile (String deviceFilePath, int userId)
วิธีของตัวช่วยในการลบไฟล์หรือไดเรกทอรีในอุปกรณ์
พารามิเตอร์ | |
---|---|
deviceFilePath |
String : เส้นทางสัมบูรณ์ของไฟล์ในอุปกรณ์ |
userId |
int : รหัสผู้ใช้ที่จะลบ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ลบไฟล์
public void deleteFile (String deviceFilePath)
วิธีของตัวช่วยในการลบไฟล์หรือไดเรกทอรีในอุปกรณ์
พารามิเตอร์ | |
---|---|
deviceFilePath |
String : เส้นทางสัมบูรณ์ของไฟล์ในอุปกรณ์ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ยกเลิกการลงทะเบียนอุปกรณ์การดำเนินการรับ
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
นำ IDeviceActionReceiver
ที่ลงทะเบียนไว้ออก
พารามิเตอร์ | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : IDeviceActionReceiver ที่จะถูกนำออก |
อุปกรณ์ที่ซอฟต์รีสตาร์ท
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
วิธีการของตัวช่วยในการตรวจสอบว่าอุปกรณ์เริ่มต้นอีกครั้งหรือไม่โดยการเปรียบเทียบ system_server ปัจจุบันกับ system_server ProcessInfo
ก่อนหน้า ใช้getProcessByName(String)
เพื่อรับProcessInfo
พารามิเตอร์ | |
---|---|
prevSystemServerProcess |
ProcessInfo : ประมวลผล system_server ก่อนหน้า ProcessInfo |
คิกรีเทิร์น | |
---|---|
boolean |
true หากรีเซ็ตอุปกรณ์ชั่วคราว |
การขว้าง | |
---|---|
DeviceNotAvailableException |
deviceSoftรีสตาร์ทตั้งแต่
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
เมธอดของตัวช่วยในการตรวจสอบว่าอุปกรณ์เริ่มใหม่แบบชั่วคราวหรือไม่ตั้งแต่เวลา UTC ตั้งแต่ Epoch จากอุปกรณ์และ ERROR(/TimeUnit)
ซอฟต์รีสตาร์ทหมายถึง system_server ที่รีสตาร์ทภายนอกการรีบูตอุปกรณ์ด้วยตนเอง (เช่น คำขอรีบูต) รับ utcEpochTime ในอุปกรณ์เป็น Milliseccond ได้โดยใช้เมธอด getDeviceDate()
พารามิเตอร์ | |
---|---|
utcEpochTime |
long : เวลาของอุปกรณ์ในหน่วยวินาทีนับตั้งแต่ Epoch |
timeUnit |
TimeUnit : หน่วยเวลา TimeUnit สำหรับ utcEpochTime ที่ระบุ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากรีเซ็ตอุปกรณ์ชั่วคราว |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ปิดใช้AdbRoot
public boolean disableAdbRoot ()
ปิดราก adb
การปิดใช้รูท adb อาจทำให้อุปกรณ์ยกเลิกการเชื่อมต่อจาก adb วิธีนี้จะบล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน
คิกรีเทิร์น | |
---|---|
boolean |
true หากสำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
disabledKeyguard
public void disableKeyguard ()
ความพยายามปิดใช้งานการล็อกปุ่ม
ก่อนอื่น ให้รอการจัดส่งอินพุตให้พร้อม ซึ่งจะเกิดขึ้นในช่วงเวลาเดียวกับที่อุปกรณ์รายงาน BOOT_COMPLETE ซึ่งดูเหมือนจะไม่พร้อมกัน เนื่องจากการใช้งานเฟรมเวิร์กในปัจจุบันมีสภาพการแข่งขันเป็นครั้งคราว จากนั้นระบบจะส่งคำสั่งเพื่อปิดการล็อกปุ่มกด (ใช้ได้กับคีย์ที่ไม่ปลอดภัยเท่านั้น)
การขว้าง | |
---|---|
DeviceNotAvailableException |
ปิดใช้การตรวจสอบเครือข่าย
public boolean disableNetworkMonitor ()
ปิดใช้การตรวจสอบเครือข่ายในอุปกรณ์
คิกรีเทิร์น | |
---|---|
boolean |
true หากปิดใช้การตรวจสอบสำเร็จ false
หากไม่สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ยกเลิกการเชื่อมต่อจาก Wi-Fi
public boolean disconnectFromWifi ()
ยกเลิกการเชื่อมต่อกับเครือข่าย Wi-Fi
นำเครือข่ายทั้งหมดออกจากรายการเครือข่ายที่รู้จักและปิดใช้ Wi-Fi
คิกรีเทิร์น | |
---|---|
boolean |
true หากยกเลิกการเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ false
หากยกเลิกการเชื่อมต่อไม่สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
doFileExist
public boolean doesFileExist (String deviceFilePath, int userId)
เมธอดของตัวช่วยในการระบุว่าผู้ใช้หนึ่งๆ มีไฟล์อยู่ในอุปกรณ์หรือไม่
พารามิเตอร์ | |
---|---|
deviceFilePath |
String : เส้นทางสัมบูรณ์ของไฟล์ในอุปกรณ์ที่ต้องตรวจสอบ |
userId |
int : รหัสผู้ใช้ที่จะใช้ตรวจสอบการมีอยู่ของไฟล์ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากมีไฟล์อยู่ false มิเช่นนั้น |
การขว้าง | |
---|---|
DeviceNotAvailableException |
doFileExist
public boolean doesFileExist (String deviceFilePath)
เมธอดของตัวช่วยในการตรวจสอบว่ามีไฟล์อยู่ในอุปกรณ์หรือไม่
พารามิเตอร์ | |
---|---|
deviceFilePath |
String : เส้นทางสัมบูรณ์ของไฟล์ในอุปกรณ์ที่ต้องตรวจสอบ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากมีไฟล์อยู่ false มิเช่นนั้น |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ดัมพ์ฮีป
public File dumpHeap (String process, String devicePath)
พยายามดัมพ์ฮีปจาก system_server ผู้โทรจะมีหน้าที่ล้างข้อมูลไฟล์ที่ถ่ายโอนแล้ว
พารามิเตอร์ | |
---|---|
process |
String : ชื่อกระบวนการของอุปกรณ์ที่จะถ่ายโอนข้อมูล |
devicePath |
String : เส้นทางในอุปกรณ์ที่จะวางไฟล์ดัมพ์ ตำแหน่งนี้ต้องเป็นตำแหน่งที่การให้สิทธิ์อนุญาต |
คิกรีเทิร์น | |
---|---|
File |
ERROR(/File) ที่มีรายงานนั้นอยู่ เป็นค่าว่าง หากล้มเหลว |
การขว้าง | |
---|---|
DeviceNotAvailableException |
enabledAdbRoot
public boolean enableAdbRoot ()
เปิดราก adb หากการตั้งค่า "enable-root" เป็น "false" จะบันทึกข้อความและ กลับมาโดยไม่เปิดใช้รูท
การเปิดใช้ adb Root อาจทำให้อุปกรณ์ยกเลิกการเชื่อมต่อจาก adb วิธีนี้จะบล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน
คิกรีเทิร์น | |
---|---|
boolean |
true หากสำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เปิดใช้การตรวจสอบเครือข่าย
public boolean enableNetworkMonitor ()
เปิดใช้การตรวจสอบเครือข่ายในอุปกรณ์
คิกรีเทิร์น | |
---|---|
boolean |
true หากเปิดใช้การตรวจสอบเรียบร้อยแล้ว false
หากไม่สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
actionsAdbCommand
public String executeAdbCommand (long timeout, String... cmdArgs)
เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบโดยมีระยะหมดเวลาที่ระบุไว้
คุณควรใช้ executeShellCommand(String)
แทนเมื่อเป็นไปได้ เนื่องจากวิธีการดังกล่าวช่วยให้การตรวจจับความล้มเหลวและประสิทธิภาพที่ดีกว่า
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาเป็นมิลลิวินาทีก่อนจะถือว่าอุปกรณ์ไม่ตอบสนอง เป็น 0L หากไม่จำกัดระยะหมดเวลา |
cmdArgs |
String : คำสั่ง adb และอาร์กิวเมนต์ที่จะเรียกใช้ |
คิกรีเทิร์น | |
---|---|
String |
Stdout จากคำสั่ง null หากเรียกใช้คำสั่งไม่สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
actionsAdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
เมธอด Helper ที่เรียกใช้คำสั่ง adb เป็นคำสั่งของระบบโดยมีระยะหมดเวลาที่ระบุไว้
คุณควรใช้ executeShellCommand(String)
แทนเมื่อเป็นไปได้ เนื่องจากวิธีการดังกล่าวช่วยให้การตรวจจับความล้มเหลวและประสิทธิภาพที่ดีกว่า
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาเป็นมิลลิวินาทีก่อนจะถือว่าอุปกรณ์ไม่ตอบสนอง เป็น 0L หากไม่จำกัดระยะหมดเวลา |
envMap |
: สภาพแวดล้อมที่จะตั้งค่าสำหรับคำสั่ง |
cmdArgs |
String : คำสั่ง adb และอาร์กิวเมนต์ที่จะเรียกใช้ |
คิกรีเทิร์น | |
---|---|
String |
Stdout จากคำสั่ง null หากเรียกใช้คำสั่งไม่สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
actionsAdbCommand
public String executeAdbCommand (String... cmdArgs)
เมธอด Helper ซึ่งเรียกใช้คำสั่ง adb เป็นคำสั่งของระบบ
คุณควรใช้ executeShellCommand(String)
แทนเมื่อเป็นไปได้ เนื่องจากวิธีการดังกล่าวช่วยให้การตรวจจับความล้มเหลวและประสิทธิภาพที่ดีกว่า
พารามิเตอร์ | |
---|---|
cmdArgs |
String : คำสั่ง adb และอาร์กิวเมนต์ที่จะเรียกใช้ |
คิกรีเทิร์น | |
---|---|
String |
Stdout จากคำสั่ง null หากเรียกใช้คำสั่งไม่สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ปฏิบัติการFastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
เมธอด Helper ที่เรียกใช้คำสั่ง Fastboot เป็นคําสั่งระบบโดยมีระยะหมดเวลาเริ่มต้น 2 นาที
คาดว่าจะใช้เมื่ออุปกรณ์อยู่ใน Fastboot Mode อยู่แล้ว
พารามิเตอร์ | |
---|---|
cmdArgs |
String : คำสั่ง Fastboot และอาร์กิวเมนต์ที่จะเรียกใช้ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีเอาต์พุตของคำสั่ง |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ปฏิบัติการFastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
เมธอด Helper ที่เรียกใช้คำสั่ง Fastboot เป็นคําสั่งระบบ
คาดว่าจะใช้เมื่ออุปกรณ์อยู่ใน Fastboot Mode อยู่แล้ว
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาเป็นมิลลิวินาทีก่อนที่คำสั่งจะหมดอายุ |
cmdArgs |
String : คำสั่ง Fastboot และอาร์กิวเมนต์ที่จะเรียกใช้ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีเอาต์พุตของคำสั่ง |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ดำเนินการLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
เมธอด Helper ซึ่งเรียกใช้คำสั่ง Fastboot ที่ใช้เวลานานเป็นคำสั่งของระบบ
เหมือนกับ executeFastbootCommand(String)
ยกเว้นจะใช้ระยะหมดเวลาที่นานขึ้น
พารามิเตอร์ | |
---|---|
cmdArgs |
String : คำสั่ง Fastboot และอาร์กิวเมนต์ที่จะเรียกใช้ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีเอาต์พุตของคำสั่ง |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ดำเนินการLongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
เมธอด Helper ซึ่งเรียกใช้คำสั่ง Fastboot ที่ใช้เวลานานเป็นคําสั่งของระบบพร้อมกับตัวแปรสภาพแวดล้อมของระบบ
เหมือนกับ executeFastbootCommand(String)
ยกเว้นจะใช้ระยะหมดเวลาที่นานขึ้น
พารามิเตอร์ | |
---|---|
envVarMap |
: ตัวแปรสภาพแวดล้อมของระบบที่คำสั่ง Fastboot เรียกใช้ |
cmdArgs |
String : คำสั่ง Fastboot และอาร์กิวเมนต์ที่จะเรียกใช้ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีเอาต์พุตของคำสั่ง |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ปฏิบัติการเชลล์คำสั่ง
public String executeShellCommand (String command)
เมธอด Helper ที่เรียกใช้คำสั่ง adb shell และแสดงผลเอาต์พุตเป็น String
พารามิเตอร์ | |
---|---|
command |
String : คำสั่ง Shell adb ที่จะเรียกใช้ |
คิกรีเทิร์น | |
---|---|
String |
เอาต์พุต Shell |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ปฏิบัติการเชลล์คำสั่ง
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
พารามิเตอร์ | |
---|---|
command |
String : คำสั่ง Shell adb ที่จะเรียกใช้ |
receiver |
IShellOutputReceiver : IShellOutputReceiver ที่จะส่งเอาต์พุตของ Shell โดยตรง |
maxTimeToOutputShellResponse |
long : ระยะเวลาสูงสุดที่คำสั่งอนุญาตให้ไม่ส่งคำตอบใดๆ ออกมา หน่วยตามที่ระบุไว้ใน timeUnit |
timeUnit |
TimeUnit : หน่วยสำหรับ maxTimeToOutputShellResponse |
retryAttempts |
int : จำนวนครั้งสูงสุดในการลองใช้คำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะส่ง DeviceNotResponseException หากดำเนินการ retryAttempts ไม่สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ปฏิบัติการเชลล์คำสั่ง
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
พารามิเตอร์ | |
---|---|
command |
String : คำสั่ง Shell adb ที่จะเรียกใช้ |
receiver |
IShellOutputReceiver : IShellOutputReceiver ที่จะส่งเอาต์พุตของ Shell โดยตรง |
maxTimeoutForCommand |
long : ระยะหมดเวลาสูงสุดของคำสั่งให้ดำเนินการ หน่วยตามที่ระบุไว้ใน timeUnit |
maxTimeToOutputShellResponse |
long : ระยะเวลาสูงสุดที่คำสั่งอนุญาตให้ไม่ส่งคำตอบใดๆ ออกมา หน่วยตามที่ระบุไว้ใน timeUnit |
timeUnit |
TimeUnit : หน่วยสำหรับ maxTimeToOutputShellResponse |
retryAttempts |
int : จำนวนครั้งสูงสุดในการลองใช้คำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะส่ง DeviceNotResponseException หากดำเนินการ retryAttempts ไม่สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ปฏิบัติการเชลล์คำสั่ง
public void executeShellCommand (String command, IShellOutputReceiver receiver)
เรียกใช้คำสั่งเชลล์ adb ที่กำหนด ลองใหม่หลายครั้งหากคำสั่งล้มเหลว
รูปแบบ executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
ที่มีค่าเริ่มต้นง่ายขึ้น
พารามิเตอร์ | |
---|---|
command |
String : คำสั่ง Shell adb ที่จะเรียกใช้ |
receiver |
IShellOutputReceiver : IShellOutputReceiver ที่จะส่งเอาต์พุตของ Shell โดยตรง |
การขว้าง | |
---|---|
DeviceNotAvailableException |
สั่งการShellV2Command
public CommandResult executeShellV2Command (String cmd)
เมธอดของตัวช่วยที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult
ซึ่งสร้างโดยมีเอาต์พุตสถานะคำสั่ง, stdout และ stderr อย่างถูกต้อง
พารามิเตอร์ | |
---|---|
cmd |
String : คำสั่งที่ควรเรียกใช้ |
คิกรีเทิร์น | |
---|---|
CommandResult |
ผลการค้นหาในภาษาCommandResult |
การขว้าง | |
---|---|
DeviceNotAvailableException |
สั่งการShellV2Command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
เมธอดของตัวช่วยที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult
ซึ่งสร้างอย่างเหมาะสมด้วยเอาต์พุตสถานะคำสั่งและ stderr ระบบจะส่ง stdout ไปยังสตรีมที่ระบุ
พารามิเตอร์ | |
---|---|
cmd |
String : คำสั่งที่ควรเรียกใช้ |
pipeToOutput |
OutputStream : ERROR(/OutputStream) ซึ่งจะเปลี่ยนเส้นทางเอาต์พุต std หรือไม่มีข้อมูล |
คิกรีเทิร์น | |
---|---|
CommandResult |
ผลการค้นหาในภาษาCommandResult |
การขว้าง | |
---|---|
DeviceNotAvailableException |
สั่งการShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
เมธอดของตัวช่วยที่เรียกใช้คำสั่ง adb shell และแสดงผลลัพธ์เป็น CommandResult
ซึ่งสร้างโดยมีเอาต์พุตสถานะคำสั่ง, stdout และ stderr อย่างถูกต้อง
พารามิเตอร์ | |
---|---|
cmd |
String : คำสั่งที่ควรเรียกใช้ |
pipeAsInput |
File : ERROR(/File) ที่จะส่งไปยังอินพุตเป็นอินพุตหรือ Null |
คิกรีเทิร์น | |
---|---|
CommandResult |
ผลการค้นหาในภาษาCommandResult |
การขว้าง | |
---|---|
DeviceNotAvailableException |
สั่งการShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
พารามิเตอร์ | |
---|---|
cmd |
String : คำสั่ง Shell adb ที่จะเรียกใช้ |
maxTimeoutForCommand |
long : ระยะหมดเวลาสูงสุดของคำสั่งให้ดำเนินการ หน่วยตามที่ระบุไว้ใน timeUnit |
timeUnit |
TimeUnit : หน่วยสำหรับ maxTimeToOutputShellResponse |
retryAttempts |
int : จำนวนครั้งสูงสุดในการลองใช้คำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะส่ง DeviceNotResponseException หากดำเนินการ retryAttempts ไม่สำเร็จ |
คิกรีเทิร์น | |
---|---|
CommandResult |
การขว้าง | |
---|---|
DeviceNotAvailableException |
สั่งการShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
พารามิเตอร์ | |
---|---|
cmd |
String : คำสั่ง Shell adb ที่จะเรียกใช้ |
maxTimeoutForCommand |
long : ระยะหมดเวลาสูงสุดของคำสั่งให้ดำเนินการ หน่วยตามที่ระบุไว้ใน timeUnit |
timeUnit |
TimeUnit : หน่วยสำหรับ maxTimeToOutputShellResponse |
คิกรีเทิร์น | |
---|---|
CommandResult |
การขว้าง | |
---|---|
DeviceNotAvailableException |
สั่งการShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
พารามิเตอร์ | |
---|---|
cmd |
String : คำสั่ง Shell adb ที่จะเรียกใช้ |
pipeAsInput |
File : ERROR(/File) ที่จะส่งไปยังอินพุตเป็นอินพุตหรือ Null |
pipeToOutput |
OutputStream : ERROR(/OutputStream) ซึ่งจะเปลี่ยนเส้นทางเอาต์พุต std หรือไม่มีข้อมูล |
maxTimeoutForCommand |
long : ระยะหมดเวลาสูงสุดของคำสั่งให้ดำเนินการ หน่วยตามที่ระบุไว้ใน timeUnit |
timeUnit |
TimeUnit : หน่วยสำหรับ maxTimeToOutputShellResponse |
retryAttempts |
int : จำนวนครั้งสูงสุดในการลองใช้คำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะส่ง DeviceNotResponseException หากดำเนินการ retryAttempts ไม่สำเร็จ |
คิกรีเทิร์น | |
---|---|
CommandResult |
การขว้าง | |
---|---|
DeviceNotAvailableException |
สั่งการShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
เรียกใช้คำสั่ง Shell adb ที่มีพารามิเตอร์เพิ่มเติมเพื่อควบคุมลักษณะการทำงานของคำสั่ง
พารามิเตอร์ | |
---|---|
cmd |
String : คำสั่ง Shell adb ที่จะเรียกใช้ |
pipeAsInput |
File : ERROR(/File) ที่จะส่งไปยังอินพุตเป็นอินพุตหรือ Null |
pipeToOutput |
OutputStream : ERROR(/OutputStream) ซึ่งจะเปลี่ยนเส้นทางเอาต์พุต std หรือไม่มีข้อมูล |
pipeToError |
OutputStream : ERROR(/OutputStream) ซึ่งจะเปลี่ยนเส้นทางข้อผิดพลาด STD หรือไม่มีข้อมูล |
maxTimeoutForCommand |
long : ระยะหมดเวลาสูงสุดของคำสั่งให้ดำเนินการ หน่วยตามที่ระบุไว้ใน timeUnit |
timeUnit |
TimeUnit : หน่วยสำหรับ maxTimeToOutputShellResponse |
retryAttempts |
int : จำนวนครั้งสูงสุดในการลองใช้คำสั่งอีกครั้งหากล้มเหลวเนื่องจากข้อยกเว้น ระบบจะส่ง DeviceNotResponseException หากดำเนินการ retryAttempts ไม่สำเร็จ |
คิกรีเทิร์น | |
---|---|
CommandResult |
การขว้าง | |
---|---|
DeviceNotAvailableException |
FastbootWipePartition
public CommandResult fastbootWipePartition (String partition)
เมธอดของตัวช่วยที่จะล้างข้อมูลพาร์ติชันสำหรับอุปกรณ์
หาก getUseFastbootErase()
คือ true
ระบบจะใช้ Fastboot Delete เพื่อล้างพาร์ติชัน จากนั้นอุปกรณ์จะต้องสร้างระบบไฟล์ในครั้งถัดไปที่เปิดเครื่อง
ไม่เช่นนั้นจะใช้รูปแบบ Fastboot ซึ่งจะสร้างระบบไฟล์ใหม่ในอุปกรณ์
คาดว่าจะใช้เมื่ออุปกรณ์อยู่ใน Fastboot Mode อยู่แล้ว
พารามิเตอร์ | |
---|---|
partition |
String : พาร์ติชันที่จะล้างข้อมูล |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีเอาต์พุตของคำสั่ง |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getActiveApexes
publicgetActiveApexes ()
ดึงข้อมูลเกี่ยวกับ APEX ที่เปิดใช้งานในอุปกรณ์
คิกรีเทิร์น | |
---|---|
|
ERROR(/Set) จาก ApexInfo เปิดใช้งานในอุปกรณ์อยู่ในขณะนี้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getAllSettings
publicgetAllSettings (String namespace)
แสดงผลคู่คีย์-ค่าของเนมสเปซที่ขอ
พารามิเตอร์ | |
---|---|
namespace |
String : ต้องเป็น {"system", "secure", "global"} |
คิกรีเทิร์น | |
---|---|
|
แผนที่ของคู่คีย์-ค่า มีค่าว่างหากไม่รองรับเนมสเปซ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
แสดงสถานะการจัดสรรปัจจุบันของอุปกรณ์
คิกรีเทิร์น | |
---|---|
DeviceAllocationState |
รับรหัส Android
public String getAndroidId (int userId)
ค้นหาและแสดงผล android-id ที่เชื่อมโยงกับ userId หากไม่พบ
พารามิเตอร์ | |
---|---|
userId |
int |
คิกรีเทิร์น | |
---|---|
String |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รับรหัส Android
publicgetAndroidIds ()
สร้างแผนที่รหัส Android ที่พบรหัสผู้ใช้ที่ตรงกัน ไม่มีการรับประกันว่ารหัสผู้ใช้แต่ละรายการจะพบรหัส Android ที่เชื่อมโยงในฟังก์ชันนี้ ดังนั้นรหัสผู้ใช้บางรหัสอาจตรงกับค่าว่าง
คิกรีเทิร์น | |
---|---|
|
แผนที่ของรหัส Android พบรหัสผู้ใช้ที่ตรงกัน |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ระดับ getApi
public int getApiLevel ()
รับระดับ API ของอุปกรณ์ ค่าเริ่มต้นคือ UNKNOWN_API_LEVEL
คิกรีเทิร์น | |
---|---|
int |
จำนวนเต็มที่ระบุระดับ API ของอุปกรณ์ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
ดึงข้อมูลเกี่ยวกับแพ็กเกจที่ติดตั้งในอุปกรณ์
พารามิเตอร์ | |
---|---|
packageName |
String |
คิกรีเทิร์น | |
---|---|
PackageInfo |
PackageInfo หรือ null หากดึงข้อมูลไม่ได้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos
publicgetAppPackageInfos ()
ดึงข้อมูลของแพ็กเกจที่ติดตั้งในอุปกรณ์
คิกรีเทิร์น | |
---|---|
|
ติดตั้ง ERROR(/List) จาก PackageInfo รายการในอุปกรณ์แล้ว |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เวอร์ชันของ GetBase Band
public String getBasebandVersion ()
วิธีการที่สะดวกในการรับเวอร์ชันเบสแบนด์ (วิทยุ) ของอุปกรณ์นี้ การรับเวอร์ชันวิทยุเป็นของอุปกรณ์เฉพาะ จึงอาจไม่แสดงข้อมูลที่ถูกต้องสำหรับอุปกรณ์ทั้งหมด เมธอดนี้ใช้พารามิเตอร์ gsm.version.base Band เพื่อแสดงผลข้อมูลเวอร์ชันที่ถูกต้อง
ข้อมูลนี้ไม่ถูกต้องสำหรับอุปกรณ์ CDMA บางเครื่อง และเวอร์ชันที่แสดงที่นี่อาจไม่ตรงกับเวอร์ชันที่รายงานจาก Fastboot และอาจไม่แสดงผลเวอร์ชันสำหรับวิทยุ CDMA
TL;DR เมธอดนี้จะรายงานเวอร์ชันที่ถูกต้องก็ต่อเมื่อพร็อพเพอร์ตี้ gsm.version.base Band เหมือนกับเวอร์ชันที่ fastboot getvar version-baseband
แสดงผล
คิกรีเทิร์น | |
---|---|
String |
เวอร์ชันเบสแบนด์ของ String หรือ null หากไม่สามารถระบุได้ (อุปกรณ์ไม่มีวิทยุหรือสตริงเวอร์ชันอ่านไม่ได้) |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รับแบตเตอรี่
public Integer getBattery ()
แสดงระดับแบตเตอรี่ปัจจุบันของอุปกรณ์หรือ Null หากไม่มีระดับแบตเตอรี่
คิกรีเทิร์น | |
---|---|
Integer |
พร็อพเพอร์ตี้ GetBoolean
public boolean getBooleanProperty (String name, boolean defaultValue)
แสดงผลค่าบูลีนของพร็อพเพอร์ตี้ที่ระบุ
พารามิเตอร์ | |
---|---|
name |
String : ชื่อพร็อพเพอร์ตี้ |
defaultValue |
boolean : ค่าเริ่มต้นที่จะแสดงผลหากพร็อพเพอร์ตี้ว่างเปล่าหรือไม่มีอยู่ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากพร็อพเพอร์ตี้มีค่า "1" , "y" , "yes" , "on" หรือ "true" , false หากพร็อพเพอร์ตี้มีค่าเป็น "0" , "n" , "no" , "off" , "false" หรือ defaultValue |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ประวัติการเปิดเครื่อง
publicgetBootHistory ()
เมธอด Helper จะรวบรวมแมปประวัติการเปิดเครื่องพร้อมเวลาเปิดเครื่องและเหตุผลที่เปิดเครื่อง
คิกรีเทิร์น | |
---|---|
|
แมปของเวลาเปิดเครื่อง (เวลา UTC ในหน่วยวินาทีนับตั้งแต่ Epoch) และเหตุผลที่เปิดเครื่อง |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getBootประวัติการเข้าชมตั้งแต่
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
เมธอด Helper จะรวบรวมแมปประวัติการเปิดเครื่องพร้อมเวลาเปิดเครื่องและเหตุผลที่เปิดเครื่องตั้งแต่เวลาที่ระบุตั้งแต่ Epoch จากอุปกรณ์และหน่วยเวลาที่ระบุ ดู utcEpochTime ของอุปกรณ์ปัจจุบันเป็นมิลลิวินาทีได้โดยใช้เมธอด getDeviceDate()
พารามิเตอร์ | |
---|---|
utcEpochTime |
long : เวลาของอุปกรณ์นับตั้งแต่ Epoch |
timeUnit |
TimeUnit : หน่วยเวลา TimeUnit |
คิกรีเทิร์น | |
---|---|
|
แมปของเวลาเปิดเครื่อง (เวลา UTC ในหน่วยวินาทีนับตั้งแต่ Epoch) และเหตุผลที่เปิดเครื่อง |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public String getBootloaderVersion ()
วิธีการที่สะดวกในการรับเวอร์ชันของ Bootloader ของอุปกรณ์นี้
จะพยายามเรียกเวอร์ชัน Bootloader จากสถานะปัจจุบันของอุปกรณ์ (เช่น หากอุปกรณ์อยู่ใน Fastboot Mode ระบบจะพยายามเรียกเวอร์ชันจาก Fastboot)
คิกรีเทิร์น | |
---|---|
String |
String Bootloader หรือ null หากไม่พบ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getBugreport
public InputStreamSource getBugreport ()
เรียกรายงานข้อบกพร่องจากอุปกรณ์
เรารับประกันว่าการดำเนินการดังกล่าวจะใช้ได้ในอุปกรณ์ที่ไม่มีการ์ด SD (หรือยังไม่ได้ต่อเชื่อมการ์ด SD)
คิกรีเทิร์น | |
---|---|
InputStreamSource |
InputStreamSource ซึ่งจะสร้างเนื้อหารายงานข้อบกพร่องตามคำขอ ในกรณีที่ไม่สำเร็จ InputStreamSource จะสร้าง ERROR(/InputStream) ที่ว่างเปล่า |
getBugreportz
public InputStreamSource getBugreportz ()
ดึง Bugreportz จากอุปกรณ์ รายงานข้อบกพร่องของรูปแบบ ZIP ประกอบด้วยรายงานข้อบกพร่องหลักและไฟล์บันทึกอื่นๆ ที่มีประโยชน์สำหรับการแก้ไขข้อบกพร่อง
รองรับเฉพาะ "เวอร์ชัน adb" > 1.0.36
คิกรีเทิร์น | |
---|---|
InputStreamSource |
InputStreamSource ของไฟล์ ZIP ที่มี Bugreportz แสดงผล Null ในกรณีที่เกิดข้อผิดพลาด |
getBuildAlias
public String getBuildAlias ()
เรียกข้อมูลชื่อแทนของบิลด์ที่อุปกรณ์ทำงานอยู่
โดยปกติแล้วชื่อแทนของบิลด์จะเป็นสตริงที่อ่านได้ง่ายกว่ารหัสบิลด์ (มักจะเป็นตัวเลขสำหรับบิลด์ของ Nexus) ตัวอย่างเช่น รุ่น Android 4.2 รุ่นสุดท้ายมีชื่อแทนบิลด์เป็น JDQ39 และรหัสบิลด์ 573038
คิกรีเทิร์น | |
---|---|
String |
ชื่อแทนของบิลด์หรือกลับไปใช้รหัสบิลด์ถ้าดึงข้อมูลไม่ได้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getBuildFlavor
public String getBuildFlavor ()
เรียกข้อมูลเวอร์ชันบิลด์ของอุปกรณ์
คิกรีเทิร์น | |
---|---|
String |
เวอร์ชันบิลด์หรือค่าว่างหากเรียกข้อมูลไม่ได้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getBuildId
public String getBuildId ()
ดึงข้อมูลบิลด์ที่อุปกรณ์กำลังทำงานอยู่
คิกรีเทิร์น | |
---|---|
String |
รหัสบิลด์หรือ IBuildInfo#UNKNOWN_BUILD_ID หากดึงข้อมูลไม่ได้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
คีย์การลงนามของการสร้างบิลด์
public String getBuildSigningKeys ()
แสดงประเภทคีย์ที่ใช้ในการลงนามรูปภาพของอุปกรณ์
โดยทั่วไปอุปกรณ์ Android อาจมีการรับรองด้วยคีย์ทดสอบ (เช่น ใน AOSP) หรือคีย์การเผยแพร่ (ควบคุมโดยผู้ผลิตอุปกรณ์แต่ละราย)
คิกรีเทิร์น | |
---|---|
String |
คีย์การลงชื่อ หากพบ จะเป็นค่าว่าง |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
แสดงผล DeviceDescriptor
ที่แคชไว้หากจัดสรรอุปกรณ์ไว้ มิเช่นนั้นจะแสดงผล DeviceDescriptor
ปัจจุบัน
คิกรีเทิร์น | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
แสดงผล DeviceDescriptor
ที่แคชไว้หากจัดสรรอุปกรณ์ไว้ มิเช่นนั้นจะแสดงผล DeviceDescriptor
ปัจจุบัน
พารามิเตอร์ | |
---|---|
shortDescriptor |
boolean : จำกัดตัวบ่งชี้ให้เหลือเพียงข้อมูลเพียงเล็กน้อยหรือไม่ |
คิกรีเทิร์น | |
---|---|
DeviceDescriptor |
รับเด็ก
public String[] getChildren (String path)
ทางเลือกในการใช้ IFileEntry
ที่บางครั้งจะใช้งานไม่ได้เนื่องจากสิทธิ์
พารามิเตอร์ | |
---|---|
path |
String : เป็นเส้นทางในอุปกรณ์ที่จะใช้ค้นหา |
คิกรีเทิร์น | |
---|---|
String[] |
อาร์เรย์ของสตริงที่มีไฟล์ทั้งหมดในเส้นทางในอุปกรณ์ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
การเชื่อมต่อปัจจุบันที่เชื่อมโยงกับอุปกรณ์
คิกรีเทิร์น | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
แสดงผล ContentProviderHandler
หรือ Null หากไม่มี
นำผู้ให้บริการเนื้อหามาใช้ซ้ำได้หากสร้างไว้ก่อนหน้านี้โดยใช้ userId
เดียวกัน
พารามิเตอร์ | |
---|---|
userId |
int : รหัสผู้ใช้ที่จะใช้ในการเริ่มต้นผู้ให้บริการเนื้อหา |
คิกรีเทิร์น | |
---|---|
ContentProviderHandler |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
แสดงผลสถานะปัจจุบันของอุปกรณ์หรือค่า Null หากเกิดปัญหาขึ้น
คิกรีเทิร์น | |
---|---|
DeviceFoldableState |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getCurrentUser
public int getCurrentUser ()
แสดงผล ID ของผู้ใช้ปัจจุบันที่กำลังทำงานอยู่ ในกรณีที่มีข้อผิดพลาด ให้แสดงผล -10000
คิกรีเทิร์น | |
---|---|
int |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
ดูคลาสของอุปกรณ์
คิกรีเทิร์น | |
---|---|
String |
คลาสของอุปกรณ์ String |
getDeviceDate
public long getDeviceDate ()
แสดงวันที่ของอุปกรณ์เป็นมิลลิวินาทีตั้งแต่ Epoch
คิกรีเทิร์น | |
---|---|
long |
วันที่ของอุปกรณ์ในรูปแบบ Epoch |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor ()
แสดง DeviceDescriptor
จากข้อมูลอุปกรณ์เพื่อรับข้อมูลโดยไม่ผ่านออบเจ็กต์อุปกรณ์จริง
คิกรีเทิร์น | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
แสดง DeviceDescriptor
จากข้อมูลอุปกรณ์เพื่อรับข้อมูลโดยไม่ผ่านออบเจ็กต์อุปกรณ์จริง
พารามิเตอร์ | |
---|---|
shortDescriptor |
boolean : จำกัดตัวบ่งชี้ให้เหลือเพียงข้อมูลเพียงเล็กน้อยหรือไม่ |
คิกรีเทิร์น | |
---|---|
DeviceDescriptor |
getDeviceState
public TestDeviceState getDeviceState ()
ดูสถานะของอุปกรณ์
คิกรีเทิร์น | |
---|---|
TestDeviceState |
รับเวลาของอุปกรณ์
public long getDeviceTimeOffset (Date date)
ผู้ช่วยในการดูความแตกต่างของเวลาระหว่างอุปกรณ์กับ ERROR(/Date)
ที่ระบุ ใช้เวลา Epoch เป็นการภายใน
พารามิเตอร์ | |
---|---|
date |
Date |
คิกรีเทิร์น | |
---|---|
long |
ความแตกต่างเป็นมิลลิวินาที |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
รับสตรีมโปรแกรมจำลอง stdout และ stderr
คิกรีเทิร์น | |
---|---|
InputStreamSource |
เอาต์พุตโปรแกรมจำลอง |
getEmulatorProcess
public Process getEmulatorProcess ()
แสดงผล Process
ที่เกี่ยวข้องกับโปรแกรมจำลองนี้
คิกรีเทิร์น | |
---|---|
Process |
Process หรือ null |
บันทึกคำสั่ง getExecuteShell
public final File getExecuteShellCommandLog ()
บันทึกที่มีบันทึก executeShellCommand(String)
ทั้งหมด
คิกรีเทิร์น | |
---|---|
File |
เข้าถึงร้านค้าฟรีภายนอก
public long getExternalStoreFreeSpace ()
วิธีของตัวช่วยระบุปริมาณพื้นที่ว่างในที่จัดเก็บข้อมูลภายนอกของอุปกรณ์
คิกรีเทิร์น | |
---|---|
long |
ปริมาณพื้นที่ว่างในหน่วย KB |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getFastbootPath
public String getFastbootPath ()
แสดงผลเส้นทางของไบนารี Fastboot ที่ใช้
ยังคงต้องใช้ isFastbootEnabled()
เป็น "จริง" เพื่อเปิดใช้ฟังก์ชัน Fastboot
คิกรีเทิร์น | |
---|---|
String |
getFastbootProductType
public String getFastbootProductType ()
วิธีที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้เมื่ออยู่ใน Fastboot Mode
ใช้วิธีนี้เฉพาะเมื่ออุปกรณ์ควรอยู่ใน Fastboot วิธีนี้เป็นตัวแปรที่ปลอดภัยกว่าเมธอด getProductType()
ทั่วไปเล็กน้อยในกรณีนี้ เนื่องจาก ITestDevice จะรู้ว่าต้องกู้คืนอุปกรณ์ไปยัง Fastboot หากอุปกรณ์อยู่ในสถานะไม่ถูกต้องหรือไม่ตอบสนอง
คิกรีเทิร์น | |
---|---|
String |
ชื่อประเภทผลิตภัณฑ์ String หรือ null หากไม่สามารถระบุได้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getFastbootProductVariant
public String getFastbootProductVariant ()
วิธีที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้เมื่ออยู่ใน Fastboot Mode
ใช้วิธีนี้เฉพาะเมื่ออุปกรณ์ควรอยู่ใน Fastboot วิธีนี้เป็นตัวแปรที่ปลอดภัยกว่าเมธอด getProductType()
ทั่วไปเล็กน้อยในกรณีนี้ เนื่องจาก ITestDevice จะรู้ว่าต้องกู้คืนอุปกรณ์ไปยัง Fastboot หากอุปกรณ์อยู่ในสถานะไม่ถูกต้องหรือไม่ตอบสนอง
คิกรีเทิร์น | |
---|---|
String |
ชื่อประเภทผลิตภัณฑ์ String หรือ null หากไม่สามารถระบุได้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getFastbootSerialNumber
public String getFastbootSerialNumber ()
แสดงหมายเลขซีเรียล Fastboot Mode
คิกรีเทิร์น | |
---|---|
String |
getFastbootVariable
public String getFastbootVariable (String variableName)
ดึงค่าตัวแปร Fastboot ที่ระบุจากอุปกรณ์
พารามิเตอร์ | |
---|---|
variableName |
String : ชื่อตัวแปร |
คิกรีเทิร์น | |
---|---|
String |
ค่าของพร็อพเพอร์ตี้หรือ null หากไม่มีอยู่ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getFastbootVersion
public String getFastbootVersion ()
แสดงผลสตริงเวอร์ชันของไบนารี Fastboot ที่ใช้ หรือเป็นค่าว่างหากมีบางอย่างผิดปกติ
คิกรีเทิร์น | |
---|---|
String |
getFileEntry
public IFileEntry getFileEntry (String path)
ดึงข้อมูลการอ้างอิงไปยังไฟล์ระยะไกลในอุปกรณ์
พารามิเตอร์ | |
---|---|
path |
String : เส้นทางไฟล์ที่จะเรียก อาจเป็นเส้นทางสัมบูรณ์หรือเส้นทางที่สัมพันธ์กับ "/" (เช่น รองรับทั้งไวยากรณ์ "/system" และ "system") |
คิกรีเทิร์น | |
---|---|
IFileEntry |
IFileEntry หรือ null หากไม่พบไฟล์ที่ path ที่ระบุ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
ผู้ช่วยอย่างไม่เป็นทางการในการรับ FileEntry
จากเส้นทางที่ไม่ใช่รูท แก้ไข: เปลี่ยนโครงสร้างภายในระบบ FileEntry เพื่อให้พร้อมใช้งานจากทุกเส้นทาง (รวมถึงไม่ใช่รูท)
พารามิเตอร์ | |
---|---|
entry |
FileListingService.FileEntry : FileEntry ไม่จำเป็นต้องเป็นรูทตาม Ddmlib ที่ต้องการ |
คิกรีเทิร์น | |
---|---|
IFileEntry |
FileEntryWrapper ที่แสดง FileEntry |
การขว้าง | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
getFoldableStates
publicgetFoldableStates ()
แสดงรายการสถานะพับได้ในอุปกรณ์ จะได้รับด้วย "cmd device_state Print-states"
คิกรีเทิร์น | |
---|---|
|
การขว้าง | |
---|---|
DeviceNotAvailableException |
getIDevice
public IDevice getIDevice ()
แสดงผลการอ้างอิงไปยัง IDevice
ddmlib ที่เกี่ยวข้อง
DDMS อาจจัดสรร IDevice
ใหม่ทุกครั้งที่อุปกรณ์ยกเลิกการเชื่อมต่อและเชื่อมต่ออีกครั้งจาก adb ดังนั้นผู้โทรไม่ควรเก็บการอ้างอิงไปยัง IDevice
ไว้ เนื่องจากข้อมูลอ้างอิงนั้นอาจไม่อัปเดต
คิกรีเทิร์น | |
---|---|
IDevice |
IDevice |
getInstalledPackageNames
publicgetInstalledPackageNames ()
ดึงข้อมูลชื่อแพ็กเกจของแอปพลิเคชันที่มีอยู่ในอุปกรณ์
คิกรีเทิร์น | |
---|---|
|
ERROR(/Set) จาก String ชื่อแพ็กเกจที่ติดตั้งในอุปกรณ์อยู่ในขณะนี้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getIntProperty
public long getIntProperty (String name, long defaultValue)
แสดงผลค่าจำนวนเต็มของคุณสมบัติที่ระบุจากอุปกรณ์
พารามิเตอร์ | |
---|---|
name |
String : ชื่อพร็อพเพอร์ตี้ |
defaultValue |
long : ค่าเริ่มต้นที่จะแสดงผลหากพร็อพเพอร์ตี้ว่างเปล่าหรือไม่มีอยู่ |
คิกรีเทิร์น | |
---|---|
long |
ค่าพร็อพเพอร์ตี้ หรือ defaultValue หากพร็อพเพอร์ตี้ว่างเปล่า ไม่มีอยู่ หรือไม่มีค่าจำนวนเต็ม |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getIPAddress
public String getIpAddress ()
รับที่อยู่ IP ของอุปกรณ์
คิกรีเทิร์น | |
---|---|
String |
ที่อยู่ IP ของอุปกรณ์ หรือ null หากอุปกรณ์ไม่มีที่อยู่ IP |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
แสดงผลออบเจ็กต์เพื่อรับสถานะปัจจุบันของคีย์การ์ดหรือ Null หากไม่รองรับ
คิกรีเทิร์น | |
---|---|
KeyguardControllerState |
KeyguardControllerState ที่มีภาพรวมของสถานะของคีย์การ์ดและแสดงผล Null หากระบบไม่รองรับคำค้นหา Keyguard |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getLastExpectรีบูตTime Millis
public long getLastExpectedRebootTimeMillis ()
แสดงผลเวลาล่าสุดที่ Tradefed API ที่ทริกเกอร์การรีบูตในหน่วยมิลลิวินาทีตั้งแต่ EPOCH ที่แสดงผลโดย System.currentTimeMillis()
คิกรีเทิร์น | |
---|---|
long |
ระดับ getLaunchApi
public int getLaunchApiLevel ()
รับระดับ API ที่เปิดใช้งานครั้งแรกของอุปกรณ์ ค่าเริ่มต้นคือ UNKNOWN_API_LEVEL
คิกรีเทิร์น | |
---|---|
int |
จำนวนเต็มที่ระบุระดับ API ครั้งแรกของอุปกรณ์ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getLogcat
public InputStreamSource getLogcat ()
ดึงสตรีมสแนปชอตของข้อมูล Logcat
ทำงานใน 2 โหมดต่อไปนี้
TestDeviceOptions.getMaxLogcatDataSize()
ไบต์ของการจับภาพ Logcat ในเบื้องหลัง
คิกรีเทิร์น | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
จับสตรีมสแนปชอตของ maxBytes
ล่าสุดของข้อมูล Logcat ที่บันทึกไว้
มีประโยชน์ในกรณีที่คุณต้องการจับภาพสแนปชอตของข้อมูล Logcat ที่เกิดขึ้นบ่อยครั้งโดยไม่ก่อให้เกิดปัญหาพื้นที่ดิสก์จำนวนมากเมื่อได้สแนปชอต getLogcat()
ทั้งหมด
พารามิเตอร์ | |
---|---|
maxBytes |
int : จำนวนข้อมูลสูงสุดที่จะแสดง ควรเป็นขนาดที่ใส่ในหน่วยความจำได้พอดี |
คิกรีเทิร์น | |
---|---|
InputStreamSource |
getLogcatDump
public InputStreamSource getLogcatDump ()
รับดัมพ์ของ Logcat ปัจจุบันสำหรับอุปกรณ์ วิธีนี้ต่างจาก getLogcat()
ตรงที่เมธอดจะส่งคืนค่าแบบคงที่ของ Logcat เสมอ
มีข้อเสียตรงที่จะไม่ส่งคืนอุปกรณ์หากติดต่อไม่ได้
คิกรีเทิร์น | |
---|---|
InputStreamSource |
InputStreamSource ของข้อมูล Logcat ระบบจะแสดงผลสตรีมที่ว่างเปล่าหากบันทึกข้อมูล Logcat ไม่สำเร็จ |
getLogcatหากยังไม่มี
public InputStreamSource getLogcatSince (long date)
ดึงสตรีมสแนปชอตของข้อมูล Logcat ที่บันทึกไว้โดยเริ่มตั้งแต่วันที่ที่ระบุ ควรใช้เวลาในอุปกรณ์ getDeviceDate()
พารามิเตอร์ | |
---|---|
date |
long : เป็นมิลลิวินาทีตั้งแต่รูปแบบ Epoch ของเวลาที่จะเริ่มสแนปชอตจนถึงปัจจุบัน
(รับได้โดยใช้ "วันที่ +%s") |
คิกรีเทิร์น | |
---|---|
InputStreamSource |
getMacAddress
public String getMacAddress ()
แสดงผลที่อยู่ MAC ของอุปกรณ์ ค่าว่างในกรณีที่ค้นหาจากอุปกรณ์ไม่สำเร็จ
คิกรีเทิร์น | |
---|---|
String |
รับรหัสผู้ใช้หลัก
public Integer getMainUserId ()
แสดงผล User-ID หลัก
คิกรีเทิร์น | |
---|---|
Integer |
userId ของผู้ใช้หลักหากมี และแสดงค่าว่างหากไม่มีผู้ใช้หลัก |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
ดูข้อมูลเกี่ยวกับโมดูลเมนไลน์ที่ติดตั้งในอุปกรณ์
คิกรีเทิร์น | |
---|---|
|
ERROR(/Set) จาก String โมดูลหลักที่ติดตั้งอยู่ในปัจจุบันในอุปกรณ์ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfRunningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
รับจำนวนผู้ใช้งานพร้อมกันที่รองรับสูงสุด ค่าเริ่มต้นคือ 0
คิกรีเทิร์น | |
---|---|
int |
จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่ทำงานพร้อมกัน |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported ()
รับจํานวนผู้ใช้ที่รองรับสูงสุด ค่าเริ่มต้นคือ 0
คิกรีเทิร์น | |
---|---|
int |
จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่รองรับ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
คิกรีเทิร์น | |
---|---|
Process |
แสดงผลการประมวลผลของ Microdroid VM หาก TestDevice ไม่ใช่ Microdroid จะแสดงผลเป็น Null |
GetMonitor
public IDeviceStateMonitor getMonitor ()
ส่งคืน IDeviceStateMonitor
ที่เชื่อมโยงกับอุปกรณ์
คิกรีเทิร์น | |
---|---|
IDeviceStateMonitor |
getMountPoint
public String getMountPoint (String mountName)
แสดงผลจุดต่อเชื่อม
ค้นหาอุปกรณ์โดยตรงหากไม่มีข้อมูลที่แคชไว้ใน IDevice
สิ่งที่ต้องทำ: ย้ายลักษณะการทำงานนี้ไปยัง IDevice#getMountPoint(String)
พารามิเตอร์ | |
---|---|
mountName |
String : ชื่อของจุดต่อเชื่อม |
คิกรีเทิร์น | |
---|---|
String |
จุดต่อเชื่อมหรือnull |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
แสดงผล MountPointInfo
ที่สอดคล้องกับเส้นทางจุดต่อเชื่อมที่ระบุ หรือ null
หากเส้นทางนั้นไม่มีการต่อเชื่อมหรือไม่ปรากฏใน /proc/mounts เป็นจุดต่อเชื่อม
พารามิเตอร์ | |
---|---|
mountpoint |
String |
คิกรีเทิร์น | |
---|---|
ITestDevice.MountPointInfo |
ERROR(/List) จาก MountPointInfo ที่มีข้อมูลใน "/proc/mounts" |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getMountPointInfo
publicgetMountPointInfo ()
ส่งคืนข้อมูลเวอร์ชันแยกวิเคราะห์ใน /proc/mounts บนอุปกรณ์
คิกรีเทิร์น | |
---|---|
|
ERROR(/List) จาก MountPointInfo ที่มีข้อมูลใน "/proc/mounts" |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getOptions
public TestDeviceOptions getOptions ()
ดึงข้อมูลตัวเลือกการทดสอบสำหรับอุปกรณ์
คิกรีเทิร์น | |
---|---|
TestDeviceOptions |
TestDeviceOptions ที่เกี่ยวข้องกับอุปกรณ์ที่อยู่ระหว่างการทดสอบ |
getพาร์ติชัน FreeSpace
public long getPartitionFreeSpace (String partition)
เมธอด Helper เพื่อกำหนดพื้นที่ว่างในพาร์ติชันอุปกรณ์
พารามิเตอร์ | |
---|---|
partition |
String |
คิกรีเทิร์น | |
---|---|
long |
ปริมาณพื้นที่ว่างในหน่วย KB |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getPrimaryUserId
public Integer getPrimaryUserId ()
แสดงผล User-ID หลัก
คิกรีเทิร์น | |
---|---|
Integer |
userId ของผู้ใช้หลักหากมี และแสดงค่าว่างหากไม่มีผู้ใช้หลัก |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getProcessByName
public ProcessInfo getProcessByName (String processName)
เมธอด Helper จะเรียกใช้คำสั่ง "pidof" และ "stat" และแสดงผลออบเจ็กต์ ProcessInfo
ที่มี PID และเวลาเริ่มต้นของการประมวลผลของกระบวนการที่ระบุ
พารามิเตอร์ | |
---|---|
processName |
String : สตริงชื่อโพรเซส |
คิกรีเทิร์น | |
---|---|
ProcessInfo |
ProcessInfo ของ processName ที่ระบุ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getProcessPid
public String getProcessPid (String process)
แสดงผล PID ของบริการหรือ Null หากเกิดข้อผิดพลาด
พารามิเตอร์ | |
---|---|
process |
String : สตริงชื่อโพรเซส |
คิกรีเทิร์น | |
---|---|
String |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getProductType
public String getProductType ()
วิธีการที่สะดวกในการรับประเภทผลิตภัณฑ์ของอุปกรณ์นี้
วิธีนี้จะได้ผลหากอุปกรณ์อยู่ในโหมด adb หรือ Fastboot Mode
คิกรีเทิร์น | |
---|---|
String |
ชื่อประเภทผลิตภัณฑ์ String จะไม่เป็นค่าว่าง |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getProductVariant
public String getProductVariant ()
วิธีการที่สะดวกในการรับรายละเอียดปลีกย่อยของผลิตภัณฑ์ของอุปกรณ์นี้
วิธีนี้จะได้ผลหากอุปกรณ์อยู่ในโหมด adb หรือ Fastboot Mode
คิกรีเทิร์น | |
---|---|
String |
ชื่อผลิตภัณฑ์ย่อย String หรือ null หากระบุไม่ได้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
GetProperty
public String getProperty (String name)
ดึงข้อมูลค่าคุณสมบัติที่ระบุจากอุปกรณ์
พารามิเตอร์ | |
---|---|
name |
String : ชื่อพร็อพเพอร์ตี้ |
คิกรีเทิร์น | |
---|---|
String |
ค่าของพร็อพเพอร์ตี้หรือ null หากไม่มีอยู่ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
โหมดกู้คืน
public ITestDevice.RecoveryMode getRecoveryMode ()
รับโหมดการกู้คืนปัจจุบันที่ใช้สำหรับอุปกรณ์
คิกรีเทิร์น | |
---|---|
ITestDevice.RecoveryMode |
โหมดการกู้คืนปัจจุบันที่ใช้กับอุปกรณ์ |
รับภาพหน้าจอ
public InputStreamSource getScreenshot (String format)
ดึงภาพหน้าจอจากอุปกรณ์ แนะนำให้ใช้ getScreenshot(format) แทนด้วยการเข้ารหัส JPEG สำหรับขนาดที่เล็กลง
พารามิเตอร์ | |
---|---|
format |
String : รองรับ PNG, JPEG |
คิกรีเทิร์น | |
---|---|
InputStreamSource |
InputStreamSource ของภาพหน้าจอในรูปแบบ หรือ null หากจับภาพหน้าจอไม่สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รับภาพหน้าจอ
public InputStreamSource getScreenshot (long displayId)
ดึงภาพหน้าจอจากอุปกรณ์ที่ระบุรหัสการแสดงผล รูปแบบคือ PNG
สิ่งที่ต้องทำ: ขยายการใช้งานข้างต้นเพื่อรองรับ "รูปแบบ" และ "ปรับขนาด"
พารามิเตอร์ | |
---|---|
displayId |
long : รหัสการแสดงผลของหน้าจอที่จะใช้แสดงภาพหน้าจอ |
คิกรีเทิร์น | |
---|---|
InputStreamSource |
InputStreamSource ของภาพหน้าจอในรูปแบบ หรือ null หากจับภาพหน้าจอไม่สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รับภาพหน้าจอ
public InputStreamSource getScreenshot (String format, boolean rescale)
ดึงภาพหน้าจอจากอุปกรณ์ แนะนำให้ใช้ getScreenshot(String)
แทนการเข้ารหัส JPEG สำหรับขนาดที่เล็กลง
พารามิเตอร์ | |
---|---|
format |
String : รองรับ PNG, JPEG |
rescale |
boolean : กรณีที่ควรปรับขนาดภาพหน้าจอเพื่อลดขนาดของรูปภาพที่ได้ |
คิกรีเทิร์น | |
---|---|
InputStreamSource |
InputStreamSource ของภาพหน้าจอในรูปแบบ หรือ null หากจับภาพหน้าจอไม่สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รับภาพหน้าจอ
public InputStreamSource getScreenshot ()
ดึงภาพหน้าจอจากอุปกรณ์
คิกรีเทิร์น | |
---|---|
InputStreamSource |
InputStreamSource ของภาพหน้าจอในรูปแบบ png หรือ null หากจับภาพหน้าจอไม่สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getSerialNumber
public String getSerialNumber ()
วิธีการที่สะดวกในการรับหมายเลขซีเรียลของอุปกรณ์นี้
คิกรีเทิร์น | |
---|---|
String |
หมายเลขซีเรียล String |
GetSetting
public String getSetting (int userId, String namespace, String key)
แสดงผลค่าของการตั้งค่าที่ขอ Namespace ต้องเป็น {"system", "secure", "global"}
พารามิเตอร์ | |
---|---|
userId |
int |
namespace |
String |
key |
String |
คิกรีเทิร์น | |
---|---|
String |
ค่าที่เชื่อมโยงกับเนมสเปซ:คีย์ของผู้ใช้ มีค่า Null หากไม่พบ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
GetSetting
public String getSetting (String namespace, String key)
ดู getSetting(int, String, String)
และดำเนินการกับผู้ใช้ระบบ
พารามิเตอร์ | |
---|---|
namespace |
String |
key |
String |
คิกรีเทิร์น | |
---|---|
String |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getSimOperator
public String getSimOperator ()
ส่งคืนผู้ให้บริการซิมการ์ดหรือค่า Null หากไม่มีหรืออุปกรณ์ไม่พร้อมใช้งาน
คิกรีเทิร์น | |
---|---|
String |
getSimState
public String getSimState ()
แสดงสถานะซิมการ์ดหรือค่าว่างหากไม่มีหรืออุปกรณ์ไม่พร้อมใช้งาน
คิกรีเทิร์น | |
---|---|
String |
GetTombstones
publicgetTombstones ()
ดึงข้อมูลและส่งคืนรายการ Tombstone จากอุปกรณ์ต่างๆ ต้องใช้รูท
วิธีที่ดีที่สุดคือหากไม่สามารถดึง Tombstone วงหนึ่งไม่ว่าด้วยเหตุผลใดก็ตาม ป้าย Tombstone จะหายไปจากรายการ มีเพียง DeviceNotAvailableException
เท่านั้นที่จะทำให้เมธอดสิ้นสุดลงก่อนกำหนด
คิกรีเทิร์น | |
---|---|
|
รายการไฟล์ Tombstone ให้ว่างเปล่าหากไม่มี Tombstone |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getTotalMemory
public long getTotalMemory ()
แสดงขนาดหน่วยความจำทางกายภาพทั้งหมดเป็นไบต์หรือ -1 ในกรณีที่เกิดข้อผิดพลาดภายใน
คิกรีเทิร์น | |
---|---|
long |
getถอนการติดตั้งPackageNames
publicgetUninstallablePackageNames ()
เรียกชื่อแพ็กเกจแอปพลิเคชันที่สามารถถอนการติดตั้งได้ ซึ่งปัจจุบันกำหนดเป็นแพ็กเกจที่ไม่ใช่ระบบและแพ็กเกจระบบที่อัปเดต
คิกรีเทิร์น | |
---|---|
|
ERROR(/Set) ของชื่อแพ็กเกจ String ที่ถอนการติดตั้งได้ซึ่งติดตั้งในอุปกรณ์อยู่ในขณะนี้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getUseFastbootDELETE
public boolean getUseFastbootErase ()
รับว่าจะใช้รูปแบบ Fastboot Delete หรือ Fastboot เพื่อล้างข้อมูลพาร์ติชันในอุปกรณ์หรือไม่
คิกรีเทิร์น | |
---|---|
boolean |
true หากใช้การลบ Fastboot หรือ false หากจะใช้รูปแบบ Fastboot |
getUserFlags
public int getUserFlags (int userId)
ค้นหาและแสดงธงของผู้ใช้ที่ต้องการ การติดธงจะกำหนดไว้ในคลาส "android.content.pm.UserInfo" ในโปรเจ็กต์โอเพนซอร์สของ Android
พารามิเตอร์ | |
---|---|
userId |
int |
คิกรีเทิร์น | |
---|---|
int |
ค่าสถานะที่เชื่อมโยงกับ UserId ที่ระบุ หากพบ คือ -10000 ในกรณีอื่นๆ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getUserInfos
publicgetUserInfos ()
เรียกดูแมปของ useId ไปยัง UserInfo
ในอุปกรณ์ จะแสดง DeviceRuntimeException
หากเอาต์พุตจากอุปกรณ์ไม่เป็นไปตามที่คาดไว้
คิกรีเทิร์น | |
---|---|
|
รายการออบเจ็กต์ UserInfo |
การขว้าง | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
แสดงผลหมายเลขซีเรียลที่เชื่อมโยงกับ userId หากพบ ซึ่งก็คือ -10000 ในกรณีอื่นๆ
พารามิเตอร์ | |
---|---|
userId |
int |
คิกรีเทิร์น | |
---|---|
int |
การขว้าง | |
---|---|
DeviceNotAvailableException |
จัดการเหตุการณ์การจัดสรร
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
ประมวลผล DeviceEvent ที่ระบุ อาจเปลี่ยนอุปกรณ์เป็นสถานะใหม่ จะแจ้ง IDeviceMonitor
เกี่ยวกับการเปลี่ยนสถานะใดๆ
ประมวลผล DeviceEvent ซึ่งอาจเปลี่ยนหรือไม่เปลี่ยนอุปกรณ์นี้เป็นสถานะการจัดสรรใหม่
พารามิเตอร์ | |
---|---|
event |
DeviceEvent |
คิกรีเทิร์น | |
---|---|
IManagedTestDevice.DeviceEventResponse |
มีฟีเจอร์
public boolean hasFeature (String feature)
ตรวจสอบว่าฟีเจอร์พร้อมใช้งานในอุปกรณ์หรือไม่
พารามิเตอร์ | |
---|---|
feature |
String : รูปแบบควรเป็น "ฟีเจอร์: |
คิกรีเทิร์น | |
---|---|
boolean |
จริงหากพบฟีเจอร์ เป็นเท็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์
พารามิเตอร์ | |
---|---|
packageFile |
File : ไฟล์ apk ที่จะติดตั้ง |
reinstall |
boolean : true หากควรทำการติดตั้งอีกครั้ง |
extraArgs |
String : อาร์กิวเมนต์เสริมที่ไม่บังคับที่จะส่ง โปรดดูตัวเลือก "adb shell pm -h" ของตัวเลือก |
คิกรีเทิร์น | |
---|---|
String |
String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์
หมายเหตุ: เฉพาะ Use Case ที่ต้องควบคุมการให้สิทธิ์รันไทม์อย่างชัดเจนเท่านั้นจึงจะเรียกใช้ฟังก์ชันนี้ได้
พารามิเตอร์ | |
---|---|
packageFile |
File : ไฟล์ apk ที่จะติดตั้ง |
reinstall |
boolean : true หากควรทำการติดตั้งอีกครั้ง |
grantPermissions |
boolean : ควรให้สิทธิ์รันไทม์ทั้งหมดหรือไม่ ณ เวลาที่ติดตั้ง |
extraArgs |
String : อาร์กิวเมนต์เสริมที่ไม่บังคับที่จะส่ง โปรดดูตัวเลือก "adb shell pm -h" ของตัวเลือก |
คิกรีเทิร์น | |
---|---|
String |
String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ติดตั้งแพ็กเกจสำหรับผู้ใช้
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์สำหรับผู้ใช้ที่กำหนด
พารามิเตอร์ | |
---|---|
packageFile |
File : ไฟล์ apk ที่จะติดตั้ง |
reinstall |
boolean : true หากควรทำการติดตั้งอีกครั้ง |
userId |
int : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง |
extraArgs |
String : อาร์กิวเมนต์เสริมที่ไม่บังคับที่จะส่ง โปรดดูตัวเลือก "adb shell pm -h" ของตัวเลือก |
คิกรีเทิร์น | |
---|---|
String |
String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ติดตั้งแพ็กเกจสำหรับผู้ใช้
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์สำหรับผู้ใช้ที่กำหนด
หมายเหตุ: เฉพาะ Use Case ที่ต้องควบคุมการให้สิทธิ์รันไทม์อย่างชัดเจนเท่านั้นจึงจะเรียกใช้ฟังก์ชันนี้ได้
พารามิเตอร์ | |
---|---|
packageFile |
File : ไฟล์ apk ที่จะติดตั้ง |
reinstall |
boolean : true หากควรทำการติดตั้งอีกครั้ง |
grantPermissions |
boolean : ควรให้สิทธิ์รันไทม์ทั้งหมดหรือไม่ ณ เวลาที่ติดตั้ง |
userId |
int : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง |
extraArgs |
String : อาร์กิวเมนต์เสริมที่ไม่บังคับที่จะส่ง โปรดดูตัวเลือก "adb shell pm -h" ของตัวเลือก |
คิกรีเทิร์น | |
---|---|
String |
String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ไม่สามารถใช้งานพร็อพเพอร์ตี้แคช
public void invalidatePropertyCache ()
ISAdbTcp
public boolean isAdbTcp ()
คิกรีเทิร์น | |
---|---|
boolean |
รองรับ isAppEnumeration
public boolean isAppEnumerationSupported ()
ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการแจกแจงแอปหรือไม่
คิกรีเทิร์น | |
---|---|
boolean |
จริง หากรองรับการแจงนับแอป หรือเป็นเท็จหากไม่เป็นเช่นนั้น |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รองรับการปิดกั้นเป้าหมาย SDK ต่ำ
public boolean isBypassLowTargetSdkBlockSupported ()
ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการข้ามการบล็อก SDK เป้าหมายต่ำในการติดตั้งแอปหรือไม่
คิกรีเทิร์น | |
---|---|
boolean |
จริงหากรองรับการบล็อก SDK เป้าหมายระดับต่ำ มิเช่นนั้นให้เป็นเท็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ติดตั้ง isDebugfs
public boolean isDebugfsMounted ()
ตรวจสอบว่าได้ต่อเชื่อม debugf หรือไม่
คิกรีเทิร์น | |
---|---|
boolean |
true หากต่อเชื่อม debugf |
การขว้าง | |
---|---|
DeviceNotAvailableException |
isDeviceEncrypted
public boolean isDeviceEncrypted ()
แสดงผลหากอุปกรณ์เข้ารหัส
คิกรีเทิร์น | |
---|---|
boolean |
true หากอุปกรณ์เข้ารหัสไว้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ไดเรกทอรี
public boolean isDirectory (String path)
แสดงผล "จริง" หากเส้นทางในอุปกรณ์เป็นไดเรกทอรี มิเช่นนั้นจะเป็น "เท็จ"
พารามิเตอร์ | |
---|---|
path |
String |
คิกรีเทิร์น | |
---|---|
boolean |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เปิดใช้ AdbRoot
public boolean isEnableAdbRoot ()
คิกรีเทิร์น | |
---|---|
boolean |
true หากควรเปิดใช้ adb Root ในอุปกรณ์ |
รองรับการเข้ารหัส
public boolean isEncryptionSupported ()
แสดงผลหากอุปกรณ์รองรับการเข้ารหัส
คิกรีเทิร์น | |
---|---|
boolean |
true หากอุปกรณ์รองรับการเข้ารหัส |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เป็นไฟล์ปฏิบัติการ
public boolean isExecutable (String fullPath)
แสดงผลเป็น "จริง" หากเส้นทางของไฟล์ในอุปกรณ์เป็นไฟล์ปฏิบัติการ หรือเป็นเท็จ
พารามิเตอร์ | |
---|---|
fullPath |
String |
คิกรีเทิร์น | |
---|---|
boolean |
การขว้าง | |
---|---|
DeviceNotAvailableException |
isFastbootEnabled
public boolean isFastbootEnabled ()
แสดงผลหาก Fastboot พร้อมใช้งานสำหรับอุปกรณ์
คิกรีเทิร์น | |
---|---|
boolean |
เป็นแบบไม่มีส่วนหัว
public boolean isHeadless ()
แสดงผลเป็น "จริง" หากอุปกรณ์ไม่มีส่วนหัว (ไม่มีหน้าจอ) หรือเป็นเท็จ
คิกรีเทิร์น | |
---|---|
boolean |
การขว้าง | |
---|---|
DeviceNotAvailableException |
โหมดผู้ใช้ระบบไม่มีส่วนหัว
public boolean isHeadlessSystemUserMode ()
แสดงผลว่าอุปกรณ์ใช้โหมดผู้ใช้ระบบแบบไม่มีส่วนหัวหรือไม่
คิกรีเทิร์น | |
---|---|
boolean |
การขว้าง | |
---|---|
DeviceNotAvailableException |
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
จะแสดงผลว่าผู้ใช้หลักเป็นผู้ดูแลระบบแบบถาวร และจะลบหรือดาวน์เกรดเป็นสถานะที่ไม่ใช่ผู้ดูแลระบบไม่ได้
คิกรีเทิร์น | |
---|---|
boolean |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รองรับผู้ใช้หลายคน
public boolean isMultiUserSupported ()
กำหนดว่ารองรับผู้ใช้หลายคนหรือไม่
คิกรีเทิร์น | |
---|---|
boolean |
จริง หากมีการสนับสนุนผู้ใช้หลายคน เป็นเท็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ติดตั้งแพ็กเกจแล้ว
public boolean isPackageInstalled (String packageName, String userId)
ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจและรหัสผู้ใช้ที่กำหนดเพื่อตรวจสอบว่าอุปกรณ์ได้รับการติดตั้งอยู่หรือไม่สำหรับผู้ใช้รายนั้น
พารามิเตอร์ | |
---|---|
packageName |
String : แพ็กเกจที่เรากำลังตรวจสอบว่ามีการติดตั้งแล้วหรือยัง |
userId |
String : รหัสผู้ใช้ที่เรากำลังตรวจสอบแพ็กเกจได้รับการติดตั้งแล้ว หากเป็น Null ระบบจะใช้ 0 ของผู้ใช้หลัก |
คิกรีเทิร์น | |
---|---|
boolean |
เป็นจริงหากมีการรายงานว่าแพ็กเกจติดตั้งแล้ว เป็นเท็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ติดตั้งแพ็กเกจแล้ว
public boolean isPackageInstalled (String packageName)
ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจที่ระบุเพื่อตรวจสอบว่าอุปกรณ์ติดตั้งอยู่หรือไม่
พารามิเตอร์ | |
---|---|
packageName |
String |
คิกรีเทิร์น | |
---|---|
boolean |
เป็นจริงหากมีการรายงานว่าแพ็กเกจติดตั้งแล้ว เป็นเท็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รองรับรันไทม์ไหม
public boolean isRuntimePermissionSupported ()
ตรวจสอบว่าแพลตฟอร์มในอุปกรณ์รองรับการให้สิทธิ์รันไทม์หรือไม่
คิกรีเทิร์น | |
---|---|
boolean |
เป็นจริงหากรองรับสิทธิ์รันไทม์ มิเช่นนั้นจะเป็น "เท็จ" |
การขว้าง | |
---|---|
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
แสดงค่า "จริง" หากอุปกรณ์อยู่ใน TestDeviceState#FASTBOOT
หรือ TestDeviceState.FASTBOOTD
คิกรีเทิร์น | |
---|---|
boolean |
ผู้ใช้กำลังทำงาน
public boolean isUserRunning (int userId)
ตรวจสอบว่าผู้ใช้ที่กำหนดกำลังทำงานอยู่หรือไม่
พารามิเตอร์ | |
---|---|
userId |
int |
คิกรีเทิร์น | |
---|---|
boolean |
จริงหากผู้ใช้ทำงานอยู่ ค่าเป็นเท็จในกรณีอื่นๆ ทั้งหมด |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เป็นผู้ใช้รอง
public boolean isUserSecondary (int userId)
แสดงผลว่าผู้ใช้ที่ระบุเป็นผู้ใช้รองตามการแจ้งว่าไม่เหมาะสมหรือไม่
พารามิเตอร์ | |
---|---|
userId |
int |
คิกรีเทิร์น | |
---|---|
boolean |
"จริง" หากผู้ใช้เป็นรอง หรือเป็นเท็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
มองเห็นได้
public boolean isUserVisible (int userId)
ตรวจสอบว่าผู้ใช้ที่ระบุมองเห็นได้หรือไม่
ผู้ใช้ที่ "มองเห็นได้" คือผู้ใช้ที่มีการโต้ตอบกับผู้ใช้ "มนุษย์" จึงสามารถเปิดกิจกรรมการเปิดตัวได้ (โดยทั่วไปจะอยู่ในจอแสดงผลเริ่มต้น)
พารามิเตอร์ | |
---|---|
userId |
int |
คิกรีเทิร์น | |
---|---|
boolean |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เป็นUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
ตรวจสอบว่าผู้ใช้ที่ระบุปรากฏในจอแสดงผลหรือไม่
ผู้ใช้ที่ "มองเห็นได้" คือผู้ใช้ที่มีการโต้ตอบกับผู้ใช้ "มนุษย์" จึงสามารถเปิดกิจกรรมการเปิดตัวในจอแสดงผลนั้นได้
พารามิเตอร์ | |
---|---|
userId |
int |
displayId |
int |
คิกรีเทิร์น | |
---|---|
boolean |
การขว้าง | |
---|---|
DeviceNotAvailableException |
VisibleBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
แสดงผลว่าอุปกรณ์อนุญาตให้ผู้ใช้เริ่มแสดงการทำงานในเบื้องหลังหรือไม่ใน ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
หากใช่ คุณอาจเรียกใช้ startVisibleBackgroundUser(int, int, boolean)
ที่ส่งผ่านจอแสดงผลที่แสดงผลโดย listDisplayIdsForStartingVisibleBackgroundUsers()
(ซึ่งควรมี ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
)
คิกรีเทิร์น | |
---|---|
boolean |
การขว้าง | |
---|---|
DeviceNotAvailableException |
การแสดงข้อมูลพื้นหลังของผู้ใช้
public boolean isVisibleBackgroundUsersSupported ()
แสดงผลว่าอุปกรณ์อนุญาตให้เริ่มแสดงผู้ใช้ในเบื้องหลังหรือไม่
หากใช่ คุณจะเรียกใช้ startVisibleBackgroundUser(int, int, boolean)
ได้โดยการส่งจอแสดงผลที่ listDisplayIdsForStartingVisibleBackgroundUsers()
แสดงผล
คิกรีเทิร์น | |
---|---|
boolean |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เปิดใช้
public boolean isWifiEnabled ()
ทดสอบว่าเปิดใช้ Wi-Fi อยู่หรือไม่
ตรวจสอบว่าอุปกรณ์เปิดใช้ Wi-Fi หรือไม่ มีประโยชน์ในการยืนยันสถานะ Wi-Fi ก่อนการทดสอบที่ไม่ควรทำงานกับ Wi-Fi เช่น การทดสอบอินเทอร์เน็ตมือถือ
คิกรีเทิร์น | |
---|---|
boolean |
true หากเปิดใช้ Wi-Fi อยู่ false หากปิดใช้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รายการรหัส Display
publiclistDisplayIds ()
รวบรวมรายการรหัสแสดงที่มีอยู่ในอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger"
คิกรีเทิร์น | |
---|---|
|
รายการจอแสดงผล ค่าเริ่มต้นจะแสดงการแสดงผลเริ่มต้นเป็น 0 เสมอ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
แสดงรายการรหัสดิสเพลย์สำหรับเริ่มต้นผู้ใช้พื้นหลังที่มองเห็นได้
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
รับรายการจอแสดงผลที่ใช้เพื่อstart a user visible in the background
ได้
คิกรีเทิร์น | |
---|---|
|
การขว้าง | |
---|---|
DeviceNotAvailableException |
แสดงรายการผู้ใช้
publiclistUsers ()
รับรายชื่อผู้ใช้ในอุปกรณ์ จะแสดงผล 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() |
รีบูตแบบไม่บล็อก
public void nonBlockingReboot ()
ออกคำสั่งให้รีบูตอุปกรณ์และส่งคืนเมื่อคำสั่งเสร็จสมบูรณ์ และเมื่ออุปกรณ์ไม่แสดงต่อ adb อีกต่อไป
การขว้าง | |
---|---|
DeviceNotAvailableException |
AdbRootAction
public void postAdbRootAction ()
ลบล้างในกรณีที่อุปกรณ์ต้องดำเนินการบางอย่างหลังจากรูท adb และก่อนที่อุปกรณ์จะออนไลน์อีกครั้ง การใช้งานเริ่มต้นไม่รวมการดำเนินการเพิ่มใดๆ ไม่มีการรับประกันว่าจะเปิดใช้รูท adb ในขั้นตอนนี้
การขว้าง | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
การดำเนินการ PostbUnrootAction
public void postAdbUnrootAction ()
ลบล้างในกรณีที่อุปกรณ์จำเป็นต้องดำเนินการบางอย่างหลังจากยกเลิกการรูทและก่อนที่อุปกรณ์จะออนไลน์อีกครั้ง การใช้งานเริ่มต้นไม่รวมการดำเนินการเพิ่มเติมใดๆ ไม่มีการรับประกันว่าจะปิดใช้ adb Root ในขั้นตอนนี้
การขว้าง | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
การตั้งค่าหลังจากเปิดเครื่อง
public void postBootSetup ()
ทำตามวิธีการกำหนดค่าอุปกรณ์สำหรับการทดสอบหลังจากเปิดเครื่องทุกครั้ง
ควรเรียกใช้หลังจากอุปกรณ์เปิดเครื่องอย่างสมบูรณ์/พร้อมใช้งาน
ในกรณีปกติ คุณไม่จำเป็นต้องเรียกใช้เมธอดนี้อย่างชัดแจ้ง เนื่องจากการติดตั้งใช้งานควรทำขั้นตอนเหล่านี้โดยอัตโนมัติเมื่อรีบูต
ตำแหน่งที่อาจต้องเรียกคือเมื่ออุปกรณ์รีบูตเนื่องจากเหตุการณ์อื่นๆ (เช่น เมื่อคำสั่งอัปเดต Fastboot เสร็จสมบูรณ์)
การขว้าง | |
---|---|
DeviceNotAvailableException |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
ขั้นตอนเพิ่มเติมสำหรับการทำความสะอาดที่จำเป็นเฉพาะอุปกรณ์ซึ่งจะดำเนินการหลังจากการเรียกใช้เสร็จสิ้นแล้ว
พารามิเตอร์ | |
---|---|
exception |
Throwable : หากมี ข้อยกเว้นสุดท้ายที่เพิ่มขึ้นเนื่องจากการเรียกใช้ล้มเหลว |
ตั้งค่าการเรียกใช้ล่วงหน้า
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
ขั้นตอนเพิ่มเติมสำหรับการตั้งค่าที่จำเป็นเฉพาะอุปกรณ์ซึ่งจะดำเนินการในอุปกรณ์ก่อนขั้นตอนการเรียกใช้
พารามิเตอร์ | |
---|---|
info |
IBuildInfo : IBuildInfo ของอุปกรณ์ |
attributes |
MultiMap : แอตทริบิวต์ที่จัดเก็บไว้ในบริบทการเรียกใช้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
PullDir
public boolean pullDir (String deviceFilePath, File localDir, int userId)
ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์ซ้ำๆ
พารามิเตอร์ | |
---|---|
deviceFilePath |
String : เส้นทางไฟล์สัมบูรณ์ของแหล่งที่มาระยะไกล |
localDir |
File : ไดเรกทอรีในเครื่องที่จะดึงไฟล์เข้าไป |
userId |
int : รหัสผู้ใช้ที่จะดึงข้อมูล |
คิกรีเทิร์น | |
---|---|
boolean |
true หากดึงไฟล์สำเร็จ จ่าย false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
PullDir
public boolean pullDir (String deviceFilePath, File localDir)
ดึงเนื้อหาไดเรกทอรีจากอุปกรณ์ซ้ำๆ
พารามิเตอร์ | |
---|---|
deviceFilePath |
String : เส้นทางไฟล์สัมบูรณ์ของแหล่งที่มาระยะไกล |
localDir |
File : ไดเรกทอรีในเครื่องที่จะดึงไฟล์เข้าไป |
คิกรีเทิร์น | |
---|---|
boolean |
true หากดึงไฟล์สำเร็จ จ่าย false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
PullFile
public boolean pullFile (String remoteFilePath, File localFile)
ดึงข้อมูลไฟล์ออกจากอุปกรณ์
พารามิเตอร์ | |
---|---|
remoteFilePath |
String : เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์ |
localFile |
File : ไฟล์ในเครื่องที่จะจัดเก็บเนื้อหา หากไม่ว่างเปล่า ระบบจะแทนที่เนื้อหา |
คิกรีเทิร์น | |
---|---|
boolean |
true หากเรียกข้อมูลไฟล์สำเร็จ จ่าย false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
PullFile
public File pullFile (String remoteFilePath, int userId)
เรียกดูไฟล์จากอุปกรณ์ จัดเก็บไว้ใน ERROR(/File)
ชั่วคราวในเครื่อง และส่งคืน File
นั้น
พารามิเตอร์ | |
---|---|
remoteFilePath |
String : เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์ |
userId |
int : รหัสผู้ใช้ที่จะดึงข้อมูล |
คิกรีเทิร์น | |
---|---|
File |
ERROR(/File) ที่มีเนื้อหาของไฟล์อุปกรณ์ หรือ null หากคัดลอกไม่สำเร็จไม่ว่าด้วยเหตุผลใดก็ตาม (รวมถึงปัญหาเกี่ยวกับระบบไฟล์ของโฮสต์) |
การขว้าง | |
---|---|
DeviceNotAvailableException |
PullFile
public File pullFile (String remoteFilePath)
เรียกดูไฟล์จากอุปกรณ์ จัดเก็บไว้ใน ERROR(/File)
ชั่วคราวในเครื่อง และส่งคืน File
นั้น
พารามิเตอร์ | |
---|---|
remoteFilePath |
String : เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์ |
คิกรีเทิร์น | |
---|---|
File |
ERROR(/File) ที่มีเนื้อหาของไฟล์อุปกรณ์ หรือ null หากคัดลอกไม่สำเร็จไม่ว่าด้วยเหตุผลใดก็ตาม (รวมถึงปัญหาเกี่ยวกับระบบไฟล์ของโฮสต์) |
การขว้าง | |
---|---|
DeviceNotAvailableException |
PullFile
public boolean pullFile (String remoteFilePath, File localFile, int userId)
ดึงข้อมูลไฟล์ออกจากอุปกรณ์
พารามิเตอร์ | |
---|---|
remoteFilePath |
String : เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์ |
localFile |
File : ไฟล์ในเครื่องที่จะจัดเก็บเนื้อหา หากไม่ว่างเปล่า ระบบจะแทนที่เนื้อหา |
userId |
int : รหัสผู้ใช้ที่จะดึงข้อมูล |
คิกรีเทิร์น | |
---|---|
boolean |
true หากเรียกข้อมูลไฟล์สำเร็จ จ่าย false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
PullFileContents
public String pullFileContents (String remoteFilePath)
ดึงไฟล์ออกจากอุปกรณ์ และแสดงเนื้อหา
พารามิเตอร์ | |
---|---|
remoteFilePath |
String : เส้นทางสัมบูรณ์ไปยังไฟล์ในอุปกรณ์ |
คิกรีเทิร์น | |
---|---|
String |
String ที่มีเนื้อหาของไฟล์อุปกรณ์ หรือ null หากคัดลอกไม่สำเร็จไม่ว่าด้วยเหตุผลใดก็ตาม (รวมถึงปัญหาเกี่ยวกับระบบไฟล์ของโฮสต์) |
การขว้าง | |
---|---|
DeviceNotAvailableException |
PullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
วิธีที่สะดวกในการดึงข้อมูลไฟล์จากพื้นที่เก็บข้อมูลภายนอกของอุปกรณ์ จัดเก็บไฟล์ไว้ใน ERROR(/File)
ชั่วคราวในเครื่อง และส่งกลับการอ้างอิงไปยัง File
นั้น
พารามิเตอร์ | |
---|---|
remoteFilePath |
String : เส้นทางไปยังไฟล์ในอุปกรณ์ที่สัมพันธ์กับจุดต่อเชื่อมพื้นที่เก็บข้อมูลภายนอกของอุปกรณ์ |
คิกรีเทิร์น | |
---|---|
File |
ERROR(/File) ที่มีเนื้อหาของไฟล์อุปกรณ์ หรือ null หากคัดลอกไม่สำเร็จไม่ว่าด้วยเหตุผลใดก็ตาม (รวมถึงปัญหาเกี่ยวกับระบบไฟล์ของโฮสต์) |
การขว้าง | |
---|---|
DeviceNotAvailableException |
พุชDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์ซ้ำๆ ขณะที่ยกเว้นบางไดเรกทอรีที่มีการกรอง
พารามิเตอร์ | |
---|---|
localFileDir |
File : ไดเรกทอรีในเครื่องที่จะพุช |
deviceFilePath |
String : เส้นทางไฟล์สัมบูรณ์ของปลายทางระยะไกล |
excludedDirectories |
: ชุดชื่อไดเรกทอรีที่ยกเว้นที่ไม่ควรพุช |
คิกรีเทิร์น | |
---|---|
boolean |
true หากพุชไฟล์สำเร็จ จ่าย false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
พุชDir
public boolean pushDir (File localFileDir, String deviceFilePath)
พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์ซ้ำ
พารามิเตอร์ | |
---|---|
localFileDir |
File : ไดเรกทอรีในเครื่องที่จะพุช |
deviceFilePath |
String : เส้นทางไฟล์สัมบูรณ์ของปลายทางระยะไกล |
คิกรีเทิร์น | |
---|---|
boolean |
true หากพุชไฟล์สำเร็จ จ่าย false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
พุชDir
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
พุชเนื้อหาไดเรกทอรีไปยังอุปกรณ์ซ้ำ
พารามิเตอร์ | |
---|---|
localFileDir |
File : ไดเรกทอรีในเครื่องที่จะพุช |
deviceFilePath |
String : เส้นทางไฟล์สัมบูรณ์ของปลายทางระยะไกล |
userId |
int : รหัสผู้ใช้ที่จะพุชไปยัง |
คิกรีเทิร์น | |
---|---|
boolean |
true หากพุชไฟล์สำเร็จ จ่าย false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
PushFile
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
ตัวแปรของ pushFile(File, String)
ซึ่งคุณอาจพิจารณาประเมินความจำเป็นสำหรับผู้ให้บริการเนื้อหาได้
พารามิเตอร์ | |
---|---|
localFile |
File : ไฟล์ในเครื่องที่จะพุช |
remoteFilePath |
String : เส้นทางไฟล์สัมบูรณ์ของปลายทางระยะไกล |
evaluateContentProviderNeeded |
boolean : จะตรวจสอบว่าเราต้องการผู้ให้บริการเนื้อหาหรือไม่ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากพุชไฟล์สำเร็จ จ่าย false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
PushFile
public boolean pushFile (File localFile, String remoteFilePath)
ส่งไฟล์ไปยังอุปกรณ์ โดยค่าเริ่มต้น จะใช้ผู้ให้บริการเนื้อหา
พารามิเตอร์ | |
---|---|
localFile |
File : ไฟล์ในเครื่องที่จะพุช |
remoteFilePath |
String : เส้นทางไฟล์สัมบูรณ์ของปลายทางระยะไกล |
คิกรีเทิร์น | |
---|---|
boolean |
true หากพุชไฟล์สำเร็จ จ่าย false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
PushFile
public boolean pushFile (File localFile, String remoteFilePath, int userId)
ส่งไฟล์ไปยังอุปกรณ์ โดยค่าเริ่มต้น จะใช้ผู้ให้บริการเนื้อหา
พารามิเตอร์ | |
---|---|
localFile |
File : ไฟล์ในเครื่องที่จะพุช |
remoteFilePath |
String : เส้นทางไฟล์สัมบูรณ์ของปลายทางระยะไกล |
userId |
int : รหัสผู้ใช้ที่จะพุชไปยัง |
คิกรีเทิร์น | |
---|---|
boolean |
true หากพุชไฟล์สำเร็จ จ่าย false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
สตริงพุช
public boolean pushString (String contents, String remoteFilePath)
สร้างไฟล์พุชจากสตริงไปยังอุปกรณ์แล้ว
พารามิเตอร์ | |
---|---|
contents |
String : เนื้อหาของไฟล์ที่จะพุช |
remoteFilePath |
String : เส้นทางไฟล์สัมบูรณ์ของปลายทางระยะไกล |
คิกรีเทิร์น | |
---|---|
boolean |
true หากพุชสตริงสำเร็จ จ่าย false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รีบูต
public void reboot (String reason)
รีบูตอุปกรณ์ให้เข้าสู่โหมด adb โดยใช้ reason
ที่ให้ไว้เพื่อให้คงอยู่ตลอดในการรีบูต
บล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน
ดูเหตุผลที่รีบูตครั้งล่าสุดได้ด้วยการค้นหาพร็อพเพอร์ตี้ sys.boot.reason
พารามิเตอร์ | |
---|---|
reason |
String : สาเหตุของการรีบูตนี้ หรือ null หากไม่ได้ระบุเหตุผล |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รีบูต
public void reboot ()
รีบูตอุปกรณ์ให้เข้าสู่โหมด adb
บล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน
การขว้าง | |
---|---|
DeviceNotAvailableException |
รีบูตIntoBootloader
public void rebootIntoBootloader ()
รีบูตอุปกรณ์ให้เข้าสู่โหมด Bootloader
บล็อกจนกว่าอุปกรณ์จะอยู่ในโหมด Bootloader
การขว้าง | |
---|---|
DeviceNotAvailableException |
รีบูตIntoFastbootd
public void rebootIntoFastbootd ()
รีบูตอุปกรณ์ให้เข้าสู่ Fastbootd Mode
บล็อกจนกว่าอุปกรณ์จะอยู่ในโหมด Fastbootd
การขว้าง | |
---|---|
DeviceNotAvailableException |
รีบูตIntoRecovery
public void rebootIntoRecovery ()
รีบูตอุปกรณ์ให้เข้าสู่โหมดการกู้คืน adb
บล็อกจนกว่าอุปกรณ์จะเข้าสู่การกู้คืน
การขว้าง | |
---|---|
DeviceNotAvailableException |
BootIntoSideload
public void rebootIntoSideload ()
รีบูตอุปกรณ์ให้เข้าสู่โหมด adb Sideload (โปรดทราบว่านี่เป็นโหมดพิเศษที่อยู่ภายใต้การกู้คืน)
บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดโหลดจากแหล่งที่ไม่รู้จัก
การขว้าง | |
---|---|
DeviceNotAvailableException |
BootIntoSideload
public void rebootIntoSideload (boolean autoReboot)
รีบูตอุปกรณ์ให้เข้าสู่โหมด adb Sideload (โปรดทราบว่านี่เป็นโหมดพิเศษที่อยู่ภายใต้การกู้คืน)
บล็อกจนกว่าอุปกรณ์จะเข้าสู่โหมดโหลดจากแหล่งที่ไม่รู้จัก
พารามิเตอร์ | |
---|---|
autoReboot |
boolean : ต้องการรีบูตอุปกรณ์โดยอัตโนมัติหลังจากไซด์โหลดหรือไม่ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รีบูตจนถึงออนไลน์
public void rebootUntilOnline ()
ทางเลือกเป็น reboot()
ที่บล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น นั่นคือ แสดงต่อ adb
การขว้าง | |
---|---|
DeviceNotAvailableException |
รีบูตจนถึงออนไลน์
public void rebootUntilOnline (String reason)
ทางเลือกเป็น reboot()
ที่บล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น นั่นคือ แสดงต่อ adb
พารามิเตอร์ | |
---|---|
reason |
String : สาเหตุของการรีบูตนี้ หรือ null หากไม่ได้ระบุเหตุผล |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รีบูตUserspace
public void rebootUserspace ()
รีบูตเฉพาะส่วนพื้นที่ผู้ใช้ของอุปกรณ์
บล็อกจนกว่าอุปกรณ์จะพร้อมใช้งาน
คำเตือน การรีบูต Userspace กำลังอยู่ระหว่างการพัฒนา โปรดใช้โดยยอมรับความเสี่ยงของคุณเอง
การขว้าง | |
---|---|
DeviceNotAvailableException |
รีบูตผู้ใช้พื้นที่จนถึงออนไลน์
public void rebootUserspaceUntilOnline ()
ทางเลือกของ rebootUserspace()
()} ที่จะบล็อกจนกว่าอุปกรณ์จะออนไลน์เท่านั้น นั่นคือ
การแสดงผลต่อ adb
การขว้าง | |
---|---|
DeviceNotAvailableException |
กู้คืนอุปกรณ์
public boolean recoverDevice ()
ความพยายามที่จะกู้คืนการสื่อสารกับอุปกรณ์
คิกรีเทิร์น | |
---|---|
boolean |
จริง หากพยายามกู้คืนแต่สําเร็จ แสดงผลเป็น "เท็จ" หากข้ามการกู้คืน |
การขว้าง | |
---|---|
DeviceNotAvailableException |
หากอุปกรณ์ไม่พร้อมใช้งานอีกต่อไป |
ตัวรับการดำเนินการของอุปกรณ์
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
ลงทะเบียน IDeviceActionReceiver
สำหรับอุปกรณ์นี้
IDeviceActionReceiver
ที่ลงทะเบียนไว้ทั้งหมดจะได้รับการแจ้งเตือนก่อนที่การดำเนินการของอุปกรณ์จะเริ่มและหลังจากการดำเนินการของอุปกรณ์สิ้นสุดลง
พารามิเตอร์ | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : IDeviceActionReceiver ซึ่งจะมีการลงทะเบียน |
remountSystemReadOnly
public void remountSystemReadOnly ()
กำหนดให้พาร์ติชันระบบในอุปกรณ์เป็นแบบอ่านอย่างเดียว อาจรีบูตอุปกรณ์
การขว้าง | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
ทำให้พาร์ติชันระบบในอุปกรณ์เขียนได้ อาจรีบูตอุปกรณ์
การขว้าง | |
---|---|
DeviceNotAvailableException |
remountVendorReadOnly
public void remountVendorReadOnly ()
กำหนดพาร์ติชันผู้ให้บริการในอุปกรณ์เป็นแบบอ่านอย่างเดียว อาจรีบูตอุปกรณ์
การขว้าง | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public void remountVendorWritable ()
ทำให้พาร์ติชันผู้ให้บริการในอุปกรณ์เขียนได้ อาจรีบูตอุปกรณ์
การขว้าง | |
---|---|
DeviceNotAvailableException |
นำผู้ดูแลระบบออก
public boolean removeAdmin (String componentName, int userId)
นำผู้ดูแลระบบอุปกรณ์ที่กำหนดในผู้ใช้รายนั้นออก แล้วแสดงผล true
หากยืนยันสำเร็จ มิฉะนั้นจะเป็น false
พารามิเตอร์ | |
---|---|
componentName |
String : จากผู้ดูแลระบบอุปกรณ์ที่จะนำออก |
userId |
int : ของผู้ใช้ที่ผู้ดูแลอุปกรณ์อยู่ |
คิกรีเทิร์น | |
---|---|
boolean |
จริง หากสำเร็จ หรือเป็นเท็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
นำเจ้าของออก
public void removeOwners ()
นำเจ้าของโปรไฟล์อุปกรณ์ที่มีอยู่ทั้งหมดออกอย่างดีที่สุด
การขว้าง | |
---|---|
DeviceNotAvailableException |
นำผู้ใช้ออก
public boolean removeUser (int userId)
นำผู้ใช้ที่ระบุออกจากอุปกรณ์
พารามิเตอร์ | |
---|---|
userId |
int : ของผู้ใช้ที่จะนำออก |
คิกรีเทิร์น | |
---|---|
boolean |
true หากเรานำผู้ใช้ออกจากระบบสำเร็จ มิฉะนั้นจะเป็นเท็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รีเซ็ตContentProviderSetup
public void resetContentProviderSetup ()
รีเซ็ตธงของการตั้งค่าผู้ให้บริการเนื้อหาเพื่อให้ทริกเกอร์อีกครั้ง
RuninstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
วิธีการที่สะดวกในการทำ ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
ที่มี Listener อย่างน้อย 1 รายการที่ส่งผ่านเป็นพารามิเตอร์
พารามิเตอร์ | |
---|---|
runner |
IRemoteAndroidTestRunner : IRemoteAndroidTestRunner ที่ทำการทดสอบ |
listeners |
ITestLifeCycleReceiver : ผู้ฟังผลการทดสอบ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากคำสั่งทดสอบเสร็จสมบูรณ์ false หากไม่สำเร็จ แต่กู้คืนสำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
RuninstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
ทดสอบการใช้เครื่องมือและกู้คืนอุปกรณ์
หากการเชื่อมต่อกับอุปกรณ์ขาดหายก่อนที่การทดสอบจะเสร็จสมบูรณ์และการกู้คืนสำเร็จ ระบบจะแจ้งให้ Listener ทั้งหมดทราบว่า testRunFailed และผลลัพธ์เป็น "เท็จ" ระบบจะไม่เรียกใช้คำสั่งทดสอบอีกครั้ง ระบบจะแจ้งให้ผู้โทรลองอีกครั้งหากจำเป็น
หากการเชื่อมต่อกับอุปกรณ์ขาดหายก่อนที่การทดสอบจะเสร็จสมบูรณ์และการกู้คืนไม่สำเร็จ ระบบจะแจ้ง Listener ทั้งหมดเกี่ยวกับ testRunFailed และมีการส่ง DeviceNotavailableException
พารามิเตอร์ | |
---|---|
runner |
IRemoteAndroidTestRunner : IRemoteAndroidTestRunner ที่ทำการทดสอบ |
listeners |
: ผู้ฟังผลการทดสอบ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากคำสั่งทดสอบเสร็จสมบูรณ์ false หากดำเนินการไม่สำเร็จเนื่องจากข้อยกเว้นการสื่อสารของอุปกรณ์ แต่กู้คืนสำเร็จแล้ว |
การขว้าง | |
---|---|
DeviceNotAvailableException |
RuninstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
เหมือนกับ ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
แต่เรียกใช้การทดสอบสำหรับผู้ใช้ที่ระบุ
พารามิเตอร์ | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
คิกรีเทิร์น | |
---|---|
boolean |
การขว้าง | |
---|---|
DeviceNotAvailableException |
RuninstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
เหมือนกับ ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
แต่ทำการทดสอบสำหรับผู้ใช้ที่ระบุ
พารามิเตอร์ | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
คิกรีเทิร์น | |
---|---|
boolean |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ตั้งค่าการกำหนดค่า
public void setConfiguration (IConfiguration configuration)
แทรก IConfiguration
ที่ใช้งานอยู่
พารามิเตอร์ | |
---|---|
configuration |
IConfiguration |
ตั้งค่าการเชื่อมต่อAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
พารามิเตอร์ | |
---|---|
avdInfo |
GceAvdInfo |
setDate
public void setDate (Date date)
ตั้งค่าวันที่ในอุปกรณ์
หมายเหตุ: การตั้งค่าวันที่ในอุปกรณ์จำเป็นต้องรูท
พารามิเตอร์ | |
---|---|
date |
Date : ระบุวันที่ที่เจาะจง จะใช้วันที่ของโฮสต์หาก null |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ตั้งค่าอุปกรณ์เจ้าของ
public boolean setDeviceOwner (String componentName, int userId)
ตั้งคอมโพเนนต์ผู้ดูแลระบบอุปกรณ์เป็นเจ้าของอุปกรณ์ในผู้ใช้ที่กำหนด
พารามิเตอร์ | |
---|---|
componentName |
String : จากผู้ดูแลอุปกรณ์ที่จะเป็นเจ้าของอุปกรณ์ |
userId |
int : ของผู้ใช้ที่เป็นเจ้าของอุปกรณ์ |
คิกรีเทิร์น | |
---|---|
boolean |
จริง หากสำเร็จ หรือเป็นเท็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ตั้งค่าสถานะของอุปกรณ์
public void setDeviceState (TestDeviceState deviceState)
อัปเดตสถานะของอุปกรณ์
พารามิเตอร์ | |
---|---|
deviceState |
TestDeviceState : TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
สำหรับโปรแกรมจำลอง ให้ตั้งค่า SizeLimitedOutputStream
เพื่อบันทึกเอาต์พุต
พารามิเตอร์ | |
---|---|
output |
SizeLimitedOutputStream : เพื่อบันทึกเอาต์พุต |
setEmulatorProcess
public void setEmulatorProcess (Process p)
ตั้งค่า Process
เมื่ออุปกรณ์นี้เป็นโปรแกรมจำลอง
พารามิเตอร์ | |
---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
ตั้งค่าตัวเลือก Fastboot สำหรับอุปกรณ์ ควรตั้งค่าเมื่อมีการจัดสรรอุปกรณ์เป็นครั้งแรก
พารามิเตอร์ | |
---|---|
fastbootEnabled |
boolean : Fastboot พร้อมใช้งานสำหรับอุปกรณ์หรือไม่ |
setFastbootPath
public void setFastbootPath (String fastbootPath)
กำหนดเส้นทางไปยังไบนารีของ Fastboot ที่ควรใช้
ยังคงต้องใช้ isFastbootEnabled()
เป็น "จริง" เพื่อเปิดใช้ฟังก์ชัน Fastboot
พารามิเตอร์ | |
---|---|
fastbootPath |
String |
ตั้งค่าอุปกรณ์
public void setIDevice (IDevice newDevice)
อัปเดต IDevice ที่เชื่อมโยงกับ ITestDevice นี้
IDevice ใหม่ต้องอ้างอิงอุปกรณ์จริงเครื่องเดียวกันกับข้อมูลอ้างอิงปัจจุบัน ระบบจะเรียกเมธอดนี้หาก DDMS จัดสรร IDevice ใหม่
พารามิเตอร์ | |
---|---|
newDevice |
IDevice : IDevice |
ตั้งค่าLogStartDelay
public void setLogStartDelay (int delay)
ตั้งเวลาเป็นมิลลิวินาทีให้รอก่อนเริ่มจับภาพ Logcat สำหรับอุปกรณ์ออนไลน์
พารามิเตอร์ | |
---|---|
delay |
int : ล่าช้าเป็นมิลลิวินาที |
setOptions
public void setOptions (TestDeviceOptions options)
ตั้งค่า TestDeviceOptions
สำหรับอุปกรณ์
พารามิเตอร์ | |
---|---|
options |
TestDeviceOptions |
ตั้งค่าพร็อพเพอร์ตี้
public boolean setProperty (String propKey, String propValue)
ตั้งค่าพร็อพเพอร์ตี้ที่ระบุในอุปกรณ์ ต้องมีราก adb เป็น "จริง"
พารามิเตอร์ | |
---|---|
propKey |
String : คีย์ที่กำหนดเป้าหมายที่จะต้องตั้งค่า |
propValue |
String : ค่าพร็อพเพอร์ตี้ที่จะตั้งค่า |
คิกรีเทิร์น | |
---|---|
boolean |
จะแสดงผล True หากคำสั่ง setprop สำเร็จ แสดงผลเป็น "เท็จ" หากไม่เป็นเช่นนั้น |
การขว้าง | |
---|---|
DeviceNotAvailableException |
SetRecovery
public void setRecovery (IDeviceRecovery recovery)
ตั้งค่า IDeviceRecovery
เพื่อใช้กับอุปกรณ์นี้ ควรตั้งค่าเมื่อมีการจัดสรรอุปกรณ์เป็นครั้งแรก
พารามิเตอร์ | |
---|---|
recovery |
IDeviceRecovery : IDeviceRecovery |
ตั้งโหมดการกู้คืน
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
ตั้งค่าโหมดการกู้คืนปัจจุบันเพื่อใช้กับอุปกรณ์
ใช้เพื่อควบคุมวิธีการกู้คืนที่จะใช้เมื่อพบปัญหาการสื่อสารของอุปกรณ์ ขอแนะนำให้ใช้วิธีนี้อย่างจำกัดเมื่อจำเป็นเท่านั้น (เช่น เมื่อเฟรมเวิร์กหยุดทำงาน ฯลฯ
พารามิเตอร์ | |
---|---|
mode |
ITestDevice.RecoveryMode : ควรเปิดโหมด "กู้คืนจนถึงออนไลน์เท่านั้น" หรือไม่ |
ตั้งค่าการตั้งค่า
public void setSetting (String namespace, String key, String value)
ดู setSetting(int, String, String, String)
และดำเนินการกับผู้ใช้ระบบ
พารามิเตอร์ | |
---|---|
namespace |
String |
key |
String |
value |
String |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ตั้งค่าการตั้งค่า
public void setSetting (int userId, String namespace, String key, String value)
เพิ่มค่าการตั้งค่าไปยังเนมสเปซของผู้ใช้ที่กำหนด การตั้งค่าบางอย่างจะพร้อมใช้งานหลังจากการรีบูตเท่านั้น Namespace ต้องเป็น {"system", "secure", "global"}
พารามิเตอร์ | |
---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
การขว้าง | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
แทรกอินสแตนซ์ ITestLogger
พารามิเตอร์ | |
---|---|
testLogger |
ITestLogger |
ตั้งค่าUseFastbootErase
public void setUseFastbootErase (boolean useFastbootErase)
ตั้งค่าว่าจะใช้รูปแบบ Fastboot หากต้องการลบหรือ Fastboot เพื่อล้างข้อมูลพาร์ติชันในอุปกรณ์
พารามิเตอร์ | |
---|---|
useFastbootErase |
boolean : true หากควรใช้ Fastboot Delete หรือ false หากควรใช้รูปแบบ Fastboot |
StartLogcat
public void startLogcat ()
เริ่มบันทึกเอาต์พุต Logcat จากอุปกรณ์ในเบื้องหลัง
จะไม่มีผลหากบันทึกเอาต์พุต Logcat อยู่แล้ว สามารถดึงข้อมูลในภายหลังได้ผ่านทาง getLogcat
เมื่อไม่มีการใช้งานอุปกรณ์แล้ว จะต้องโทรหา stopLogcat()
ปกติแล้วคุณไม่จำเป็นต้องเรียกใช้ startLogcat()
และ stopLogcat()
เมื่ออยู่ในบริบทการเรียกใช้ TF เนื่องจากเฟรมเวิร์ก TF จะเริ่มต้นและหยุด Logcat
ผู้ใช้เริ่มต้น
public boolean startUser (int userId)
เริ่มต้นผู้ใช้หนึ่งๆ ในพื้นหลังหากหยุดทำงานอยู่ หากผู้ใช้ทำงานอยู่เบื้องหลังอยู่แล้ว วิธีนี้ก็เป็นแบบ NOOP
พารามิเตอร์ | |
---|---|
userId |
int : ของผู้ใช้ที่จะเริ่มต้นทำงานในเบื้องหลัง |
คิกรีเทิร์น | |
---|---|
boolean |
true ถ้าเริ่มต้นผู้ใช้ในเบื้องหลังสำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ผู้ใช้เริ่มต้น
public boolean startUser (int userId, boolean waitFlag)
เริ่มต้นผู้ใช้หนึ่งๆ ในพื้นหลังหากหยุดทำงานอยู่ หากผู้ใช้ทำงานอยู่เบื้องหลังอยู่แล้ว วิธีนี้ก็เป็นแบบ NOOP สามารถใส่ Flag เพิ่มเติมเพื่อรอให้การดำเนินการมีผลได้
พารามิเตอร์ | |
---|---|
userId |
int : ของผู้ใช้ที่จะเริ่มต้นทำงานในเบื้องหลัง |
waitFlag |
boolean : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มและปลดล็อก |
คิกรีเทิร์น | |
---|---|
boolean |
true ถ้าเริ่มต้นผู้ใช้ในเบื้องหลังสำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ผู้ใช้พื้นหลังที่ปรากฏ
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
เริ่มใช้งานผู้ใช้ที่กำหนดในเบื้องหลัง ซึ่งมองเห็นได้ในจอแสดงผลที่กำหนด (ซึ่งอนุญาตให้ผู้ใช้เปิดกิจกรรมในจอแสดงผลนั้น)
หมายเหตุ: คำสั่งนี้ไม่ได้ตรวจสอบว่ามีผู้ใช้อยู่ไหม, จอแสดงผลพร้อมใช้งาน, device supports such feature
ฯลฯ
พารามิเตอร์ | |
---|---|
userId |
int : ของผู้ใช้ที่จะเริ่มต้นทำงานในเบื้องหลัง |
displayId |
int : แสดงเพื่อเริ่มแสดงผู้ใช้ใน |
waitFlag |
boolean : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มและปลดล็อก |
คิกรีเทิร์น | |
---|---|
boolean |
true หากเริ่มแสดงผู้ใช้ในเบื้องหลังเรียบร้อยแล้ว |
การขว้าง | |
---|---|
DeviceNotAvailableException |
StopEmulatorเอาต์พุต
public void stopEmulatorOutput ()
ปิดและลบเอาต์พุตของโปรแกรมจำลอง
StopLogcat
public void stopLogcat ()
หยุดบันทึกเอาต์พุต Logcat จากอุปกรณ์และทิ้งข้อมูล Logcat ที่บันทึกไว้ในปัจจุบัน
จะไม่มีผลหากไม่มีการบันทึกเอาต์พุต Logcat
ผู้ใช้
public boolean stopUser (int userId)
หยุดผู้ใช้ที่กำหนด หากผู้ใช้หยุดอยู่แล้ว วิธีนี้ก็จะไม่มีการดำเนินการ ไม่สามารถหยุดผู้ใช้ปัจจุบันและผู้ใช้ระบบ
พารามิเตอร์ | |
---|---|
userId |
int : ของผู้ใช้เพื่อหยุด |
คิกรีเทิร์น | |
---|---|
boolean |
true ถ้าหยุดผู้ใช้สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ผู้ใช้
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
หยุดผู้ใช้ที่กำหนด สามารถแจ้งว่าไม่เหมาะสมเพิ่มเติมเพื่อรอให้การดำเนินการมีผลและบังคับให้ผู้ใช้สิ้นสุด ไม่สามารถหยุดผู้ใช้ปัจจุบันและผู้ใช้ระบบ
พารามิเตอร์ | |
---|---|
userId |
int : ของผู้ใช้เพื่อหยุด |
waitFlag |
boolean : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะหยุด |
forceFlag |
boolean : จะบังคับให้ผู้ใช้หยุด |
คิกรีเทิร์น | |
---|---|
boolean |
true ถ้าหยุดผู้ใช้สำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
SwitchToAdbTcp
public String switchToAdbTcp ()
เปลี่ยนอุปกรณ์เป็นโหมด adb-over-tcp
คิกรีเทิร์น | |
---|---|
String |
หมายเลขซีเรียล tcp หรือ null หากเปลี่ยนอุปกรณ์ไม่ได้ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
สลับไปยัง AdbUsb
public boolean switchToAdbUsb ()
เปลี่ยนอุปกรณ์เป็น adb ผ่านโหมด USB
คิกรีเทิร์น | |
---|---|
boolean |
true หากเปลี่ยนสำเร็จ false หากเปลี่ยนสำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เปลี่ยนผู้ใช้
public boolean switchUser (int userId)
เปลี่ยนเป็น userId อื่นที่มีระยะหมดเวลาเริ่มต้น switchUser(int, long)
พารามิเตอร์ | |
---|---|
userId |
int |
คิกรีเทิร์น | |
---|---|
boolean |
เป็นจริงหากรหัสผู้ใช้ใหม่ตรงกับผู้ให้บริการรหัสผู้ใช้ เป็นเท็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
เปลี่ยนผู้ใช้
public boolean switchUser (int userId, long timeout)
เปลี่ยนไปใช้รหัสผู้ใช้อื่นโดยกำหนดระยะหมดเวลาที่กำหนดไว้เป็นกำหนดเวลา พยายามปิดใช้งานการล็อกปุ่มหลังจากที่เปลี่ยนผู้ใช้สำเร็จแล้ว
พารามิเตอร์ | |
---|---|
userId |
int |
timeout |
long : เพื่อรอก่อนที่ระบบจะแสดงค่า "เท็จ" สำหรับผู้ใช้สวิตช์ไม่สำเร็จ |
คิกรีเทิร์น | |
---|---|
boolean |
เป็นจริงหากรหัสผู้ใช้ใหม่ตรงกับผู้ให้บริการรหัสผู้ใช้ เป็นเท็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ซิงค์ไฟล์
public boolean syncFiles (File localFileDir, String deviceFilePath)
ซิงค์เนื้อหาของไดเรกทอรีไฟล์ในเครื่องบางส่วนกับอุปกรณ์
ตัดสินใจว่าจะพุชไฟล์ใดโดยการเปรียบเทียบการประทับเวลาของไฟล์ในเครื่องกับไฟล์ที่เทียบเคียงกันได้ เฉพาะไฟล์ที่ "ใหม่กว่า" หรือที่ไม่มีอยู่เท่านั้นที่จะมีการพุชไปยังอุปกรณ์ ดังนั้นค่าใช้จ่ายในการดำเนินการควรค่อนข้างน้อยหากไฟล์ที่ตั้งค่าไว้ในอุปกรณ์เป็นปัจจุบันแล้ว
ระบบจะไม่สนใจไฟล์ที่ซ่อน (ชื่อขึ้นต้นด้วย ".")
ตัวอย่างการใช้: SyncFiles("/tmp/files", "/sdcard") จะสร้างไดเรกทอรี /sdcard/files หากยังไม่มี และพุชเนื้อหา /tmp/files ไปยัง /sdcard/files ซ้ำๆ
พารามิเตอร์ | |
---|---|
localFileDir |
File : ไดเรกทอรีไฟล์ในเครื่องที่มีไฟล์ที่จะพุชซ้ำ |
deviceFilePath |
String : รูทไฟล์สัมบูรณ์ของปลายทางระยะไกล ไดเรกทอรีทั้งหมดในเส้นทาง
ของไฟล์นี้ต้องอ่านได้ เช่น การพุชไปยัง /data/local/tmp เมื่อ adb ไม่ใช่ราก
จะล้มเหลว |
คิกรีเทิร์น | |
---|---|
boolean |
true หากซิงค์ไฟล์สำเร็จ จ่าย false |
การขว้าง | |
---|---|
DeviceNotAvailableException |
TakeBugreport
public Bugreport takeBugreport ()
รับรายงานข้อบกพร่องและส่งคืนภายในออบเจ็กต์ Bugreport
เพื่อจัดการ แสดงผล Null ในกรณีที่เกิดปัญหา ไฟล์ที่อ้างอิงในออบเจ็กต์ Bugreport ต้องล้างผ่าน Bugreport.close()
คิกรีเทิร์น | |
---|---|
Bugreport |
ถอนการติดตั้งแพ็คเกจ
public String uninstallPackage (String packageName)
ถอนการติดตั้งแพ็กเกจ Android จากอุปกรณ์
พารามิเตอร์ | |
---|---|
packageName |
String : แพ็กเกจ Android ที่จะถอนการติดตั้ง |
คิกรีเทิร์น | |
---|---|
String |
String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ถอนการติดตั้งPackageForUser
public String uninstallPackageForUser (String packageName, int userId)
ถอนการติดตั้งแพ็กเกจ Android จากผู้ใช้รายหนึ่งๆ ออกจากอุปกรณ์
พารามิเตอร์ | |
---|---|
packageName |
String : แพ็กเกจ Android ที่จะถอนการติดตั้ง |
userId |
int : รหัสผู้ใช้จำนวนเต็มที่จะถอนการติดตั้ง |
คิกรีเทิร์น | |
---|---|
String |
String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ปลดล็อกอุปกรณ์
public boolean unlockDevice ()
ปลดล็อกอุปกรณ์หากอุปกรณ์อยู่ในสถานะเข้ารหัส
วิธีการนี้อาจรีสตาร์ทเฟรมเวิร์ก แต่จะไม่เรียกใช้postBootSetup()
ดังนั้น อุปกรณ์อาจยังไม่พร้อมที่จะทดสอบอย่างสมบูรณ์เมื่อกลับมาใช้วิธีนี้อีกครั้ง
คิกรีเทิร์น | |
---|---|
boolean |
true หากสำเร็จหรืออุปกรณ์ไม่ได้เข้ารหัส |
การขว้าง | |
---|---|
DeviceNotAvailableException |
unmountDebugfs
public void unmountDebugfs ()
ยกเลิกการต่อเชื่อม debugf
การขว้าง | |
---|---|
DeviceNotAvailableException |
รอสิ้นสุดการเปิดเครื่อง
public boolean waitForBootComplete (long timeOut)
บล็อกจนกว่าจะมีการตั้งค่าสถานะการเปิดเครื่องของอุปกรณ์เสร็จสมบูรณ์
พารามิเตอร์ | |
---|---|
timeOut |
long : เวลาในหน่วยมิลลิวินาทีในการรอการตั้งค่าแฟล็ก |
คิกรีเทิร์น | |
---|---|
boolean |
จริง หากมีการตั้งค่าสถานะการเริ่มต้นอย่างสมบูรณ์ของอุปกรณ์ไว้ภายในระยะหมดเวลา |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รออุปกรณ์ที่พร้อมใช้งาน
public boolean waitForDeviceAvailable ()
รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ ใช้ระยะหมดเวลาเริ่มต้น
คิกรีเทิร์น | |
---|---|
boolean |
"จริง" หากมีอุปกรณ์พร้อมให้บริการ "เท็จ" หากปิดใช้การกู้คืนและไม่พร้อมใช้งาน |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รออุปกรณ์ที่พร้อมใช้งาน
public boolean waitForDeviceAvailable (long waitTime)
รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ
พารามิเตอร์ | |
---|---|
waitTime |
long : เวลาเป็นมิลลิวินาทีในการรอ |
คิกรีเทิร์น | |
---|---|
boolean |
"จริง" หากมีอุปกรณ์พร้อมให้บริการ "เท็จ" หากปิดใช้การกู้คืนและไม่พร้อมใช้งาน |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รอสำหรับอุปกรณ์ที่ใช้งานได้ในการกู้คืนเส้นทาง
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
รอให้อุปกรณ์ตอบสนองและพร้อมใช้งานโดยไม่คำนึงถึงเส้นทางการกู้คืน
พารามิเตอร์ | |
---|---|
waitTime |
long |
คิกรีเทิร์น | |
---|---|
boolean |
"จริง" หากมีอุปกรณ์ เป็น "เท็จ" หากไม่พร้อมใช้งาน |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รอสำหรับตัวโหลดอุปกรณ์
public void waitForDeviceBootloader ()
บล็อกจนกว่าอุปกรณ์จะมองเห็นได้ผ่าน Fastboot ใช้การหมดเวลาเริ่มต้น
การขว้าง | |
---|---|
DeviceNotAvailableException |
รอการกู้คืนอุปกรณ์
public boolean waitForDeviceInRecovery (long waitTime)
การบล็อกสำหรับอุปกรณ์ให้อยู่ในสถานะ "การกู้คืน adb" (โปรดทราบว่าจะแตกต่างจาก IDeviceRecovery
)
พารามิเตอร์ | |
---|---|
waitTime |
long : เวลาเป็นมิลลิวินาทีในการรอ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากอุปกรณ์เปิดเครื่องเข้าสู่การกู้คืนก่อนหมดเวลา
จ่าย false |
รออุปกรณ์ในไซด์โหลด
public boolean waitForDeviceInSideload (long waitTime)
การบล็อกสำหรับอุปกรณ์ให้อยู่ในสถานะ "adb ไซด์โหลด"
พารามิเตอร์ | |
---|---|
waitTime |
long : เวลาเป็นมิลลิวินาทีในการรอ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากอุปกรณ์เปิดเครื่องเข้าสู่ไซด์โหลดก่อนหมดเวลา จ่าย false
|
รออุปกรณ์ไม่พร้อมให้บริการ
public boolean waitForDeviceNotAvailable (long waitTime)
การบล็อกอุปกรณ์ไม่พร้อมใช้งานเนื่องจากขาดหายไปจาก adb
พารามิเตอร์ | |
---|---|
waitTime |
long : เวลาเป็นมิลลิวินาทีในการรอ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากอุปกรณ์ไม่พร้อมใช้งานก่อนหมดเวลา
จ่าย false |
รออุปกรณ์ออนไลน์
public void waitForDeviceOnline ()
บล็อกจนกว่าอุปกรณ์จะแสดงผ่าน adb ใช้ระยะหมดเวลาเริ่มต้น
โปรดทราบว่าอุปกรณ์อาจไม่ตอบสนองต่อคำสั่งเมื่อดำเนินการเสร็จสิ้น โปรดใช้ waitForDeviceAvailable()
แทน
การขว้าง | |
---|---|
DeviceNotAvailableException |
รออุปกรณ์ออนไลน์
public void waitForDeviceOnline (long waitTime)
บล็อกจนกว่าอุปกรณ์จะแสดงผ่าน adb
โปรดทราบว่าอุปกรณ์อาจไม่ตอบสนองต่อคำสั่งเมื่อดำเนินการเสร็จสิ้น โปรดใช้ waitForDeviceAvailable()
แทน
พารามิเตอร์ | |
---|---|
waitTime |
long : เวลาเป็นมิลลิวินาทีในการรอ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
รอเชลล์อุปกรณ์
public boolean waitForDeviceShell (long waitTime)
รอให้อุปกรณ์ตอบสนองต่อคำสั่งเชลล์ adb พื้นฐาน
พารามิเตอร์ | |
---|---|
waitTime |
long : เวลาเป็นมิลลิวินาทีในการรอ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากอุปกรณ์ตอบสนองตามอุปกรณ์ก่อนที่จะผ่านไป waitTime |
วิธีการป้องกัน
เพิ่มการเชื่อมต่อเสริมการสร้างอาร์กิวเมนต์
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
พารามิเตอร์ | |
---|---|
builder |
DefaultConnection.ConnectionBuilder |
คำสั่ง BuildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
สร้างคำสั่งระบบปฏิบัติการสำหรับเซสชันคำสั่งเชลล์ adb และอาร์กิวเมนต์ที่ระบุ
พารามิเตอร์ | |
---|---|
command |
String |
forceExitStatusDetection |
boolean |
คิกรีเทิร์น | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
พารามิเตอร์ | |
---|---|
feature |
String |
strictMinLevel |
int |
สร้างการดำเนินการใหม่ของอุปกรณ์
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
สร้าง RebootDeviceAction
ไว้ใช้เมื่อดำเนินการรีบูต
พารามิเตอร์ | |
---|---|
rebootMode |
NativeDevice.RebootMode : โหมดของการรีบูตนี้ |
reason |
String : สำหรับการรีบูตนี้ |
คิกรีเทิร์น | |
---|---|
NativeDevice.RebootDeviceAction |
RebootDeviceAction ที่สร้างขึ้น |
รีบูต doAdb
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
ทำการรีบูต adb
พารามิเตอร์ | |
---|---|
rebootMode |
NativeDevice.RebootMode : โหมดของการรีบูตนี้ |
reason |
String : สำหรับการรีบูตนี้ |
การขว้าง | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
ตรวจสอบให้แน่ใจว่ารันไทม์รองรับ
protected void ensureRuntimePermissionSupported ()
เมธอด Helper ในการส่งข้อยกเว้นหากไม่รองรับสิทธิ์รันไทม์
การขว้าง | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
คิกรีเทิร์น | |
---|---|
int |
เริ่มต้นการเชื่อมต่อ
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
พารามิเตอร์ | |
---|---|
info |
IBuildInfo |
attributes |
MultiMap |
การขว้าง | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
InternalGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
ดึงข้อมูลพร็อพเพอร์ตี้ของอุปกรณ์จากแคช ddmlib โดยค่าเริ่มต้น แล้วกลับไปใช้ "adb shell getprop" หรือ "fastboot getvar" โดยขึ้นอยู่กับว่าอุปกรณ์อยู่ใน Fastboot หรือไม่
พารามิเตอร์ | |
---|---|
propName |
String : ชื่อพร็อพเพอร์ตี้ของอุปกรณ์ที่ส่งคืนโดย "adb shell getprop" |
fastbootVar |
String : ชื่อของตัวแปร Fastboot ที่เทียบเท่าในการค้นหา หาก null ระบบจะไม่พยายามค้นหา Fastboot |
description |
String : คำอธิบายตัวแปรง่ายๆ อักษรตัวแรกควรเป็นตัวพิมพ์ใหญ่ |
คิกรีเทิร์น | |
---|---|
String |
สตริงซึ่งอาจเป็น null หรือว่างเปล่า ซึ่งมีค่าของพร็อพเพอร์ตี้ที่ระบุ |
การขว้าง | |
---|---|
DeviceNotAvailableException |
isInรีบูตCallback
protected boolean isInRebootCallback ()
แสดงผลว่ากำลังมีการดำเนินการเรียกการรีบูตหรือไม่ ควรปิดใช้ API สาธารณะทั้งหมดสำหรับการรีบูตหากเป็นจริง
คิกรีเทิร์น | |
---|---|
boolean |
ใหม่กว่า
protected boolean isNewer (File localFile, IFileEntry entry)
แสดงผล true
หากไฟล์ในเครื่องเก่ากว่าไฟล์ระยะไกล IFileEntry
มีความแม่นยำในระดับนาทีเดียว ในกรณีที่เวลาเท่ากัน จะถือว่าไฟล์ใหม่กว่า
พารามิเตอร์ | |
---|---|
localFile |
File |
entry |
IFileEntry |
คิกรีเทิร์น | |
---|---|
boolean |
แจ้งเตือนรีบูตจบแล้ว
protected void notifyRebootEnded ()
แจ้ง IDeviceActionReceiver
ทั้งหมดเกี่ยวกับเหตุการณ์สิ้นสุดการรีบูต
การขว้าง | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
แจ้งเตือนการเริ่มต้นใหม่
protected void notifyRebootStarted ()
แจ้ง IDeviceActionReceiver
ทั้งหมดเกี่ยวกับเหตุการณ์เริ่มต้นการรีบูต
การขว้าง | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
ดำเนินการของอุปกรณ์
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
ทำงานในอุปกรณ์นี้ พยายามกู้คืนอุปกรณ์และเลือกใช้คำสั่งอีกครั้งหากดำเนินการไม่สำเร็จ
พารามิเตอร์ | |
---|---|
actionDescription |
String : คำอธิบายสั้นๆ เกี่ยวกับการดำเนินการที่ต้องทำ ใช้เพื่อการบันทึกเท่านั้น |
action |
NativeDevice.DeviceAction : การดำเนินการที่ต้องทำ |
retryAttempts |
int : ความพยายามที่จะดําเนินการอีกครั้งหากไม่สำเร็จแต่การกู้คืนสําเร็จ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากดำเนินการเรียบร้อยแล้ว |
การขว้าง | |
---|---|
DeviceNotAvailableException |
หากการพยายามกู้คืนไม่สำเร็จ หรือการดำเนินการสูงสุดที่ทำได้โดยไม่ สำเร็จ |
รีบูต postAdb
protected void postAdbReboot ()
การดำเนินการเพิ่มเติมที่อาจทำได้หลังจากการรีบูต
การขว้าง | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
ตั้งค่า PrePostBootSetup
protected void prePostBootSetup ()
อนุญาตให้อุปกรณ์แต่ละประเภท (AndroidNativeDevice, TestDevice) ลบล้างเมธอดนี้สำหรับ การตั้งค่าหลังการเปิดเครื่องที่เจาะจง
การขว้าง | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
PullFile Internal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
พารามิเตอร์ | |
---|---|
remoteFilePath |
String |
localFile |
File |
คิกรีเทิร์น | |
---|---|
boolean |
การขว้าง | |
---|---|
DeviceNotAvailableException |
ตั้งนาฬิกา
protected void setClock (Clock clock)
ตั้งค่าอินสแตนซ์ของนาฬิกาที่จะใช้
พารามิเตอร์ | |
---|---|
clock |
Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
ทำเครื่องหมาย TestDevice เป็น Microdroid และกำหนด CID
พารามิเตอร์ | |
---|---|
process |
Process : กระบวนการของ Microdroid VM |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
พารามิเตอร์ | |
---|---|
deviceOptions |
|
SimpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
เรียกใช้คำสั่ง Fastboot ง่ายๆ กับตัวแปรสภาพแวดล้อมและรายงานสถานะของคําสั่ง
พารามิเตอร์ | |
---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
คิกรีเทิร์น | |
---|---|
CommandResult |
SimpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
เรียกใช้คำสั่ง Fastboot ง่ายๆ และรายงานสถานะของคําสั่ง
พารามิเตอร์ | |
---|---|
timeout |
long |
fullCmd |
String |
คิกรีเทิร์น | |
---|---|
CommandResult |
รออุปกรณ์ไม่พร้อมให้บริการ
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
รอดูว่าอุปกรณ์ไม่พร้อมใช้งาน (หยุดการรายงานไปยัง adb)
พารามิเตอร์ | |
---|---|
operationDesc |
String : ชื่อของการดำเนินการที่รออยู่ |
time |
long : เวลาที่ต้องรอจนกว่าจะไม่พร้อมให้บริการ |
คิกรีเทิร์น | |
---|---|
boolean |
เป็นจริงหากอุปกรณ์ไม่พร้อมใช้งาน |