TestDevice

public class TestDevice
extends NativeDevice

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

การติดตั้งใช้งาน ITestDevice สําหรับอุปกรณ์ Android แบบ Full Stack

สรุป

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

class TestDevice.MicrodroidBuilder

ตัวสร้างที่ใช้สร้าง TestDevice ของ Microdroid 

ช่อง

public static final String DISMISS_KEYGUARD_CMD

คำสั่งที่ใช้ปิดโปรแกรมป้องกันหน้าจอได้

ตัวสร้างแบบสาธารณะ

TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

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

boolean canSwitchToHeadlessSystemUser()

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

boolean clearErrorDialogs()

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

int createUser(String name)

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

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

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

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

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

int createUserNoThrow(String name)

สร้างผู้ใช้ที่มีชื่อที่ระบุและ Flag เริ่มต้น 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()

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

DeviceFoldableState getCurrentFoldableState()

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

int getCurrentUser()

แสดงผลรหัสของผู้ใช้ที่ใช้งานอยู่ในปัจจุบัน

getFoldableStates()

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

getInstalledPackageNames()

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

KeyguardControllerState getKeyguardState()

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

Integer getMainUserId()

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

getMainlineModuleInfo()

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

int getMaxNumberOfRunningUsersSupported()

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

int getMaxNumberOfUsersSupported()

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

Integer getPrimaryUserId()

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

InputStreamSource getScreenshot()

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

InputStreamSource getScreenshot(String format, boolean rescale)

ดึงภาพหน้าจอจากอุปกรณ์

InputStreamSource getScreenshot(long displayId)

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

InputStreamSource getScreenshot(String format)

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

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

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

long getCheckNewUserSleep()

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

long getHostCurrentTime()

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

void prePostBootSetup()

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

ช่อง

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

คำสั่งที่ใช้ปิดโปรแกรมป้องกันหน้าจอได้

ตัวสร้างแบบสาธารณะ

TestDevice

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

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

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

public boolean canSwitchToHeadlessSystemUser ()

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

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

การขว้าง
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

คิกรีเทิร์น
boolean true หากไม่มีกล่องโต้ตอบอยู่หรือล้างกล่องโต้ตอบได้สำเร็จ false ในกรณีอื่น
การขว้าง
DeviceNotAvailableException

createUser

public int createUser (String name)

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

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

สร้างผู้ใช้

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

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

พารามิเตอร์
name String: ของผู้ใช้ที่จะสร้างในอุปกรณ์
guest boolean: เปิดใช้ Flag ผู้ใช้ --guest ระหว่างการสร้าง
ephemeral boolean: เปิดใช้ Flag ของผู้ใช้ --ephemeral ระหว่างการสร้าง
forTesting boolean: เปิดใช้ Test Flag --สำหรับการทดสอบระหว่างการสร้าง
คิกรีเทิร์น
int รหัสของผู้ใช้ที่สร้าง
โยน
DeviceNotAvailableException

สร้างผู้ใช้

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

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

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

createUserNoThrow

public int createUserNoThrow (String name)

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

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

disableKeyguard

public void disableKeyguard ()

พยายามปิดใช้การป้องกันจากการกดแป้นพิมพ์

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

โยน
DeviceNotAvailableException

doFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

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

getActiveApexes

public  getActiveApexes ()

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

คิกรีเทิร์น
เปิดใช้งานแล้ว ERROR(/Set) จาก ApexInfo รหัสในอุปกรณ์
การขว้าง
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

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

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

รับรหัส Android

public String getAndroidId (int userId)

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

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

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

โยน
DeviceNotAvailableException

getAndroidIds

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 version" > 1.0.36

คิกรีเทิร์น
InputStreamSource InputStreamSource ของไฟล์ ZIP ที่มี Bugreportz แสดงผล Null ในกรณีที่เกิดข้อผิดพลาด

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

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

โยน
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

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

การขว้าง
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

คิกรีเทิร์น
โยน
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

getMainUserId

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

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

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

getScreenshot

public InputStreamSource getScreenshot ()

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

คิกรีเทิร์น
InputStreamSource InputStreamSource ของภาพหน้าจอในรูปแบบ png หรือ 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: ขยายการใช้งานด้านบนเพื่อรองรับ "format" และ "rescale"

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

getScreenshot

public InputStreamSource getScreenshot (String format)

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

พารามิเตอร์
format String: รองรับ PNG, JPEG
คิกรีเทิร์น
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

getUninstallablePackageNames

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: รูปแบบควรเป็น "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, 
                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 ในอุปกรณ์

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

พารามิเตอร์
packageFile File: ไฟล์ APK ที่จะติดตั้ง
certFile File: true หากควรติดตั้งอีกครั้ง
reinstall boolean: กำหนดว่าควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาที่ติดตั้งหรือไม่
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 ในอุปกรณ์สำหรับผู้ใช้รายหนึ่งๆ

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

พารามิเตอร์
packageFile File: ไฟล์ APK ที่จะติดตั้ง
reinstall boolean: true หากควรติดตั้งอีกครั้ง
grantPermissions boolean: กำหนดว่าควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาที่ติดตั้งหรือไม่
userId int: รหัสผู้ใช้แบบจำนวนเต็มที่จะติดตั้ง
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

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

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

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

public boolean isPackageInstalled (String packageName)

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

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

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

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

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

isUserRunning

public boolean isUserRunning (int userId)

ตรวจสอบว่าผู้ใช้รายใดกำลังใช้งานอยู่

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

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

isUserSecondary

public boolean isUserSecondary (int userId)

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

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

คิกรีเทิร์น
boolean จริงหากผู้ใช้เป็นผู้ใช้รอง หรือเป็นเท็จหากไม่ใช่
โยน
DeviceNotAvailableException

isUserVisible

public boolean isUserVisible (int userId)

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

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

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

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

โยน
DeviceNotAvailableException

เป็นUserVisibleOnDisplay

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" รายงาน

คิกรีเทิร์น
รายการจอแสดงผล ค่าเริ่มต้นจะแสดงผลเป็น 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

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)

เพิ่มค่าการตั้งค่าลงในเนมสเปซของผู้ใช้รายหนึ่งๆ การตั้งค่าบางอย่างจะใช้ได้หลังจากรีบูตเท่านั้น 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)

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

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

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

พารามิเตอร์
userId int: ของผู้ใช้เพื่อเริ่มทำงานในเบื้องหลัง
waitFlag boolean: จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มต้นและปลดล็อก
คิกรีเทิร์น
boolean true ถ้าเริ่มต้นผู้ใช้ในเบื้องหลังสำเร็จ
โยน
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, 
                boolean waitFlag, 
                boolean forceFlag)

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

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

stopUser

public boolean stopUser (int userId)

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

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

supportsMicrodroid

public boolean supportsMicrodroid ()

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

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

supportsMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

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

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

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

public boolean switchUser (int userId)

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

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

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

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

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

timeout long: เพื่อรอก่อนที่จะแสดงผลลัพธ์เป็นเท็จสำหรับ "เปลี่ยนผู้ใช้ไม่สำเร็จ"
คิกรีเทิร์น
boolean เป็นจริงหากรหัสผู้ใช้ใหม่ตรงกับผู้ให้บริการรหัสผู้ใช้ จะเป็นเท็จหากไม่เป็นเช่นนั้น
โยน
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

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

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

getBugreportภายใน

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