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

อุปกรณ์ทดสอบ

public class TestDevice
extends NativeDevice

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


การใช้งาน ITestDevice สำหรับอุปกรณ์ Android เต็มรูปแบบ

สรุป

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

class TestDevice.MicrodroidBuilder

เครื่องมือสร้างที่ใช้ในการสร้าง Microdroid TestDevice

เขตข้อมูล

public static final String DISMISS_KEYGUARD_CMD

คำสั่งที่สามารถใช้เพื่อยกเลิกคีย์การ์ด

ผู้สร้างสาธารณะ

TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

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

boolean clearErrorDialogs ()

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

int createUser (String name)

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

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

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

int createUserNoThrow (String name)

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

void disableKeyguard ()

พยายามปิดใช้งานคีย์การ์ด

boolean doesFileExist (String deviceFilePath)

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

boolean doesFileExist (String deviceFilePath, int userId)

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

File dumpHeap (String process, String devicePath)

พยายามดัมพ์ฮีปจาก system_server

getActiveApexes ()

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

getAllSettings (String namespace)

คืนค่าคีย์คู่ของเนมสเปซที่ร้องขอ

String getAndroidId (int userId)

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

getAndroidIds ()

สร้างแผนที่ของรหัส android พบรหัสผู้ใช้ที่ตรงกัน

PackageInfo getAppPackageInfo (String packageName)

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

getAppPackageInfos ()

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

DeviceFoldableState getCurrentFoldableState ()

คืนค่าสถานะพับได้ปัจจุบันของอุปกรณ์หรือค่า null หากเกิดปัญหาบางอย่างขึ้น

int getCurrentUser ()

ส่งคืน id ของผู้ใช้ที่กำลังทำงานอยู่

getFoldableStates ()

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

getInstalledPackageNames ()

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

KeyguardControllerState getKeyguardState ()

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

getMainlineModuleInfo ()

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

int getMaxNumberOfRunningUsersSupported ()

รับจำนวนสูงสุดที่รองรับผู้ใช้ที่รันพร้อมกัน

int getMaxNumberOfUsersSupported ()

รับจำนวนผู้ใช้ที่รองรับสูงสุด

Process getMicrodroidProcess ()
Integer getPrimaryUserId ()

ส่งคืนรหัสผู้ใช้หลัก

InputStreamSource getScreenshot ()

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

InputStreamSource getScreenshot (String format, boolean rescale)

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

InputStreamSource getScreenshot (String format)

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

InputStreamSource getScreenshot (long displayId)

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

String getSetting (String namespace, String key)

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

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

ส่งกลับค่าของการตั้งค่าที่ร้องขอ

getUninstallablePackageNames ()

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

int getUserFlags (int userId)

ค้นหาและส่งคืนแฟล็กของผู้ใช้ที่กำหนด

getUserInfos ()

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

int getUserSerialNumber (int userId)

ส่งคืนหมายเลขซีเรียลที่เกี่ยวข้องกับ userId หากพบ -10,000 ในกรณีอื่นๆ

boolean hasFeature (String feature)

ตรวจดูว่ามีคุณลักษณะใดในอุปกรณ์หรือไม่

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

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

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

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

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

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

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

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

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

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

String installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs)

String installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

String installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

String installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)

String installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

String installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)

boolean isAppEnumerationSupported ()

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

boolean isMultiUserSupported ()

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

boolean isPackageInstalled (String packageName)

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

boolean isPackageInstalled (String packageName, String userId)

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

boolean isUserRunning (int userId)

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

boolean isUserSecondary (int userId)

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

listDisplayIds ()

รวบรวมรายชื่อ display id ที่มีอยู่บนอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger"

listUsers ()

รับรายชื่อผู้ใช้บนอุปกรณ์

void postInvocationTearDown (Throwable exception)

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

boolean removeAdmin (String componentName, int userId)

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

void removeOwners ()

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

boolean removeUser (int userId)

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

boolean setDeviceOwner (String componentName, int userId)

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

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

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

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

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

void shutdownMicrodroid ( ITestDevice microdroidDevice)

ปิดอุปกรณ์ microdroid หากมีอยู่

boolean startUser (int userId)

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

boolean startUser (int userId, boolean waitFlag)

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

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

หยุดผู้ใช้ที่กำหนด

boolean stopUser (int userId)

หยุดผู้ใช้ที่กำหนด

boolean supportsMicrodroid ()

ตรวจสอบเงื่อนไขเบื้องต้นเพื่อเรียกใช้ microdroid

boolean supportsMicrodroid (boolean protectedVm)

ตรวจสอบเงื่อนไขเบื้องต้นเพื่อเรียกใช้ microdroid

boolean switchUser (int userId)

