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

คำสั่งที่ใช้เพื่อปิดตัวป้องกันคีย์ได้

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

TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

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

String adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)

ติดตั้งแพ็กเกจ Android ในอุปกรณ์ด้วยคำสั่ง adb

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

ติดตั้งแพ็กเกจ Android ในอุปกรณ์ด้วยคำสั่ง adb

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)

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

File dumpHeap(String process, String devicePath)

พยายามดัมพ์ฮีปจาก system_server

Set<ITestDevice.ApexInfo> getActiveApexes()

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

Map<String, String> getAllSettings(String namespace)

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

String getAndroidId(int userId)

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

Map<Integer, String> getAndroidIds()

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

PackageInfo getAppPackageInfo(String packageName)

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

List<PackageInfo> getAppPackageInfos()

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

InputStreamSource getBugreport()

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

InputStreamSource getBugreportz()

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

DeviceFoldableState getCurrentFoldableState()

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

int getCurrentUser()

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

Set<DeviceFoldableState> getFoldableStates()

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

Set<String> getInstalledPackageNames()

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

KeyguardControllerState getKeyguardState()

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

Integer getMainUserId()

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

Set<String> getMainlineModuleInfo()

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

int getMaxNumberOfRunningUsersSupported()

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

int getMaxNumberOfUsersSupported(String userType)

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

int getMaxNumberOfUsersSupported()

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

Integer getPrimaryUserId()

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

int getRemainingCreatableUserCount(String userType)

แสดงจำนวนผู้ใช้ประเภทผู้ใช้ที่ระบุซึ่งสร้างในอุปกรณ์นี้ได้

InputStreamSource getScreenshot(Long displayId, String format, boolean rescale)

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

InputStreamSource getScreenshot(String format, boolean rescale)

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

InputStreamSource getScreenshot(String format)

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

InputStreamSource getScreenshot(long displayId)

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

InputStreamSource getScreenshot()

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

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

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

String getSetting(String namespace, String key)

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

Set<String> getUninstallablePackageNames()

ดึงชื่อแพ็กเกจแอปพลิเคชันที่ถอนการติดตั้งได้

int getUserFlags(int userId)

ค้นหาและแสดงผลการแจ้งของผู้ใช้ที่ระบุ

Map<Integer, UserInfo> getUserInfos()

รับแผนที่ของ useId ไปยัง UserInfo ในอุปกรณ์

int getUserSerialNumber(int userId)

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

int getUserVisibleOnDisplay(int displayId)

รับรหัสผู้ใช้ของผู้ใช้ที่มองเห็นได้บนจอแสดงผลที่ระบุ

boolean hasFeature(String feature)

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

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

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

