หน้านี้ได้รับการแปลโดย Cloud Translation API

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

public class TestDevice
extends NativeDevice

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

คลาสย่อยโดยตรงที่รู้จัก

ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice

อุปกรณ์ระยะไกลที่มีการจัดการ	อุปกรณ์ที่ทำงานภายในเครื่องเสมือนที่เราจัดการจากระยะไกลผ่านอินสแตนซ์ที่เทรดเฟดอยู่ภายใน VM
อุปกรณ์ระยะไกลที่ซ้อนกัน	ภาพอุปกรณ์ที่ทำงานอยู่ภายใน VM ของ Cuttlefish ระยะไกล
อุปกรณ์ Android ระยะไกล	การใช้ `ITestDevice` สำหรับอุปกรณ์ Android ทั้งสแต็กที่เชื่อมต่อผ่าน adb Connect

คลาสย่อยโดยอ้อมที่รู้จัก

LocalAndroidVirtualDevice, RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	คลาสสำหรับอุปกรณ์เสมือนท้องถิ่นที่ทำงานบนโฮสต์ TradeFed
RemoteAndroidVirtualDevice	ขยายลักษณะการทำงาน `RemoteAndroidDevice` สำหรับอุปกรณ์ Android ทั้งสแต็กซึ่งทำงานอยู่ใน Google Compute Engine (Gce)

การใช้ 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()` แสดงผลสถานะปัจจุบันของอุปกรณ์หรือค่า Null หากเกิดปัญหาขึ้น
`int`	`getCurrentUser()` แสดงผล ID ของผู้ใช้ปัจจุบันที่กำลังทำงานอยู่
	`getFoldableStates()` แสดงรายการสถานะพับได้ในอุปกรณ์
	`getInstalledPackageNames()` ดึงข้อมูลชื่อแพ็กเกจของแอปพลิเคชันที่มีอยู่ในอุปกรณ์
`KeyguardControllerState`	`getKeyguardState()` แสดงผลออบเจ็กต์เพื่อรับสถานะปัจจุบันของคีย์การ์ดหรือ Null หากไม่รองรับ
`Integer`	`getMainUserId()` แสดงผล User-ID หลัก
	`getMainlineModuleInfo()` ดูข้อมูลเกี่ยวกับโมดูลเมนไลน์ที่ติดตั้งในอุปกรณ์
`int`	`getMaxNumberOfRunningUsersSupported()` รับจำนวนผู้ใช้งานพร้อมกันที่รองรับสูงสุด
`int`	`getMaxNumberOfUsersSupported()` รับจํานวนผู้ใช้ที่รองรับสูงสุด
`Integer`	`getPrimaryUserId()` แสดงผล User-ID หลัก
`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)` แสดงผลหมายเลขซีเรียลที่เชื่อมโยงกับ 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)`
`String`	`installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`String`	`installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)`
`String`	`installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)`
`String`	`installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)`
`String`	`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()` รวบรวมรายการรหัสแสดงที่มีอยู่ในอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger"
	`listDisplayIdsForStartingVisibleBackgroundUsers()` รับรายการจอแสดงผลที่ใช้เพื่อ`start a user visible in the background`ได้
	`listUsers()` รับรายชื่อผู้ใช้ในอุปกรณ์
`boolean`	`logBugreport(String dataName, ITestLogger listener)` วิธีการของตัวช่วยในการรับรายงานข้อบกพร่องและบันทึกรายงานให้กับผู้รายงาน
`void`	`notifySnapuserd(SnapuserdWaitPhase waitPhase)`
`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)` เปลี่ยนเป็น userId อื่นที่มีระยะหมดเวลาเริ่มต้น
`boolean`	`switchUser(int userId, long timeout)` เปลี่ยนไปใช้รหัสผู้ใช้อื่นโดยกำหนดระยะหมดเวลาที่กำหนดไว้เป็นกำหนดเวลา
`Bugreport`	`takeBugreport()` รับรายงานข้อบกพร่องและส่งคืนภายในออบเจ็กต์ `Bugreport` เพื่อจัดการ
`String`	`uninstallPackage(String packageName)` ถอนการติดตั้งแพ็กเกจ Android จากอุปกรณ์
`String`	`uninstallPackageForUser(String packageName, int userId)` ถอนการติดตั้งแพ็กเกจ Android จากผู้ใช้รายหนึ่งๆ ออกจากอุปกรณ์
`void`	`waitForSnapuserd(SnapuserdWaitPhase currentPhase)`

วิธีการป้องกัน
`AaptParser`	`createParser(File appFile)`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` ทำการรีบูต adb
`InputStreamSource`	`getBugreportInternal()`
`File`	`getBugreportzInternal()` เมธอดของตัวช่วยภายในเพื่อรับไฟล์ 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)

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