เปลี่ยนไปใช้รหัสผู้ใช้อื่นโดยหมดเวลาเริ่มต้น

boolean switchUser (int userId, long timeout)

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

String uninstallPackage (String packageName)

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

String uninstallPackageForUser (String packageName, int userId)

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

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

AaptParser createParser (File appFile)
void doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)

ทำการรีบูต adb

long getCheckNewUserSleep ()

เปิดเผยสำหรับการทดสอบ

long getHostCurrentTime ()

เปิดเผยสำหรับการทดสอบ

void prePostBootSetup ()

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

เขตข้อมูล

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

คำสั่งที่สามารถใช้เพื่อยกเลิกคีย์การ์ด

ผู้สร้างสาธารณะ

อุปกรณ์ทดสอบ

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

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

clearErrorDialogs

public boolean clearErrorDialogs ()

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

ส่งคืน
boolean true ถ้าไม่มีไดอะล็อกหรือไดอะล็อกถูกล้างสำเร็จ false อย่างอื่น

พ่น
DeviceNotAvailableException

สร้างผู้ใช้

public int createUser (String name)

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

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

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

พ่น
DeviceNotAvailableException

สร้างผู้ใช้

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

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

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

guest boolean : เปิดใช้งานแฟล็กผู้ใช้ --guest ระหว่างการสร้าง

ephemeral boolean : เปิดใช้งานแฟล็กผู้ใช้ -- ชั่วคราวระหว่างการสร้าง

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

พ่น
DeviceNotAvailableException

สร้าง UserNoThrow

public int createUserNoThrow (String name)

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

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

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

พ่น
DeviceNotAvailableException

ปิดการใช้งานKeyguard

public void disableKeyguard ()

พยายามปิดใช้งานคีย์การ์ด

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

พ่น
DeviceNotAvailableException

มีไฟล์อยู่

public boolean doesFileExist (String deviceFilePath)

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

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

ส่งคืน
boolean true ถ้ามีไฟล์อยู่ มิฉะนั้นจะ false

พ่น
DeviceNotAvailableException

มีไฟล์อยู่

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

userId int : รหัสผู้ใช้ที่ใช้ตรวจสอบการมีอยู่ของไฟล์

ส่งคืน
boolean true ถ้ามีไฟล์อยู่ มิฉะนั้นจะ false

พ่น
DeviceNotAvailableException

กองขยะ

public File dumpHeap (String process, 
                String devicePath)

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

พารามิเตอร์
process String : ชื่อของกระบวนการอุปกรณ์ที่จะถ่ายโอนข้อมูลบน

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

ส่งคืน
File ERROR(/File) ที่มีรายงาน เป็นโมฆะหากมีบางอย่างล้มเหลว

พ่น
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

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

พ่น
DeviceNotAvailableException

รับการตั้งค่าทั้งหมด

public  getAllSettings (String namespace)

คืนค่าคีย์คู่ของเนมสเปซที่ร้องขอ

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

ส่งคืน
แผนที่ของคู่ค่าคีย์ เป็นโมฆะหากไม่รองรับเนมสเปซ

พ่น
DeviceNotAvailableException

รับรหัส Android

public String getAndroidId (int userId)

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

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

ส่งคืน
String

พ่น
DeviceNotAvailableException

รับรหัส Android

public  getAndroidIds ()

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

ส่งคืน
แผนที่ของรหัส android พบรหัสผู้ใช้ที่ตรงกัน

พ่น
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

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

ส่งคืน
PackageInfo PackageInfo หรือ null หากไม่สามารถดึงข้อมูลได้

พ่น
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

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

ส่งคืน
เกิด ERROR(/List) ของ PackageInfo ที่ติดตั้งบนอุปกรณ์

พ่น
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

คืนค่าสถานะพับได้ปัจจุบันของอุปกรณ์หรือค่า null หากเกิดปัญหาบางอย่างขึ้น

ส่งคืน
DeviceFoldableState

พ่น
DeviceNotAvailableException

รับผู้ใช้ปัจจุบัน

public int getCurrentUser ()

ส่งคืน id ของผู้ใช้ที่กำลังทำงานอยู่ ในกรณีที่เกิดข้อผิดพลาด ให้ส่งคืน -10,000

ส่งคืน
int

พ่น
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

ส่งกลับรายการสถานะการพับบนอุปกรณ์ สามารถรับได้ด้วย "cmd device_state print-state"

ส่งคืน

พ่น
DeviceNotAvailableException

รับติดตั้งชื่อแพ็คเกจ

public  getInstalledPackageNames ()

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

ส่งคืน
ERROR(/Set) ของชื่อแพ็คเกจ String ที่ติดตั้งบนอุปกรณ์ในปัจจุบัน

พ่น
DeviceNotAvailableException

