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

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

getAndroidIds ()

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

PackageInfo getAppPackageInfo (String packageName)

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

getAppPackageInfos ()

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

InputStreamSource getBugreport ()

ดึงรายงานข้อผิดพลาดจากอุปกรณ์

InputStreamSource getBugreportz ()

ดึงรายงานข้อผิดพลาดจากอุปกรณ์

DeviceFoldableState getCurrentFoldableState ()

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

int getCurrentUser ()

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

getFoldableStates ()

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

getInstalledPackageNames ()

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

KeyguardControllerState getKeyguardState ()

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

Integer getMainUserId ()

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

getMainlineModuleInfo ()

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

int getMaxNumberOfRunningUsersSupported ()

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

int getMaxNumberOfUsersSupported ()

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

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

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

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

รวบรวมรายชื่อ display id ที่มีอยู่บนอุปกรณ์ตามที่รายงานโดย "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 ()

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

boolean supportsMicrodroid (boolean protectedVm)

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

boolean switchUser (int userId)

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

boolean switchUser (int userId, long timeout)

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

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

เมธอด Internal 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)

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

สามารถสลับเป็น HeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

ส่งคืน
boolean

พ่น
DeviceNotAvailableException

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, 
                boolean forTesting)

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

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

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

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

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

ส่งคืน
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

getBugreport

public InputStreamSource getBugreport ()

ดึงรายงานข้อผิดพลาดจากอุปกรณ์

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

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

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

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) ของชื่อแพ็คเกจ ERROR(/String) ที่ติดตั้งบนอุปกรณ์ในปัจจุบัน

พ่น
DeviceNotAvailableException

รับ KeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

พ่น
DeviceNotAvailableException

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

public Integer getMainUserId ()

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

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

พ่น
DeviceNotAvailableException

รับMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

พ่น
DeviceNotAvailableException

getMaxNumberOfRunningUsers รองรับ

public int getMaxNumberOfRunningUsersSupported ()

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

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

พ่น
DeviceNotAvailableException

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

public int getMaxNumberOfUsersSupported ()

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

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

พ่น
DeviceNotAvailableException

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

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) ของชื่อแพ็คเกจ ERROR(/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 ERROR(/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 ERROR(/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 ERROR(/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 ERROR(/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 ERROR(/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, 
                String... extraArgs)

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

reinstall boolean

extraArgs String

ส่งคืน
String

พ่น
DeviceNotAvailableException

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

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

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

ส่งคืน
boolean

พ่น
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

ส่งคืน
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

isUserVisible

public boolean isUserVisible (int userId)

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

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

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

ส่งคืน
boolean

พ่น
DeviceNotAvailableException

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

displayId int

ส่งคืน
boolean

พ่น
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

ส่งคืน
boolean

พ่น
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

ส่งคืน
boolean

พ่น
DeviceNotAvailableException

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

public  listDisplayIds ()

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

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

พ่น
DeviceNotAvailableException

listDisplayIdsFor StartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

ส่งคืน

พ่น
DeviceNotAvailableException

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

public  listUsers ()

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

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

พ่น
DeviceNotAvailableException

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

listener ITestLogger : ITestLogger เพื่อบันทึกรายงานข้อบกพร่อง

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

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
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

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

รองรับ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

TakeBugreport

public Bugreport takeBugreport ()

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

ส่งคืน
Bugreport

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

public String uninstallPackage (String packageName)

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

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

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

พ่น
DeviceNotAvailableException

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

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

ส่งคืน
String ERROR(/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 : สำหรับการรีบูตครั้งนี้

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

ส่งคืน
InputStreamSource

getBugreportzInternal

protected File getBugreportzInternal ()

เมธอด Internal Helper เพื่อรับไฟล์ zip bugreportz เป็น ERROR(/File)

ส่งคืน
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

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

ส่งคืน
long

getHostCurrentTime

protected long getHostCurrentTime ()

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

ส่งคืน
long

prePostBootSetup

protected void prePostBootSetup ()

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

พ่น
DeviceNotAvailableException