ผู้ใช้ระบบเปลี่ยนส่วนหัวได้

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`: เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --ผู้ใช้ชั่วคราวระหว่างการสร้าง
`ephemeral`	`boolean`: เปิดใช้การตั้งค่าสถานะผู้ใช้ -- ชั่วคราวระหว่างการสร้าง
`forTesting`	`boolean`: เปิดใช้ Test Flag --สำหรับการทดสอบระหว่างการสร้าง

คิกรีเทิร์น
`int`	รหัสของผู้ใช้ที่สร้าง

การขว้าง
`DeviceNotAvailableException`

สร้างผู้ใช้

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

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

พารามิเตอร์
`name`	`String`: ของผู้ใช้ที่จะสร้างในอุปกรณ์
`guest`	`boolean`: เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --ผู้ใช้ชั่วคราวระหว่างการสร้าง
`ephemeral`	`boolean`: เปิดใช้การตั้งค่าสถานะผู้ใช้ -- ชั่วคราวระหว่างการสร้าง

คิกรีเทิร์น
`int`	รหัสของผู้ใช้ที่สร้าง

การขว้าง
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

การขว้าง
`DeviceNotAvailableException`

disabledKeyguard

public void disableKeyguard ()

ความพยายามปิดใช้งานการล็อกปุ่ม

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

การขว้าง
`DeviceNotAvailableException`

doFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

คิกรีเทิร์น
`boolean`	`true` หากมีไฟล์อยู่ `false` มิเช่นนั้น

การขว้าง
`DeviceNotAvailableException`

doFileExist

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`

getAllSettings

public  getAllSettings (String namespace)

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

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

คิกรีเทิร์น
	แผนที่ของคู่คีย์-ค่า มีค่าว่างหากไม่รองรับเนมสเปซ

การขว้าง
`DeviceNotAvailableException`

รับรหัส Android

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`

getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

รองรับเฉพาะ "เวอร์ชัน adb" 1.0.36

คิกรีเทิร์น
`InputStreamSource`	`InputStreamSource` ของไฟล์ ZIP ที่มี Bugreportz แสดงผล Null ล้มเหลวได้

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

แสดงผลสถานะปัจจุบันของอุปกรณ์หรือค่า Null หากเกิดปัญหาขึ้น

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

การขว้าง
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

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

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

การขว้าง
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

แสดงรายการสถานะพับได้ในอุปกรณ์ รับได้ด้วย "cmd device_state "สถานะการพิมพ์"

คิกรีเทิร์น

การขว้าง
`DeviceNotAvailableException`

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

การขว้าง
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

คิกรีเทิร์น
`KeyguardControllerState`	`KeyguardControllerState` ที่มีภาพรวมของสถานะของการล็อกปุ่มกด และแสดงค่า Null หากไม่สนับสนุนข้อความค้นหา Keyguard

การขว้าง
`DeviceNotAvailableException`

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

public Integer getMainUserId ()

แสดงผล User-ID หลัก

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

การขว้าง
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

การขว้าง
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

การขว้าง
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

การขว้าง
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

แสดงผล User-ID หลัก

คิกรีเทิร์น
`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`

GetSetting

public String getSetting (String namespace, 
                String key)

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

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

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

การขว้าง
`DeviceNotAvailableException`

GetSetting

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

แสดงผลค่าของการตั้งค่าที่ขอ Namespace ต้องเป็น {"system", "secure", "global"}

พารามิเตอร์
`userId`	`int`
`namespace`	`String`
`key`	`String`

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

การขว้าง
`DeviceNotAvailableException`

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

public  getUninstallablePackageNames ()

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

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

การขว้าง
`DeviceNotAvailableException`

getUserFlags

public int getUserFlags (int userId)

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

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

คิกรีเทิร์น
`int`	ค่าสถานะที่เชื่อมโยงกับ UserId ที่ระบุ หากพบ คือ -10000 ในกรณีอื่นๆ

การขว้าง
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

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

คิกรีเทิร์น
	รายการออบเจ็กต์ UserInfo

การขว้าง
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

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

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

การขว้าง
`DeviceNotAvailableException`

มีฟีเจอร์

public boolean hasFeature (String feature)

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

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

คิกรีเทิร์น
`boolean`	จริงหากพบฟีเจอร์ เป็นเท็จ

การขว้าง
`DeviceNotAvailableException`

installPackage

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

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

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

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

การขว้าง
`DeviceNotAvailableException`

installPackage

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

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

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

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

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

การขว้าง
`DeviceNotAvailableException`

installPackage

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 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`

