TestDevice

public class TestDevice
extends NativeDevice

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

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

สรุป

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

class TestDevice.MicrodroidBuilder

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

ช่อง

public static final String DISMISS_KEYGUARD_CMD

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

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

TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

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

boolean canSwitchToHeadlessSystemUser()

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

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

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

int getCurrentUser()

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

getFoldableStates()

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

getInstalledPackageNames()

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

KeyguardControllerState getKeyguardState()

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

Integer getMainUserId()

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

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)

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

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 waitFlag, boolean forceFlag)

หยุดผู้ใช้รายหนึ่ง

boolean stopUser(int userId)

หยุดผู้ใช้รายหนึ่ง

boolean supportsMicrodroid()

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

boolean supportsMicrodroid(boolean protectedVm)

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

boolean switchUser(int userId)

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

boolean switchUser(int userId, long timeout)

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

Bugreport takeBugreport()

รับรายงานข้อบกพร่องและแสดงผลภายในออบเจ็กต์ Bugreport เพื่อจัดการ

String uninstallPackage(String packageName)

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

String uninstallPackageForUser(String packageName, int userId)

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

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)

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

canSwitchToHeadlessSystemUser

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

createUser

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

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

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

createUser

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

doesFileExist

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) ที่มีรายงาน 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 ()

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

การติดตั้งใช้งานนี้รับประกันว่าจะยังคงทำงานต่อไปในอุปกรณ์ที่ไม่มีการ์ด 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 ()

แสดงผลรหัสของผู้ใช้ที่ใช้งานอยู่ในปัจจุบัน ในกรณีที่เกิดข้อผิดพลาด ระบบจะแสดงผล -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 ของผู้ใช้หลัก หากมี และค่าว่างหากไม่มีผู้ใช้หลัก
โยน
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 ค่าที่เชื่อมโยงกับ namespace:key ของผู้ใช้ Null หากไม่พบ
โยน
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

โยน
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

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

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

คิกรีเทิร์น
int Flag ที่เชื่อมโยงกับ userId ที่ระบุ หากพบ -10000 ในกรณีอื่นๆ
โยน
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, 
                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

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

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

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

isPackageInstalled

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

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

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

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

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

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

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

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

stopUser

public boolean stopUser (int userId)

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

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

supportsMicrodroid

public boolean supportsMicrodroid ()

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

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

supportsMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

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

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

switchUser

public boolean switchUser (int userId)

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

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

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

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

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