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

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

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

boolean clearErrorDialogs ()

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

int createUser (String name)

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

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

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

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 หากไม่พบจะเป็นโมฆะ

getAndroidIds ()

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

PackageInfo getAppPackageInfo (String packageName)

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

getAppPackageInfos ()

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

InputStreamSource getBugreport ()

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

InputStreamSource getBugreportz ()

ดึง bugreportz จากอุปกรณ์

DeviceFoldableState getCurrentFoldableState ()

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

int getCurrentUser ()

คืนรหัสของผู้ใช้ที่ทำงานอยู่ในปัจจุบัน

getFoldableStates ()

ส่งคืนรายการสถานะแบบพับได้บนอุปกรณ์

getInstalledPackageNames ()

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

KeyguardControllerState getKeyguardState ()

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

Integer getMainUserId ()

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

getMainlineModuleInfo ()

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

int getMaxNumberOfRunningUsersSupported ()

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

int getMaxNumberOfUsersSupported ()

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

Integer getPrimaryUserId ()

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

InputStreamSource getScreenshot ()

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

InputStreamSource getScreenshot (String format, boolean rescale)

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

InputStreamSource getScreenshot (String format)

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

InputStreamSource getScreenshot (long displayId)

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

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)

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

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 installPackage (File packageFile, File certFile, boolean reinstall, 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, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)

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

boolean isAppEnumerationSupported ()

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

boolean isHeadlessSystemUserMode ()

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

boolean isMainUserPermanentAdmin ()

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

boolean isMultiUserSupported ()

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

boolean isPackageInstalled (String packageName)

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

boolean isPackageInstalled (String packageName, String userId)

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

boolean isUserRunning (int userId)

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

boolean isUserSecondary (int userId)

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

boolean isUserVisible (int userId)

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

boolean isUserVisibleOnDisplay (int userId, int displayId)

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

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

boolean isVisibleBackgroundUsersSupported ()

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

listDisplayIds ()

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

listDisplayIdsForStartingVisibleBackgroundUsers ()

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

listUsers ()

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

boolean logBugreport (String dataName, ITestLogger listener)

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

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 startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)

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

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

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

boolean stopUser (int userId)

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

boolean supportsMicrodroid ()

ตรวจสอบเงื่อนไขเบื้องต้นเพื่อเรียกใช้ไมโครดรอยด์

boolean supportsMicrodroid (boolean protectedVm)

ตรวจสอบเงื่อนไขเบื้องต้นเพื่อเรียกใช้ไมโครดรอยด์

boolean switchUser (int userId)

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

boolean switchUser (int userId, long timeout)

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

Bugreport takeBugreport ()

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

String uninstallPackage (String packageName)

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

String uninstallPackageForUser (String packageName, int userId)

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

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

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

ทำการรีบูต adb

InputStreamSource getBugreportInternal ()
File getBugreportzInternal ()

วิธีการ Helper ภายในเพื่อรับไฟล์ zip bugreportz เป็น ERROR(/File)

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)

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

สามารถ SwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

ล้างข้อผิดพลาด Dialogs

public boolean clearErrorDialogs ()

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

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

ขว้าง
DeviceNotAvailableException

createUser

public int createUser (String name)

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

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

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

ขว้าง
DeviceNotAvailableException

createUser

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

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

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

guest boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --guest ระหว่างการสร้าง

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

forTesting boolean : เปิดใช้งานแฟล็กทดสอบ --สำหรับการทดสอบระหว่างการสร้าง

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

ขว้าง
DeviceNotAvailableException

createUser

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

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

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

guest boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --guest ระหว่างการสร้าง

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

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

ขว้าง
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

ขว้าง
DeviceNotAvailableException

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

public void disableKeyguard ()

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

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

ขว้าง
DeviceNotAvailableException

ไม่FileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

ขว้าง
DeviceNotAvailableException

ไม่FileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

ขว้าง
DeviceNotAvailableException

dumpHeap

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

รับ AndroidId

public String getAndroidId (int userId)

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

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

รับ Bugreport

public InputStreamSource getBugreport ()

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

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

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

รับ Bugreportz

public InputStreamSource getBugreportz ()

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

รองรับเฉพาะ 'เวอร์ชัน adb' > 1.0.36 เท่านั้น

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

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

การส่งคืน
DeviceFoldableState

ขว้าง
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

การส่งคืน
int

ขว้าง
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

การส่งคืน

ขว้าง
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

ขว้าง
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

ขว้าง
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

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

การส่งคืน
Integer userId ของผู้ใช้หลัก หากมี และเป็นโมฆะหากไม่มีผู้ใช้หลัก

ขว้าง
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

ขว้าง
DeviceNotAvailableException

getMaxNumberOfRunningUsersได้รับการสนับสนุน

public int getMaxNumberOfRunningUsersSupported ()

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

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

