TestDevice

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 

ค่าคงที่

String DISMISS_KEYGUARD_CMD

คำสั่งที่ใช้เพื่อปิด Keyguard ได้

เครื่องมือสร้างสาธารณะ

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)

สร้างผู้ใช้ที่มีชื่อที่ระบุและ Flag ที่ระบุ

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

สร้างผู้ใช้ที่มีชื่อที่ระบุและ Flag ที่ระบุ

int createUserNoThrow(String name)

สร้างผู้ใช้ที่มีชื่อที่ระบุและค่าสถานะเริ่มต้นเป็น 0

void disableKeyguard()

พยายามปิดใช้ Keyguard

boolean doesFileExist(String deviceFilePath, int userId)

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

boolean doesFileExist(String deviceFilePath)

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

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

เรียกข้อมูล bugreportz จากอุปกรณ์

DeviceFoldableState getCurrentFoldableState()

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

int getCurrentUser()

แสดงรหัสของผู้ใช้ที่กำลังเรียกใช้

getFoldableStates()

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

getInstalledPackageNames()

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

KeyguardControllerState getKeyguardState()

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

Integer getMainUserId()

แสดงผลรหัสผู้ใช้หลัก

getMainlineModuleInfo()

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

int getMaxNumberOfRunningUsersSupported()

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

int getMaxNumberOfUsersSupported()

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

Integer getPrimaryUserId()

แสดงผลรหัสผู้ใช้หลัก

InputStreamSource getScreenshot(String format, boolean rescale)

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

InputStreamSource getScreenshot(long displayId)

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

InputStreamSource getScreenshot(String format)

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

InputStreamSource getScreenshot()

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

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

แสดงค่าของการตั้งค่าที่ขอ

String getSetting(String namespace, String key)

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

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, File certFile, boolean reinstall, String... extraArgs)

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

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

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

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

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

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

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

boolean installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)

ติดตั้ง APK ด้วยโหมดเพิ่ม

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

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

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

String installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, 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, String userId)

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

boolean isPackageInstalled(String packageName)

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

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 setFirstBootloaderReboot()
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 stopUser(int userId, boolean waitFlag, boolean forceFlag)

หยุดผู้ใช้ที่ระบุ

boolean supportsMicrodroid()

ตรวจสอบข้อกำหนดเบื้องต้นในการเรียกใช้ Microdroid

boolean supportsMicrodroid(boolean protectedVm)

ตรวจสอบข้อกำหนดเบื้องต้นในการเรียกใช้ Microdroid

boolean switchUser(int userId)

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

boolean switchUser(int userId, long timeout)

เปลี่ยนไปใช้ userId อื่นโดยมีระยะหมดเวลาที่ระบุเป็นกำหนดเวลา

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

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

long getCheckNewUserSleep()

เปิดเผยเพื่อการทดสอบ

long getHostCurrentTime()

เปิดให้ทดสอบ

void prePostBootSetup()

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

ค่าคงที่

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

คำสั่งที่ใช้เพื่อปิด Keyguard ได้

ค่าคงที่: "input keyevent 82"

เครื่องมือสร้างสาธารณะ

TestDevice

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

เมธอดสาธารณะ

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

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

การขว้าง
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

คิกรีเทิร์น
boolean true หากไม่มีกล่องโต้ตอบหรือล้างกล่องโต้ตอบเรียบร้อยแล้ว false หรือไม่เช่นนั้น
การขว้าง
DeviceNotAvailableException

createUser

public int createUser (String name)

สร้างผู้ใช้ที่มีชื่อที่ระบุและค่าสถานะเริ่มต้นเป็น 0

พารามิเตอร์
name String: ของผู้ใช้เพื่อสร้างในอุปกรณ์
คิกรีเทิร์น
int จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้น
การขว้าง
DeviceNotAvailableException

createUser

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

สร้างผู้ใช้ที่มีชื่อที่ระบุและ Flag ที่ระบุ

พารามิเตอร์
name String: ของผู้ใช้เพื่อสร้างในอุปกรณ์
guest boolean: เปิดใช้แฟล็กผู้ใช้ --guest ในระหว่างการสร้าง
ephemeral boolean: เปิดใช้แฟล็กผู้ใช้ --ephemeral ระหว่างการสร้าง
คิกรีเทิร์น
int รหัสของผู้ใช้ที่สร้างขึ้น
การขว้าง
DeviceNotAvailableException

createUser

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

สร้างผู้ใช้ที่มีชื่อที่ระบุและ Flag ที่ระบุ