ติดตั้งแพ็กเกจสำหรับผู้ใช้

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`

installPackages

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

พารามิเตอร์
`packageFiles`
`reinstall`	`boolean`
`extraArgs`	`String`

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

การขว้าง
`DeviceNotAvailableException`

installPackages

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

พารามิเตอร์
`packageFiles`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

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

การขว้าง
`DeviceNotAvailableException`

ติดตั้งแพ็กเกจสำหรับผู้ใช้

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

พารามิเตอร์
`packageFiles`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`userId`	`int`
`extraArgs`	`String`

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

การขว้าง
`DeviceNotAvailableException`

ติดตั้งแพ็กเกจสำหรับผู้ใช้

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`

โหมดผู้ใช้ระบบไม่มีส่วนหัว

public boolean isHeadlessSystemUserMode ()

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

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

การขว้าง
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

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

การขว้าง
`DeviceNotAvailableException`

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

public boolean isMultiUserSupported ()

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

คิกรีเทิร์น
`boolean`	จริง หากมีการสนับสนุนผู้ใช้หลายคน เป็นเท็จ

การขว้าง
`DeviceNotAvailableException`

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

public boolean isPackageInstalled (String packageName)

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

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

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

การขว้าง
`DeviceNotAvailableException`

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

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

การขว้าง
`DeviceNotAvailableException`

ผู้ใช้กำลังทำงาน

public boolean isUserRunning (int userId)

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

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

คิกรีเทิร์น
`boolean`	จริงหากผู้ใช้ทำงานอยู่ ค่าเป็นเท็จในกรณีอื่นๆ ทั้งหมด

การขว้าง
`DeviceNotAvailableException`

เป็นผู้ใช้รอง

public boolean isUserSecondary (int userId)

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

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

คิกรีเทิร์น
`boolean`	"จริง" หากผู้ใช้เป็นรอง หรือเป็นเท็จ

การขว้าง
`DeviceNotAvailableException`

มองเห็นได้

public boolean isUserVisible (int userId)

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

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

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

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

การขว้าง
`DeviceNotAvailableException`

เป็นUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

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

การขว้าง
`DeviceNotAvailableException`

VisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

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

การขว้าง
`DeviceNotAvailableException`

การแสดงข้อมูลพื้นหลังของผู้ใช้

public boolean isVisibleBackgroundUsersSupported ()

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

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

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

การขว้าง
`DeviceNotAvailableException`

รายการรหัส Display

public  listDisplayIds ()

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

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