ขว้าง
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

ขว้าง
DeviceNotAvailableException

รับ PrimaryUserId

public Integer getPrimaryUserId ()

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

การส่งคืน
Integer userId ของผู้ใช้หลัก หากมี และเป็นค่าว่างหากไม่มีผู้ใช้หลัก

ขว้าง
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(format) แทนการเข้ารหัส JPEG สำหรับขนาดที่เล็กกว่า

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

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

ขว้าง
DeviceNotAvailableException

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

public InputStreamSource getScreenshot (long displayId)

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

ขว้าง
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

ขว้าง
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

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

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

การส่งคืน
int ค่าสถานะที่เกี่ยวข้องกับ userId ที่ระบุหากพบ -10000 ในกรณีอื่น ๆ

ขว้าง
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

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

การส่งคืน
รายการออบเจ็กต์ UserInfo

ขว้าง
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

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

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

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

ติดตั้ง 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 : ID ผู้ใช้จำนวนเต็มที่จะติดตั้ง

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 : ID ผู้ใช้จำนวนเต็มที่จะติดตั้ง

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

ติดตั้งPackagesForUser

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

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

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

การส่งคืน
String

ขว้าง
DeviceNotAvailableException

ติดตั้งPackagesForUser

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

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

reinstall boolean

userId int

extraArgs String

การส่งคืน
String

ขว้าง
DeviceNotAvailableException

ติดตั้ง RemotePackages

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

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

reinstall boolean

extraArgs String

การส่งคืน
String

ขว้าง
DeviceNotAvailableException

ติดตั้ง RemotePackages

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

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

reinstall boolean

grantPermissions boolean

extraArgs String

การส่งคืน
String

ขว้าง
DeviceNotAvailableException

รองรับ isAppEnumeration แล้ว

public boolean isAppEnumerationSupported ()

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

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

ขว้าง
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

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

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

isUserVisible

public boolean isUserVisible (int userId)

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

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

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

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

displayId int

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

รองรับ isVisibleBackgroundUsers

public boolean isVisibleBackgroundUsersSupported ()

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

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

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

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

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

ขว้าง
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

การส่งคืน

ขว้าง
DeviceNotAvailableException

รายชื่อผู้ใช้

public  listUsers ()

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

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

ขว้าง
DeviceNotAvailableException

บันทึกรายงานข้อบกพร่อง

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

พารามิเตอร์
dataName String : ชื่อที่จะใช้รายงานรายงานข้อบกพร่อง

listener ITestLogger : ITestLogger เพื่อบันทึกรายงานจุดบกพร่อง

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

โพสต์คำร้องขอTearDown

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

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

startUser

public boolean startUser (int userId)

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

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

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

ขว้าง
DeviceNotAvailableException

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

ขว้าง
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

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

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

displayId int : แสดงเพื่อเริ่มมองเห็นผู้ใช้

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

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

ขว้าง
DeviceNotAvailableException

ผู้ใช้หยุด

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

รองรับไมโครดรอยด์

public boolean supportsMicrodroid ()

ตรวจสอบเงื่อนไขเบื้องต้นเพื่อเรียกใช้ไมโครดรอยด์

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

รองรับไมโครดรอยด์

public boolean supportsMicrodroid (boolean protectedVm)

ตรวจสอบเงื่อนไขเบื้องต้นเพื่อเรียกใช้ไมโครดรอยด์

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

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

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

ขว้าง
DeviceNotAvailableException

ใช้ Bugreport

public Bugreport takeBugreport ()

รับรายงานข้อบกพร่องและส่งคืนภายในวัตถุ Bugreport เพื่อจัดการ ส่งคืนค่าว่างในกรณีที่เกิดปัญหา ไฟล์ที่อ้างอิงในวัตถุ Bugreport จะต้องได้รับการทำความสะอาดผ่าน Bugreport.close()

การส่งคืน
Bugreport

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

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 : ID ผู้ใช้จำนวนเต็มที่จะถอนการติดตั้ง

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

ขว้าง
DeviceNotAvailableException

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

สร้างพาร์เซอร์

protected AaptParser createParser (File appFile)

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

การส่งคืน
AaptParser

doAdbReboot

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

ทำการรีบูต adb

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

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

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

getBugreportInternal.get

protected InputStreamSource getBugreportInternal ()

การส่งคืน
InputStreamSource

getBugreportzInternal.getBugreportzInternal

protected File getBugreportzInternal ()

วิธีการ Helper ภายในเพื่อรับไฟล์ zip bugreportz เป็น ERROR(/File)

การส่งคืน
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

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

การส่งคืน
long

getHostCurrentTime

protected long getHostCurrentTime ()

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

การส่งคืน
long

prePostBootSetup

protected void prePostBootSetup ()

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

ขว้าง
DeviceNotAvailableException