พารามิเตอร์
name String: ของผู้ใช้เพื่อสร้างในอุปกรณ์
guest boolean: เปิดใช้แฟล็กผู้ใช้ --guest ในระหว่างการสร้าง
ephemeral boolean: เปิดใช้แฟล็กผู้ใช้ --ephemeral ระหว่างการสร้าง
forTesting boolean: เปิดใช้ Flag การทดสอบ --for-testing ระหว่างการสร้าง
คิกรีเทิร์น
int รหัสของผู้ใช้ที่สร้างขึ้น
การขว้าง
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

สร้างผู้ใช้ที่มีชื่อที่ระบุและค่าสถานะเริ่มต้นเป็น 0

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

disableKeyguard

public void disableKeyguard ()

พยายามปิดใช้ Keyguard

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

การขว้าง
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

พารามิเตอร์
deviceFilePath String: เส้นทางแบบเต็มของไฟล์ในอุปกรณ์ที่จะตรวจสอบ
userId int: รหัสผู้ใช้ที่จะใช้ตรวจสอบว่ามีไฟล์อยู่หรือไม่
คิกรีเทิร์น
boolean true หากมีไฟล์อยู่ false มิฉะนั้น
การขว้าง
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

พารามิเตอร์
deviceFilePath String: เส้นทางแบบเต็มของไฟล์ในอุปกรณ์ที่จะตรวจสอบ
คิกรีเทิร์น
boolean true หากมีไฟล์อยู่ false มิฉะนั้น
การขว้าง
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

พยายามทิ้งฮีปจาก system_server ผู้โทรมีหน้าที่ล้างข้อมูล ในไฟล์ที่ส่งออก

พารามิเตอร์
process String: ชื่อของกระบวนการอุปกรณ์ที่จะใช้ dumpheap
devicePath String: เส้นทางในอุปกรณ์ที่จะวางไฟล์การทิ้ง ต้องเป็นตำแหน่งที่ สิทธิ์อนุญาต
คิกรีเทิร์น
File ERROR(/File)ที่มีรายงาน เป็น Null หากเกิดข้อผิดพลาด
การขว้าง
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

คิกรีเทิร์น
ERROR(/Set) จาก ApexInfo ที่เปิดใช้งานอยู่ในอุปกรณ์
การขว้าง
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

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

พารามิเตอร์
namespace String: ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ {"system", "secure", "global"}
คิกรีเทิร์น
แผนที่ของคู่คีย์-ค่า เป็น Null หากไม่รองรับเนมสเปซ
การขว้าง
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

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

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

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

การขว้าง
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

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

คิกรีเทิร์น
แผนที่ของรหัส 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 ()

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

รองรับเฉพาะ "adb version" > 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 ()

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

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

getMainUserId

public Integer getMainUserId ()

แสดงผลรหัสผู้ใช้หลัก

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

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

getPrimaryUserId

public Integer getPrimaryUserId ()

แสดงผลรหัสผู้ใช้หลัก

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

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

พารามิเตอร์
format String: รองรับ PNG, JPEG
rescale boolean: หากควรปรับขนาดภาพหน้าจอเพื่อลดขนาดของรูปภาพที่ได้
คิกรีเทิร์น
InputStreamSource InputStreamSource ของภาพหน้าจอในรูปแบบ หรือ null หาก ภาพหน้าจอไม่สำเร็จ
การขว้าง
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (long displayId)

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

TODO: extend the implementations above to support 'format' and 'rescale'

พารามิเตอร์
displayId long: รหัสการแสดงผลของหน้าจอที่จะจับภาพหน้าจอ
คิกรีเทิร์น
InputStreamSource InputStreamSource ของภาพหน้าจอในรูปแบบ หรือ null หาก ภาพหน้าจอไม่สำเร็จ
การขว้าง
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format)

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

พารามิเตอร์
format String: รองรับ PNG, JPEG
คิกรีเทิร์น
InputStreamSource InputStreamSource ของภาพหน้าจอในรูปแบบ หรือ null หาก ภาพหน้าจอไม่สำเร็จ
การขว้าง
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot ()

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

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

getSetting

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

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

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

namespace String

key String

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

getSetting

public String getSetting (String namespace, 
                String key)

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

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

key String

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

การขว้าง
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

getUserFlags

public int getUserFlags (int userId)

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

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

คิกรีเทิร์น
int the flags associated with the userId provided if found, -10000 in any other cases.
การขว้าง
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

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

คิกรีเทิร์น
รายการออบเจ็กต์ UserInfo
การขว้าง
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

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

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

การขว้าง
DeviceNotAvailableException

hasFeature

public boolean hasFeature (String feature)

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

พารามิเตอร์
feature String: รูปแบบควรเป็น "feature:" หรือ "" โดยตรง
คิกรีเทิร์น
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, 
                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