รับ KeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

พ่น
DeviceNotAvailableException

รับMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

พ่น
DeviceNotAvailableException

getMaxNumberOfRunningUsers รองรับ

public int getMaxNumberOfRunningUsersSupported ()

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

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

พ่น
DeviceNotAvailableException

รับจำนวนผู้ใช้สูงสุดที่สนับสนุน

public int getMaxNumberOfUsersSupported ()

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

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

พ่น
DeviceNotAvailableException

รับ MicrodroidProcess

public Process getMicrodroidProcess ()

ส่งคืน
Process ส่งกลับกระบวนการของ Microdroid VM หาก TestDevice ไม่ใช่ Microdroid ให้คืนค่า null

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

public Integer getPrimaryUserId ()

ส่งคืนรหัสผู้ใช้หลัก

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

พ่น
DeviceNotAvailableException

รับสกรีนช็อต

public InputStreamSource getScreenshot ()

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

ส่งคืน
InputStreamSource InputStreamSource ของภาพหน้าจอในรูปแบบ png หรือ 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 (String format)

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

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

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

พ่น
DeviceNotAvailableException

รับสกรีนช็อต

public InputStreamSource getScreenshot (long displayId)

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

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

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

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

พ่น
DeviceNotAvailableException

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

public String getSetting (String namespace, 
                String key)

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

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

key String

ส่งคืน
String

พ่น
DeviceNotAvailableException

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

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

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

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

namespace String

key String

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

พ่น
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

พ่น
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

ค้นหาและส่งคืนแฟล็กของผู้ใช้ที่กำหนด ค่าสถานะถูกกำหนดในคลาส "android.content.pm.UserInfo" ใน Android Open Source Project

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

ส่งคืน
int แฟล็กที่เกี่ยวข้องกับ userId ที่ระบุหากพบ -10,000 ในกรณีอื่นๆ

พ่น
DeviceNotAvailableException

รับข้อมูลผู้ใช้

public  getUserInfos ()

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

ส่งคืน
รายการวัตถุ UserInfo

พ่น
DeviceNotAvailableException

รับ UserSerialNumber

public int getUserSerialNumber (int userId)

ส่งคืนหมายเลขซีเรียลที่เกี่ยวข้องกับ userId หากพบ -10,000 ในกรณีอื่นๆ

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

ส่งคืน
int

พ่น
DeviceNotAvailableException

มีคุณสมบัติ

public boolean hasFeature (String feature)

ตรวจดูว่ามีคุณลักษณะใดในอุปกรณ์หรือไม่

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

ส่งคืน
boolean เป็นจริงหากพบคุณสมบัติ มิฉะนั้นจะเป็นเท็จ

พ่น
DeviceNotAvailableException

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

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

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

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

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

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

พารามิเตอร์
packageFile File : ไฟล์ apk ที่จะติดตั้ง

certFile File : true หากควรทำการติดตั้งใหม่

reinstall boolean : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง

extraArgs String : อาร์กิวเมนต์เพิ่มเติมที่จะส่งผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

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

พ่น
DeviceNotAvailableException

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

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

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

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

พารามิเตอร์
packageFile File : ไฟล์ apk ที่จะติดตั้ง

reinstall boolean : true หากควรทำการติดตั้งใหม่

grantPermissions boolean : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง

extraArgs String : อาร์กิวเมนต์เพิ่มเติมที่จะส่งผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

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

พ่น
DeviceNotAvailableException

ติดตั้ง PackageForUser

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

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

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

พารามิเตอร์
packageFile File : ไฟล์ apk ที่จะติดตั้ง

reinstall boolean : true หากควรทำการติดตั้งใหม่

grantPermissions boolean : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง

userId int : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง

extraArgs String : อาร์กิวเมนต์เพิ่มเติมที่จะส่งผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

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

พ่น
DeviceNotAvailableException

ติดตั้ง PackageForUser

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 installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

พารามิเตอร์
packageFiles

reinstall boolean

extraArgs String

ส่งคืน
String

พ่น
DeviceNotAvailableException

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

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

พารามิเตอร์
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

ส่งคืน
String

พ่น
DeviceNotAvailableException

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

พารามิเตอร์
packageFiles

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

ส่งคืน
String

พ่น
DeviceNotAvailableException

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

พารามิเตอร์
packageFiles

reinstall boolean

userId int

extraArgs String

ส่งคืน
String

พ่น
DeviceNotAvailableException

ติดตั้งแพ็คเกจระยะไกล

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

พารามิเตอร์
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

ส่งคืน
String

พ่น
DeviceNotAvailableException

ติดตั้งแพ็คเกจระยะไกล

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

พารามิเตอร์
remoteApkPaths

reinstall boolean

extraArgs String