การขว้าง
`DeviceNotAvailableException`

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

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`	จริง หากการบันทึกสำเร็จ หรือเป็นเท็จ

AlertSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

พารามิเตอร์
`waitPhase`	`SnapuserdWaitPhase`

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

การขว้าง
`DeviceNotAvailableException`

ตั้งค่าอุปกรณ์เจ้าของ

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)

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

พารามิเตอร์
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

การขว้าง
`DeviceNotAvailableException`

ปิดระบบ Microdroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

ปิดอุปกรณ์ Microdroid หากมี

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

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

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

public boolean startUser (int userId)

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

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

คิกรีเทิร์น
`boolean`	true ถ้าเริ่มต้นผู้ใช้ในเบื้องหลังสำเร็จ

การขว้าง
`DeviceNotAvailableException`

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

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

คิกรีเทิร์น
`boolean`	true ถ้าเริ่มต้นผู้ใช้ในเบื้องหลังสำเร็จ

การขว้าง
`DeviceNotAvailableException`

ผู้ใช้พื้นหลังที่ปรากฏ

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

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

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

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

คิกรีเทิร์น
`boolean`	`true` หากเริ่มแสดงผู้ใช้ในเบื้องหลังเรียบร้อยแล้ว

การขว้าง
`DeviceNotAvailableException`

ผู้ใช้

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

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

พารามิเตอร์
`userId`	`int`: ของผู้ใช้เพื่อหยุด
`waitFlag`	`boolean`: จะทำให้คำสั่งรอจนกว่าผู้ใช้จะหยุด
`forceFlag`	`boolean`: จะบังคับให้ผู้ใช้หยุด

คิกรีเทิร์น
`boolean`	true ถ้าหยุดผู้ใช้สำเร็จ

การขว้าง
`DeviceNotAvailableException`

ผู้ใช้

public boolean stopUser (int userId)

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

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

คิกรีเทิร์น
`boolean`	true ถ้าหยุดผู้ใช้สำเร็จ

การขว้าง
`DeviceNotAvailableException`

รองรับ Microdroid

public boolean supportsMicrodroid ()

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

คิกรีเทิร์น
`boolean`	จะแสดงผลเป็น "จริง" หากเป็นไปตามเงื่อนไขที่กำหนดไว้ล่วงหน้า มิเช่นนั้น จะเป็นเท็จ

รองรับ Microdroid

public boolean supportsMicrodroid (boolean protectedVm)

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

พารามิเตอร์
`protectedVm`	`boolean`: เป็นจริง หาก microdroid มีวัตถุประสงค์เพื่อเรียกใช้บน VM ที่มีการป้องกัน

คิกรีเทิร์น
`boolean`	จะแสดงผลเป็น "จริง" หากเป็นไปตามเงื่อนไขที่กำหนดไว้ล่วงหน้า มิเช่นนั้น จะเป็นเท็จ

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

public boolean switchUser (int userId)

เปลี่ยนเป็น userId อื่นที่มีระยะหมดเวลาเริ่มต้น switchUser(int, long)

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

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

การขว้าง
`DeviceNotAvailableException`

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

public boolean switchUser (int userId, 
                long timeout)

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

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

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

การขว้าง
`DeviceNotAvailableException`

TakeBugreport

public Bugreport takeBugreport ()

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

คิกรีเทิร์น
`Bugreport`

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

public String uninstallPackage (String packageName)

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

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

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

การขว้าง
`DeviceNotAvailableException`

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

public String uninstallPackageForUser (String packageName, 
                int userId)

ถอนการติดตั้งแพ็กเกจ Android จากผู้ใช้รายหนึ่งๆ ออกจากอุปกรณ์

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

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

การขว้าง
`DeviceNotAvailableException`

รอสำหรับSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

พารามิเตอร์
`currentPhase`	`SnapuserdWaitPhase`

การขว้าง
`DeviceNotAvailableException`

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

เครื่องมือแยกวิเคราะห์

protected AaptParser createParser (File appFile)

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

คิกรีเทิร์น
`AaptParser`

รีบูต doAdb

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

ทำการรีบูต adb

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

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

getBugreportภายใน

protected InputStreamSource getBugreportInternal ()

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

getBugreportzภายใน

protected File getBugreportzInternal ()

เมธอดของตัวช่วยภายในเพื่อรับไฟล์ ZIP ของ Bugreportz เป็น ERROR(/File)

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

รับการตรวจสอบผู้ใช้ใหม่การนอนหลับ

protected long getCheckNewUserSleep ()

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

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

getHostCurrentTime

protected long getHostCurrentTime ()

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

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

ตั้งค่า PrePostBootSetup

protected void prePostBootSetup ()

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

การขว้าง
`DeviceNotAvailableException`

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

สรุป

ชั้นเรียนที่ซ้อนกัน

ช่อง

ช่างก่อสร้างสาธารณะ

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

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

ช่อง

DISMISS_KEYGUARD_CMD

ช่างก่อสร้างสาธารณะ

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

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

ผู้ใช้ระบบเปลี่ยนส่วนหัวได้

clearErrorDialogs

สร้างผู้ใช้

สร้างผู้ใช้

สร้างผู้ใช้

createUserNoThrow

disabledKeyguard

doFileExist

doFileExist

ดัมพ์ฮีป

getActiveApexes

getAllSettings

รับรหัส Android

รับรหัส Android

getAppPackageInfo

getAppPackageInfos

getBugreport

getBugreportz

getCurrentFoldableState

getCurrentUser

getFoldableStates

getInstalledPackageNames

getKeyguardState

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

getMainlineModuleInfo

getMaxNumberOfRunningUsersSupported

getMaxNumberOfUsersSupported

getPrimaryUserId

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

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

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

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

GetSetting

GetSetting

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

getUserFlags

getUserInfos

getUserSerialNumber

มีฟีเจอร์

installPackage

installPackage

installPackage

ติดตั้งแพ็กเกจสำหรับผู้ใช้

ติดตั้งแพ็กเกจสำหรับผู้ใช้

installPackages

installPackages

ติดตั้งแพ็กเกจสำหรับผู้ใช้

ติดตั้งแพ็กเกจสำหรับผู้ใช้

ติดตั้ง RemotePackages

ติดตั้ง RemotePackages

รองรับ isAppEnumeration

โหมดผู้ใช้ระบบไม่มีส่วนหัว

isMainUserPermanentAdmin

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

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

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

ผู้ใช้กำลังทำงาน

เป็นผู้ใช้รอง

มองเห็นได้

เป็นUserVisibleOnDisplay

VisibleBackgroundUsersOnDefaultDisplaySupported

การแสดงข้อมูลพื้นหลังของผู้ใช้

รายการรหัส Display

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

แสดงรายการผู้ใช้

logBugreport

AlertSnapuserd

postInvocationTearDown