installPackage

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

installPackageForUser

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

installPackageForUser

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

installPackageWithIncrementalMode

public boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

ติดตั้ง APK ด้วยโหมดเพิ่ม

พารามิเตอร์
apkFiles File: ไฟล์ APK ที่จะติดตั้ง
extraArgs String

userId String

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

การขว้าง
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

installPackagesForUser

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

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

reinstall boolean

userId int

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

installRemotePackages

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

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

reinstall boolean

extraArgs String

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

การขว้าง
DeviceNotAvailableException

installRemotePackages

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

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

reinstall boolean

grantPermissions boolean

extraArgs String

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

การขว้าง
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

คิกรีเทิร์น
boolean เป็นจริงหากระบบรองรับการแจงนับแอป เป็นเท็จในกรณีอื่นๆ
การขว้าง
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

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

การขว้าง
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

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

การขว้าง
DeviceNotAvailableException

isMultiUserSupported

public boolean isMultiUserSupported ()

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

คิกรีเทิร์น
boolean จริงหากรองรับผู้ใช้หลายคน เท็จหากไม่รองรับ
การขว้าง
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

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

listDisplayIds

public  listDisplayIds ()

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

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

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

คิกรีเทิร์น
การขว้าง
DeviceNotAvailableException

listUsers

public  listUsers ()

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

คิกรีเทิร์น
รายการรหัสผู้ใช้
การขว้าง
DeviceNotAvailableException

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

เมธอดช่วยในการสร้างรายงานข้อบกพร่องและบันทึกไปยังผู้รายงาน

พารามิเตอร์
dataName String: ชื่อที่จะใช้รายงานข้อบกพร่อง
listener ITestLogger: ITestLogger เพื่อบันทึกรายงานข้อบกพร่อง
คิกรีเทิร์น
boolean เป็นจริงหากการบันทึกสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

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

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

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

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

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

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

removeOwners

public void removeOwners ()

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

การขว้าง
DeviceNotAvailableException

removeUser

public boolean removeUser (int userId)

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

พารามิเตอร์
userId int: ของผู้ใช้ที่ต้องการนำออก
คิกรีเทิร์น
boolean จริง หากเรานำผู้ใช้ออกได้สำเร็จ หรือเป็นเท็จ
การขว้าง
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

setFirstBootloaderReboot

public void setFirstBootloaderReboot ()

setSetting

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

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

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

key String

value String

การขว้าง
DeviceNotAvailableException

setSetting

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

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

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

namespace String

key String

value String

การขว้าง
DeviceNotAvailableException

shutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

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

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

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

startUser

public boolean startUser (int userId)

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

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

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

stopUser

public boolean stopUser (int userId)

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

พารามิเตอร์
userId int: ของผู้ใช้เพื่อหยุด
คิกรีเทิร์น
boolean จริง หากหยุดผู้ใช้สำเร็จ
การขว้าง
DeviceNotAvailableException

stopUser

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

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

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

supportsMicrodroid

public boolean supportsMicrodroid ()

ตรวจสอบข้อกำหนดเบื้องต้นในการเรียกใช้ Microdroid

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

supportsMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

ตรวจสอบข้อกำหนดเบื้องต้นในการเรียกใช้ Microdroid

พารามิเตอร์
protectedVm boolean: จริง หากตั้งใจให้ Microdroid ทำงานใน VM ที่ได้รับการปกป้อง
คิกรีเทิร์น
boolean แสดงผลเป็นจริงหากตรงตามข้อกำหนดเบื้องต้น หรือเป็นเท็จหากไม่ตรงตาม

switchUser

public boolean switchUser (int userId)

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

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

คิกรีเทิร์น
boolean จริง หาก userId ใหม่ตรงกับผู้ให้บริการ userId มิเช่นนั้นจะเป็น "เท็จ"
การขว้าง
DeviceNotAvailableException

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

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

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

takeBugreport

public Bugreport takeBugreport ()

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

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

uninstallPackage

public String uninstallPackage (String packageName)

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

พารามิเตอร์
packageName String: แพ็กเกจ Android ที่จะถอนการติดตั้ง
คิกรีเทิร์น
String String พร้อมรหัสข้อผิดพลาด หรือ null หากสำเร็จ
การขว้าง
DeviceNotAvailableException

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

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

การขว้าง
DeviceNotAvailableException

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

createParser

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

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

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

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

เปิดเผยเพื่อการทดสอบ

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

getHostCurrentTime

protected long getHostCurrentTime ()

เปิดให้ทดสอบ

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

prePostBootSetup

protected void prePostBootSetup ()

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

การขว้าง
DeviceNotAvailableException