ส่งคืน
String

พ่น
DeviceNotAvailableException

isAppEnumeration รองรับ

public boolean isAppEnumerationSupported ()

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

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

พ่น
DeviceNotAvailableException

รองรับ MultiUser

public boolean isMultiUserSupported ()

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

ส่งคืน
boolean จริงหากรองรับผู้ใช้หลายคน มิฉะนั้นจะเป็นเท็จ

พ่น
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

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

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

พ่น
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

พารามิเตอร์
packageName String : แพ็คเกจที่เรากำลังตรวจสอบว่ามีการติดตั้งหรือไม่

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

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

พ่น
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

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

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

ส่งคืน
boolean จริงถ้าผู้ใช้กำลังเรียกใช้ เท็จในทุกกรณี

พ่น
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

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

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

ส่งคืน
boolean จริงถ้าผู้ใช้เป็นผู้ใช้รอง มิฉะนั้นจะเป็นเท็จ

พ่น
DeviceNotAvailableException

รายการรหัสที่แสดง

public  listDisplayIds ()

รวบรวมรายชื่อ display id ที่มีอยู่บนอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger"

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

พ่น
DeviceNotAvailableException

รายการผู้ใช้

public  listUsers ()

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

ส่งคืน
รายการรหัสผู้ใช้

พ่น
DeviceNotAvailableException

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

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

ลบผู้ดูแลระบบ

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 จริงหากเราลบผู้ใช้ได้สำเร็จ มิฉะนั้นจะเป็นเท็จ

พ่น
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

userId int : ของผู้ใช้ที่เจ้าของอุปกรณ์อาศัยอยู่

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

พ่น
DeviceNotAvailableException

การตั้งค่า

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)

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

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

namespace String

key String

value String

พ่น
DeviceNotAvailableException

ปิดไมโครดรอยด์

public void shutdownMicrodroid (ITestDevice microdroidDevice)

ปิดอุปกรณ์ microdroid หากมีอยู่

พารามิเตอร์
microdroidDevice ITestDevice

พ่น
DeviceNotAvailableException

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

public boolean startUser (int userId)

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

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

ส่งคืน
boolean จริงถ้าผู้ใช้เริ่มต้นได้สำเร็จในพื้นหลัง

พ่น
DeviceNotAvailableException

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

public boolean startUser (int userId, 
                boolean waitFlag)

เริ่มต้นผู้ใช้ที่กำหนดในพื้นหลังหากหยุดอยู่ในขณะนี้ หากผู้ใช้ทำงานในพื้นหลังแล้ว วิธีนี้เป็น NOOP สามารถตั้งค่าสถานะพิเศษเพื่อรอให้การดำเนินการมีผล

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

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

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

พ่น
DeviceNotAvailableException

หยุดผู้ใช้

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

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

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

waitFlag boolean : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะหยุดทำงาน

forceFlag boolean : จะบังคับให้หยุดผู้ใช้

ส่งคืน
boolean จริงถ้าหยุดผู้ใช้ได้สำเร็จ

พ่น
DeviceNotAvailableException

หยุดผู้ใช้

public boolean stopUser (int userId)

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

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

ส่งคืน
boolean จริงถ้าหยุดผู้ใช้ได้สำเร็จ

พ่น
DeviceNotAvailableException

รองรับMicrodroid

public boolean supportsMicrodroid ()

ตรวจสอบเงื่อนไขเบื้องต้นเพื่อเรียกใช้ microdroid

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

รองรับMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

ตรวจสอบเงื่อนไขเบื้องต้นเพื่อเรียกใช้ microdroid

พารามิเตอร์
protectedVm boolean : จริงถ้า microdroid ตั้งใจให้ทำงานบน VM ที่ได้รับการป้องกัน

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

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

public boolean switchUser (int userId)

เปลี่ยนไปใช้รหัสผู้ใช้อื่นโดยหมดเวลาเริ่มต้น switchUser(int, long)

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

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

พ่น
DeviceNotAvailableException

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

public boolean switchUser (int userId, 
                long timeout)

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

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

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

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

พ่น
DeviceNotAvailableException

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

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

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

สร้าง Parser

protected AaptParser createParser (File appFile)

พารามิเตอร์
appFile File

ส่งคืน
AaptParser

doAdbReboot

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

ทำการรีบูต adb

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

reason String : สำหรับการรีบูตครั้งนี้

พ่น
DeviceNotAvailableException

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

เปิดเผยสำหรับการทดสอบ

ส่งคืน
long

getHostCurrentTime

protected long getHostCurrentTime ()

เปิดเผยสำหรับการทดสอบ

ส่งคืน
long

prePostBootSetup

protected void prePostBootSetup ()

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

พ่น
DeviceNotAvailableException