String installPackage(File packageFile, 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 ในอุปกรณ์สำหรับผู้ใช้ที่ระบุ

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

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

String installPackages(List<File> packageFiles, boolean reinstall, String... extraArgs)

String installPackages(List<File> packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

String installPackagesForUser(List<File> packageFiles, boolean reinstall, int userId, String... extraArgs)

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

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

Set<Long> listDisplayIds()

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

Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers()

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

ArrayList<Integer> listUsers()

รับรายชื่อผู้ใช้ในอุปกรณ์

boolean logBugreport(String dataName, ITestLogger listener)

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

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 เป็น File

long getCheckNewUserSleep()

แสดงสำหรับการทดสอบ

long getHostCurrentTime()

แสดงสำหรับการทดสอบ

void prePostBootSetup()

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

ค่าคงที่

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

คำสั่งที่ใช้เพื่อปิดตัวป้องกันคีย์ได้

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

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

TestDevice

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

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

adbInstallPackage

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

ติดตั้งแพ็กเกจ Android ในอุปกรณ์ด้วยคำสั่ง adb

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

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

adbInstallPackage

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

ติดตั้งแพ็กเกจ Android ในอุปกรณ์ด้วยคำสั่ง adb

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

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

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

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
IllegalStateException

createUser

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

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

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

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
IllegalStateException

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)

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

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

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

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

getActiveApexes

public Set<ITestDevice.ApexInfo> getActiveApexes ()

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

การคืนสินค้า
Set<ITestDevice.ApexInfo> Set จาก ApexInfo เปิดใช้งานอยู่ในอุปกรณ์
ส่ง
DeviceNotAvailableException

getAllSettings

public Map<String, String> getAllSettings (String namespace)

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

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

getAndroidId

public String getAndroidId (int userId)

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

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

การคืนสินค้า
String

ส่ง
DeviceNotAvailableException

getAndroidIds

public Map<Integer, String> getAndroidIds ()

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

การคืนสินค้า
Map<Integer, String> แผนที่ของรหัส Android ที่พบซึ่งตรงกับรหัสผู้ใช้
ส่ง
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

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

การคืนสินค้า
PackageInfo PackageInfo หรือ null หากเรียกข้อมูลไม่ได้
ส่ง
DeviceNotAvailableException

getAppPackageInfos

public List<PackageInfo> getAppPackageInfos ()

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

การคืนสินค้า
List<PackageInfo> List จาก PackageInfo ที่ติดตั้งในอุปกรณ์
ส่ง
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

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

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

การคืนสินค้า
InputStreamSource InputStreamSource ซึ่งจะสร้างเนื้อหาของรายงานข้อบกพร่องตามคำขอ ใน กรณีที่ดำเนินการไม่สำเร็จ InputStreamSource จะสร้าง 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 Set<DeviceFoldableState> getFoldableStates ()

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

การคืนสินค้า
Set<DeviceFoldableState>

ส่ง
DeviceNotAvailableException

getInstalledPackageNames

public Set<String> getInstalledPackageNames ()

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

การคืนสินค้า
Set<String> Set ของชื่อแพ็กเกจ String ที่ติดตั้งอยู่ในอุปกรณ์
ส่ง
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

getMainUserId

public Integer getMainUserId ()

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

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

getMainlineModuleInfo

public Set<String> getMainlineModuleInfo ()

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

การคืนสินค้า
Set<String> Set ของโมดูล String mainline ที่ติดตั้งในอุปกรณ์ในปัจจุบัน
ส่ง
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported (String userType)

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

พารามิเตอร์
userType String: ประเภทผู้ใช้ตามที่กำหนดไว้ใน UserManager เช่น "android.os.usertype.full.SECONDARY"
การคืนสินค้า
int จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่รองรับของประเภทผู้ใช้ที่ระบุ
ส่ง
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

รับจำนวนผู้ใช้ที่เปลี่ยนได้สูงสุดที่ระบบรองรับ โดยไม่รวมผู้ใช้ที่เป็นแขกรับเชิญ หลังจาก API เวอร์ชัน 36 จะไม่รวมผู้ใช้ที่เปลี่ยนไม่ได้ (เช่น โปรไฟล์) ค่าเริ่มต้นคือ 0

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

getPrimaryUserId

public Integer getPrimaryUserId ()

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

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

getRemainingCreatableUserCount

public int getRemainingCreatableUserCount (String userType)

แสดงจำนวนผู้ใช้ประเภทผู้ใช้ที่ระบุซึ่งสร้างในอุปกรณ์นี้ได้

พารามิเตอร์
userType String: ประเภทผู้ใช้ตามที่กำหนดไว้ใน UserManager เช่น "android.os.usertype.full.SECONDARY"
การคืนสินค้า
int เพิ่มผู้ใช้ประเภทที่ระบุได้กี่ราย
ส่ง
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (Long displayId, 
                String format, 
                boolean rescale)

ถ่ายภาพหน้าจอจากอุปกรณ์ที่ระบุรหัสจอแสดงผลในรูปแบบที่รองรับ อนุญาตให้ปรับขนาดเพื่อ รองรับขนาดที่เล็กลง

พารามิเตอร์
displayId Long: รหัสการแสดงผลของหน้าจอที่จะจับภาพหน้าจอ
format String: รองรับ PNG, JPEG
rescale boolean: หากควรปรับขนาดภาพหน้าจอเพื่อลดขนาดของรูปภาพที่ได้
การคืนสินค้า
InputStreamSource InputStreamSource ของภาพหน้าจอในรูปแบบ หรือ 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 (String format)

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

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

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

การคืนสินค้า
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 Set<String> getUninstallablePackageNames ()

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

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

getUserFlags

public int getUserFlags (int userId)

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

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

การคืนสินค้า
int แฟล็กที่เชื่อมโยงกับ userId ที่ระบุ หากพบ -10000 ในกรณีอื่นๆ
ส่ง
DeviceNotAvailableException

getUserInfos

public Map<Integer, UserInfo> getUserInfos ()

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

การคืนสินค้า
Map<Integer, UserInfo> รายการออบเจ็กต์ UserInfo
ส่ง
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

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

การคืนสินค้า
int

ส่ง
DeviceNotAvailableException

getUserVisibleOnDisplay

public int getUserVisibleOnDisplay (int displayId)

รับรหัสผู้ใช้ของผู้ใช้ที่มองเห็นได้บนจอแสดงผลที่ระบุ

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

hasFeature

public boolean hasFeature (String feature)

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

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

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

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

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

installPackageWithIncrementalMode

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

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

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

userId String

การคืนสินค้า
boolean

ส่ง
DeviceNotAvailableException

installPackages

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                String... extraArgs)

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

reinstall boolean

extraArgs String

การคืนสินค้า
String

ส่ง
DeviceNotAvailableException

installPackages

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

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

reinstall boolean

grantPermissions boolean

extraArgs String

การคืนสินค้า
String

ส่ง
DeviceNotAvailableException

installPackagesForUser

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

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

reinstall boolean

userId int

extraArgs String

การคืนสินค้า
String

ส่ง
DeviceNotAvailableException

installPackagesForUser

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

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

reinstall boolean

grantPermissions boolean

userId int

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

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

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

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

การคืนสินค้า
boolean อุปกรณ์รองรับผู้ใช้หลายคนที่สลับได้หรือไม่
ส่ง
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

พารามิเตอร์
packageName String: แพ็กเกจที่เรากำลังตรวจสอบว่ามีการติดตั้งหรือไม่
userId String: รหัสผู้ใช้ที่เรากำลังตรวจสอบว่ามีการติดตั้งแพ็กเกจไว้หรือไม่ หากเป็นค่าว่าง ระบบจะใช้ผู้ใช้หลัก เป็น 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 Set<Long> listDisplayIds ()

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

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

listDisplayIdsForStartingVisibleBackgroundUsers

public Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

การคืนสินค้า
Set<Integer>

ส่ง
DeviceNotAvailableException

listUsers

public ArrayList<Integer> listUsers ()

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

การคืนสินค้า
ArrayList<Integer> รายการรหัสผู้ใช้
ส่ง
DeviceNotAvailableException

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

พารามิเตอร์
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 แสดงผลเป็นจริงหากตรงตามเงื่อนไขเบื้องต้น หรือเป็นเท็จหากไม่ตรงตาม
ส่ง
Exception

supportsMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

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

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

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 เป็น File

การคืนสินค้า
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

แสดงสำหรับการทดสอบ

การคืนสินค้า
long

getHostCurrentTime

protected long getHostCurrentTime ()

แสดงสำหรับการทดสอบ

การคืนสินค้า
long

prePostBootSetup

protected void prePostBootSetup ()

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

ส่ง
DeviceNotAvailableException