ไอเทสดีไวซ์

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


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

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

สรุป

คลาสที่ซ้อนกัน

class ITestDevice.ApexInfo

คลาส struct ง่าย ๆ เพื่อเก็บข้อมูลเกี่ยวกับ APEX เดียว

class ITestDevice.MountPointInfo

คลาสโครงสร้างอย่างง่ายในการจัดเก็บข้อมูลเกี่ยวกับจุดเมานท์เดียว

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

abstract boolean canSwitchToHeadlessSystemUser ()

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

abstract boolean checkConnectivity ()

ตรวจสอบว่าอุปกรณ์นั้นมีการเชื่อมต่อเครือข่าย

abstract boolean clearErrorDialogs ()

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

abstract void clearLastConnectedWifiNetwork ()

ล้างเครือข่าย wifi ที่เชื่อมต่อล่าสุด

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

เชื่อมต่อกับเครือข่าย wifi

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

เชื่อมต่อกับเครือข่าย wifi

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

เชื่อมต่อกับเครือข่าย wifi

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)

เชื่อมต่อกับเครือข่าย wifi

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)

ตัวแปรของ connectToWifiNetwork(String, String) ที่เชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ไม่มีการเชื่อมต่อเครือข่าย

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

ตัวแปรของ connectToWifiNetwork(String, String) ที่เชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ไม่มีการเชื่อมต่อเครือข่าย

abstract int createUser (String name)

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

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

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

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

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

abstract int createUserNoThrow (String name)

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

abstract void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

ลบ IDeviceActionReceiver ที่ลงทะเบียนไว้

abstract void disableKeyguard ()

พยายามปิดการใช้งานคีย์การ์ด

abstract boolean disableNetworkMonitor ()

ปิดใช้งานการตรวจสอบเครือข่ายบนอุปกรณ์

abstract boolean disconnectFromWifi ()

ตัดการเชื่อมต่อจากเครือข่าย wifi

abstract boolean doesFileExist (String deviceFilePath, int userId)

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

abstract File dumpHeap (String process, String devicePath)

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

abstract boolean enableNetworkMonitor ()

เปิดใช้งานการตรวจสอบเครือข่ายบนอุปกรณ์

abstract getActiveApexes ()

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

abstract getAllSettings (String namespace)

ส่งกลับคู่ค่าคีย์ของเนมสเปซที่ร้องขอ

abstract String getAndroidId (int userId)

ค้นหาและส่งกลับ android-id ที่เกี่ยวข้องกับ userId หากไม่พบจะเป็นโมฆะ

abstract getAndroidIds ()

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

abstract PackageInfo getAppPackageInfo (String packageName)

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

abstract getAppPackageInfos ()

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

abstract InputStreamSource getBugreport ()

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

abstract InputStreamSource getBugreportz ()

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

abstract DeviceFoldableState getCurrentFoldableState ()

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

abstract int getCurrentUser ()

คืนรหัสของผู้ใช้ที่ทำงานอยู่ในปัจจุบัน

abstract getFoldableStates ()

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

abstract getInstalledPackageNames ()

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

abstract String getIpAddress ()

รับที่อยู่ IP ของอุปกรณ์

abstract KeyguardControllerState getKeyguardState ()

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

abstract Integer getMainUserId ()

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

abstract getMainlineModuleInfo ()

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

abstract int getMaxNumberOfRunningUsersSupported ()

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

abstract int getMaxNumberOfUsersSupported ()

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

abstract TestDeviceOptions getOptions ()

ดึงตัวเลือกการทดสอบสำหรับอุปกรณ์

abstract Integer getPrimaryUserId ()

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

abstract InputStreamSource getScreenshot ()

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

abstract InputStreamSource getScreenshot (String format, boolean rescale)

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

abstract InputStreamSource getScreenshot (String format)

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

abstract InputStreamSource getScreenshot (long displayId)

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

abstract String getSetting (String namespace, String key)

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

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

ส่งกลับค่าของการตั้งค่าที่ร้องขอ

abstract getUninstallablePackageNames ()

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

abstract int getUserFlags (int userId)

ค้นหาและส่งคืนแฟล็กของผู้ใช้ที่กำหนด

abstract getUserInfos ()

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

abstract int getUserSerialNumber (int userId)

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

abstract boolean hasFeature (String feature)

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

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

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

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

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

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

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

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

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

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์)

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ที่วางอยู่บนอุปกรณ์ Android

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกเพิ่มเติมหนึ่งไฟล์) สำหรับผู้ใช้ที่กำหนด

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกเพิ่มเติมหนึ่งไฟล์) สำหรับผู้ใช้ที่กำหนด

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ที่วางอยู่บนอุปกรณ์ Android

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ที่วางอยู่บนอุปกรณ์ Android

abstract boolean isHeadlessSystemUserMode ()

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

abstract boolean isMainUserPermanentAdmin ()

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

abstract boolean isMultiUserSupported ()

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

abstract boolean isPackageInstalled (String packageName)

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

abstract boolean isPackageInstalled (String packageName, String userId)

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

abstract boolean isUserRunning (int userId)

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

abstract boolean isUserSecondary (int userId)

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

abstract boolean isUserVisible (int userId)

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

abstract boolean isUserVisibleOnDisplay (int userId, int displayId)

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

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

abstract boolean isVisibleBackgroundUsersSupported ()

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

abstract boolean isWifiEnabled ()

ทดสอบว่าเปิดใช้งาน wifi หรือไม่

abstract listDisplayIds ()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers ()

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

abstract listUsers ()

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

abstract boolean logBugreport (String dataName, ITestLogger listener)

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

abstract void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

ลงทะเบียน IDeviceActionReceiver สำหรับอุปกรณ์นี้

abstract boolean removeAdmin (String componentName, int userId)

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

abstract void removeOwners ()

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

abstract boolean removeUser (int userId)

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

abstract boolean setDeviceOwner (String componentName, int userId)

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

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

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

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

เพิ่มค่าการตั้งค่าให้กับเนมสเปซของผู้ใช้ที่กำหนด

abstract boolean startUser (int userId)

เริ่มต้นผู้ใช้ที่กำหนดในเบื้องหลังหากหยุดทำงานอยู่ในปัจจุบัน

abstract boolean startUser (int userId, boolean waitFlag)

เริ่มต้นผู้ใช้ที่กำหนดในเบื้องหลังหากหยุดทำงานอยู่ในปัจจุบัน

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

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

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

หยุดผู้ใช้ที่กำหนด

abstract boolean stopUser (int userId)

หยุดผู้ใช้ที่กำหนด

abstract boolean switchUser (int userId)

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

abstract boolean switchUser (int userId, long timeout)

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

abstract Bugreport takeBugreport ()

รับรายงานข้อบกพร่องและส่งคืนภายในวัตถุ Bugreport เพื่อจัดการ

abstract String uninstallPackage (String packageName)

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

abstract String uninstallPackageForUser (String packageName, int userId)

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

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

สามารถ SwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

ตรวจสอบการเชื่อมต่อ

public abstract boolean checkConnectivity ()

ตรวจสอบว่าอุปกรณ์นั้นมีการเชื่อมต่อเครือข่าย

การส่งคืน
boolean true หากอุปกรณ์มีการเชื่อมต่อเครือข่ายที่ใช้งานได้ false เกิน

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

ล้างข้อผิดพลาด Dialogs

public abstract boolean clearErrorDialogs ()

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

การส่งคืน
boolean true หากไม่มีไดอะล็อกปรากฏหรือล้างไดอะล็อกสำเร็จ false เป็นอย่างอื่น

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

เชื่อมต่อ ToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

เชื่อมต่อกับเครือข่าย wifi

เปิด wifi และบล็อกจนกว่าจะมีการเชื่อมต่อสำเร็จกับเครือข่าย wifi ใดเครือข่ายหนึ่งที่ระบุในแผนที่ wifiSsidToPsk เมื่อทำการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากรีบูตทุกครั้งจนกว่าจะมีการเรียก ITestDevice#disconnectFromWifi() หรือ ITestDevice#clearLastConnectedWifiNetwork()

พารามิเตอร์
wifiSsidToPsk : แผนที่ wifi SSID เป็นรหัสผ่าน

scanSsid boolean : จะสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่

การส่งคืน
boolean true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false เป็นอย่างอื่น

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

เชื่อมต่อ ToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

เชื่อมต่อกับเครือข่าย wifi

เปิด wifi และบล็อกจนกว่าจะมีการเชื่อมต่อสำเร็จกับเครือข่าย wifi ใดเครือข่ายหนึ่งที่ระบุในแผนที่ wifiSsidToPsk เมื่อทำการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากรีบูตทุกครั้งจนกว่าจะมีการเรียก ITestDevice#disconnectFromWifi() หรือ ITestDevice#clearLastConnectedWifiNetwork()

พารามิเตอร์
wifiSsidToPsk : แผนที่ wifi SSID เป็นรหัสผ่าน

การส่งคืน
boolean true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false เป็นอย่างอื่น

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

เชื่อมต่อ ToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

เชื่อมต่อกับเครือข่าย wifi

เปิด wifi และบล็อกจนกว่าจะเชื่อมต่อกับเครือข่าย wifi ที่ระบุได้สำเร็จ เมื่อทำการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากรีบูตทุกครั้งจนกว่าจะมีการเรียก ITestDevice#disconnectFromWifi() หรือ ITestDevice#clearLastConnectedWifiNetwork()

พารามิเตอร์
wifiSsid String : wifi ssid ที่จะเชื่อมต่อ

wifiPsk String : ข้อความรหัสผ่าน PSK หรือ null หากไม่ได้เข้ารหัส

การส่งคืน
boolean true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false เป็นอย่างอื่น

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

เชื่อมต่อ ToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

เชื่อมต่อกับเครือข่าย wifi

เปิด wifi และบล็อกจนกว่าจะเชื่อมต่อกับเครือข่าย wifi ที่ระบุได้สำเร็จ เมื่อทำการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากรีบูตทุกครั้งจนกว่าจะมีการเรียก ITestDevice#disconnectFromWifi() หรือ ITestDevice#clearLastConnectedWifiNetwork()

พารามิเตอร์
wifiSsid String : wifi ssid ที่จะเชื่อมต่อ

wifiPsk String : ข้อความรหัสผ่าน PSK หรือ null หากไม่ได้เข้ารหัส

scanSsid boolean : จะสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่

การส่งคืน
boolean true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false เป็นอย่างอื่น

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

เชื่อมต่อ ToWifiNetwork ถ้าจำเป็น

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

ตัวแปรของ connectToWifiNetwork(String, String) ที่เชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ไม่มีการเชื่อมต่อเครือข่าย

พารามิเตอร์
scanSsid boolean : จะสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่

การส่งคืน
boolean true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false เป็นอย่างอื่น

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

เชื่อมต่อ ToWifiNetwork ถ้าจำเป็น

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

ตัวแปรของ connectToWifiNetwork(String, String) ที่เชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ไม่มีการเชื่อมต่อเครือข่าย

การส่งคืน
boolean true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false เป็นอย่างอื่น

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

createUser

public abstract int createUser (String name)

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

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

การส่งคืน
int จำนวนเต็มสำหรับ ID ผู้ใช้ที่สร้างขึ้น

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

createUser

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

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

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

guest boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --guest ระหว่างการสร้าง

ephemeral boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --ชั่วคราวระหว่างการสร้าง

forTesting boolean : เปิดใช้งานแฟล็กทดสอบ --สำหรับการทดสอบระหว่างการสร้าง

การส่งคืน
int id ของผู้ใช้ที่สร้างขึ้น

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

createUser

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

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

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

guest boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --guest ระหว่างการสร้าง

ephemeral boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --ชั่วคราวระหว่างการสร้าง

การส่งคืน
int id ของผู้ใช้ที่สร้างขึ้น

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

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

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

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

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

ยกเลิกการลงทะเบียนDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

ลบ IDeviceActionReceiver ที่ลงทะเบียนไว้

พารามิเตอร์
deviceActionReceiver IDeviceActionReceiver : IDeviceActionReceiver ซึ่งจะถูกลบออก

ปิดการใช้งานKeyguard

public abstract void disableKeyguard ()

พยายามปิดการใช้งานคีย์การ์ด

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

ขว้าง
DeviceNotAvailableException

ปิดการใช้งาน NetworkMonitor

public abstract boolean disableNetworkMonitor ()

ปิดใช้งานการตรวจสอบเครือข่ายบนอุปกรณ์

การส่งคืน
boolean true หากปิดใช้งานการตรวจสอบสำเร็จ false ถ้ามันล้มเหลว

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

ตัดการเชื่อมต่อจาก Wifi

public abstract boolean disconnectFromWifi ()

ตัดการเชื่อมต่อจากเครือข่าย wifi

ลบเครือข่ายทั้งหมดออกจากรายการเครือข่ายที่รู้จักและปิดการใช้งาน wifi

การส่งคืน
boolean true หากตัดการเชื่อมต่อจากเครือข่าย wifi สำเร็จ false หากการเชื่อมต่อล้มเหลว

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

ไม่FileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

userId int : ID ผู้ใช้ที่ใช้ตรวจสอบการมีอยู่ของไฟล์

การส่งคืน
boolean true หากมีไฟล์อยู่ มิฉะนั้นจะ false

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

พารามิเตอร์
process String : ชื่อของกระบวนการอุปกรณ์ที่จะดัมพ์ฮีป

devicePath String : เส้นทางบนอุปกรณ์ที่จะวางดัมพ์ นี่จะต้องเป็นสถานที่ที่ได้รับอนุญาต

การส่งคืน
File ERROR(/File) ที่มีรายงาน เป็นโมฆะหากมีบางอย่างล้มเหลว

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

เปิดใช้งาน NetworkMonitor

public abstract boolean enableNetworkMonitor ()

เปิดใช้งานการตรวจสอบเครือข่ายบนอุปกรณ์

การส่งคืน
boolean true หากเปิดใช้งานการตรวจสอบได้สำเร็จ false ถ้ามันล้มเหลว

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

getActiveApexes

public abstract  getActiveApexes ()

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

การส่งคืน
ERROR(/Set) ของ ApexInfo เปิดใช้งานบนอุปกรณ์ในปัจจุบัน

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

รับการตั้งค่าทั้งหมด

public abstract  getAllSettings (String namespace)

ส่งกลับคู่ค่าคีย์ของเนมสเปซที่ร้องขอ

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

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

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

รับ AndroidId

public abstract String getAndroidId (int userId)

ค้นหาและส่งกลับ android-id ที่เกี่ยวข้องกับ userId หากไม่พบจะเป็นโมฆะ

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

การส่งคืน
String

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

รับรหัส Android

public abstract  getAndroidIds ()

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

การส่งคืน
พบแผนที่รหัส Android ที่ตรงกับรหัสผู้ใช้

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

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

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

การส่งคืน
PackageInfo PackageInfo หรือ null หากไม่สามารถดึงข้อมูลได้

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

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

การส่งคืน
ERROR(/List) ของ PackageInfo ที่ติดตั้งบนอุปกรณ์

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

รับ Bugreport

public abstract InputStreamSource getBugreport ()

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

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

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

รับ Bugreportz

public abstract InputStreamSource getBugreportz ()

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

รองรับเฉพาะ 'เวอร์ชัน adb' > 1.0.36 เท่านั้น

การส่งคืน
InputStreamSource InputStreamSource ของไฟล์ zip ที่มี bugreportz ส่งคืนค่า null ในกรณีที่เกิดความล้มเหลว

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

การส่งคืน
DeviceFoldableState

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

getCurrentUser

public abstract int getCurrentUser ()

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

การส่งคืน
int

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

getFoldableStates

public abstract  getFoldableStates ()

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

การส่งคืน

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

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

getIpAddress

public abstract String getIpAddress ()

รับที่อยู่ IP ของอุปกรณ์

การส่งคืน
String ที่อยู่ IP ของอุปกรณ์ หรือเป็น null หากอุปกรณ์ไม่มีที่อยู่ IP

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

getMainUserId

public abstract Integer getMainUserId ()

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

การส่งคืน
Integer userId ของผู้ใช้หลัก หากมี และเป็นโมฆะหากไม่มีผู้ใช้หลัก

ขว้าง
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException หากเอาต์พุตจากอุปกรณ์ไม่เป็นไปตามที่คาดไว้
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

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

getMaxNumberOfRunningUsersได้รับการสนับสนุน

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

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

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

รับตัวเลือก

public abstract TestDeviceOptions getOptions ()

ดึงตัวเลือกการทดสอบสำหรับอุปกรณ์

การส่งคืน
TestDeviceOptions TestDeviceOptions ที่เกี่ยวข้องกับอุปกรณ์ที่อยู่ระหว่างการทดสอบ

รับ PrimaryUserId

public abstract Integer getPrimaryUserId ()

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

การส่งคืน
Integer userId ของผู้ใช้หลัก หากมี และเป็นค่าว่างหากไม่มีผู้ใช้หลัก

ขว้าง
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException หากเอาต์พุตจากอุปกรณ์ไม่เป็นไปตามที่คาดไว้
DeviceNotAvailableException

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

public abstract InputStreamSource getScreenshot ()

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

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

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

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

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

พารามิเตอร์
format String : รองรับ PNG, JPEG

rescale boolean : หากควรปรับขนาดภาพหน้าจอเพื่อลดขนาดของภาพที่ได้

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

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

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

public abstract InputStreamSource getScreenshot (String format)

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

พารามิเตอร์
format String : รองรับ PNG, JPEG

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

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

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

public abstract InputStreamSource getScreenshot (long displayId)

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

สิ่งที่ต้องทำ: ขยายการใช้งานด้านบนเพื่อรองรับ 'รูปแบบ' และ 'ปรับขนาดใหม่'

พารามิเตอร์
displayId long : รหัสที่แสดงของหน้าจอที่จะรับภาพหน้าจอ

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

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

รับการตั้งค่า

public abstract String getSetting (String namespace, 
                String key)

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

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

key String

การส่งคืน
String

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

รับการตั้งค่า

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

ส่งกลับค่าของการตั้งค่าที่ร้องขอ เนมสเปซจะต้องเป็นหนึ่งใน: {"system", "secure", "global"}

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

namespace String

key String

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

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

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

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

getUserFlags

public abstract int getUserFlags (int userId)

ค้นหาและส่งคืนแฟล็กของผู้ใช้ที่กำหนด การตั้งค่าสถานะถูกกำหนดไว้ในคลาส "android.content.pm.UserInfo" ในโครงการ Android Open Source

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

การส่งคืน
int ค่าสถานะที่เกี่ยวข้องกับ userId ที่ระบุหากพบ -10000 ในกรณีอื่น ๆ

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

getUserInfos

public abstract  getUserInfos ()

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

การส่งคืน
รายการออบเจ็กต์ UserInfo

ขว้าง
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

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

การส่งคืน
int

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

มีคุณลักษณะ

public abstract boolean hasFeature (String feature)

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

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

การส่งคืน
boolean เป็นจริงหากพบคุณลักษณะ มิฉะนั้นจะเป็นเท็จ

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

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

public abstract 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 หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

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

public abstract 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 หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้
UnsupportedOperationException หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

ติดตั้ง PackageForUser

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

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

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

พารามิเตอร์
packageFile File : ไฟล์ apk ที่จะติดตั้ง

reinstall boolean : true หากควรทำการติดตั้งใหม่

grantPermissions boolean : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง

userId int : ID ผู้ใช้จำนวนเต็มที่จะติดตั้ง

extraArgs String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

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

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้
UnsupportedOperationException หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

ติดตั้ง PackageForUser

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

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

พารามิเตอร์
packageFile File : ไฟล์ apk ที่จะติดตั้ง

reinstall boolean : true หากควรทำการติดตั้งใหม่

userId int : ID ผู้ใช้จำนวนเต็มที่จะติดตั้ง

extraArgs String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

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

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

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

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ดู "https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีการแบ่ง APK เป็นหลายไฟล์

พารามิเตอร์
packageFiles : ไฟล์ apk ในเครื่อง

reinstall boolean : true หากควรทำการติดตั้งใหม่

extraArgs String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

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

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้
UnsupportedOperationException หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

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

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ที่วางอยู่บนอุปกรณ์ Android ดู "https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีการแบ่ง APK เป็นหลายไฟล์

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

พารามิเตอร์
packageFiles : เส้นทางไฟล์ APK ระยะไกลที่จะติดตั้ง

reinstall boolean : true หากควรทำการติดตั้งใหม่

grantPermissions boolean : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง

extraArgs String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

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

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้
UnsupportedOperationException หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

ติดตั้งPackagesForUser

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกเพิ่มเติมหนึ่งไฟล์) สำหรับผู้ใช้ที่กำหนด ดู "https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีการแบ่ง APK เป็นหลายไฟล์

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

พารามิเตอร์
packageFiles : ไฟล์ apk ในเครื่อง

reinstall boolean : true หากควรทำการติดตั้งใหม่

grantPermissions boolean : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง

userId int : ID ผู้ใช้จำนวนเต็มที่จะติดตั้ง

extraArgs String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

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

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้
UnsupportedOperationException หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

ติดตั้งPackagesForUser

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกเพิ่มเติมหนึ่งไฟล์) สำหรับผู้ใช้ที่กำหนด ดู "https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีการแบ่ง APK เป็นหลายไฟล์

พารามิเตอร์
packageFiles : ไฟล์ apk ในเครื่อง

reinstall boolean : true หากควรทำการติดตั้งใหม่

userId int : ID ผู้ใช้จำนวนเต็มที่จะติดตั้ง

extraArgs String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

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

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้
UnsupportedOperationException หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

ติดตั้ง RemotePackages

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ที่วางอยู่บนอุปกรณ์ Android ดู "https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีการแบ่ง APK เป็นหลายไฟล์

พารามิเตอร์
remoteApkPaths : เส้นทางไฟล์ APK ระยะไกล

reinstall boolean : true หากควรทำการติดตั้งใหม่

extraArgs String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

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

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้
UnsupportedOperationException หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

ติดตั้ง RemotePackages

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ที่วางอยู่บนอุปกรณ์ Android ดู "https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีการแบ่ง APK เป็นหลายไฟล์

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

พารามิเตอร์
remoteApkPaths : เส้นทางไฟล์ APK ระยะไกล

reinstall boolean : true หากควรทำการติดตั้งใหม่

grantPermissions boolean : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง

extraArgs String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี

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

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้
UnsupportedOperationException หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

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

public abstract boolean isMultiUserSupported ()

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

การส่งคืน
boolean จริงหากรองรับผู้ใช้หลายคน มิฉะนั้นจะเป็นเท็จ

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

isPackageInstalled แล้ว

public abstract boolean isPackageInstalled (String packageName)

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

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

การส่งคืน
boolean เป็นจริงหากแพ็กเกจถูกรายงานว่าติดตั้งแล้ว เท็จเป็นอย่างอื่น

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

isPackageInstalled แล้ว

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

พารามิเตอร์
packageName String : แพ็คเกจที่เรากำลังตรวจสอบว่าติดตั้งแล้วหรือไม่

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

การส่งคืน
boolean เป็นจริงหากแพ็กเกจถูกรายงานว่าติดตั้งแล้ว เท็จเป็นอย่างอื่น

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

isUserRunning

public abstract boolean isUserRunning (int userId)

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

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

การส่งคืน
boolean เป็นจริงหากผู้ใช้กำลังทำงานอยู่ จะเป็นเท็จในทุกกรณี

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

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

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

การส่งคืน
boolean จริงหากผู้ใช้เป็นผู้ใช้รอง มิฉะนั้นจะเป็นเท็จ

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

isUserVisible

public abstract boolean isUserVisible (int userId)

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

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

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

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

displayId int

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

รองรับ isVisibleBackgroundUsers

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

การส่งคืน
boolean

ขว้าง
DeviceNotAvailableException

เปิดใช้งาน Wifi แล้ว

public abstract boolean isWifiEnabled ()

ทดสอบว่าเปิดใช้งาน wifi หรือไม่

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

การส่งคืน
boolean true หากเปิดใช้งาน wifi false หากปิดใช้งาน

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

listDisplayIds

public abstract  listDisplayIds ()

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

การส่งคืน
รายการจอแสดงผล ค่าเริ่มต้นจะส่งคืนการแสดงผลเริ่มต้น 0 เสมอ

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

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

การส่งคืน

ขว้าง
DeviceNotAvailableException

รายชื่อผู้ใช้

public abstract  listUsers ()

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

การส่งคืน
รายการรหัสผู้ใช้

ขว้าง
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

บันทึกรายงานข้อบกพร่อง

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

พารามิเตอร์
dataName String : ชื่อที่จะใช้รายงานรายงานข้อบกพร่อง

listener ITestLogger : ITestLogger เพื่อบันทึกรายงานจุดบกพร่อง

การส่งคืน
boolean เป็นจริงหากการบันทึกสำเร็จ มิฉะนั้นจะเป็นเท็จ

ลงทะเบียนDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

ลงทะเบียน IDeviceActionReceiver สำหรับอุปกรณ์นี้

IDeviceActionReceiver ที่ลงทะเบียนไว้ทั้งหมดจะได้รับแจ้งก่อนการทำงานของอุปกรณ์เริ่มต้นและหลังจากการทำงานของอุปกรณ์สิ้นสุดลง

พารามิเตอร์
deviceActionReceiver IDeviceActionReceiver : IDeviceActionReceiver ซึ่งจะถูกลงทะเบียน

ลบผู้ดูแลระบบ

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

พารามิเตอร์
componentName String : ของผู้ดูแลระบบอุปกรณ์ที่จะลบออก

userId int : ของผู้ใช้ที่ผู้ดูแลระบบอุปกรณ์อาศัยอยู่

การส่งคืน
boolean เป็นจริงหากสำเร็จ มิฉะนั้นจะเป็นเท็จ

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

ลบเจ้าของ

public abstract void removeOwners ()

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

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

ลบผู้ใช้

public abstract boolean removeUser (int userId)

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

พารามิเตอร์
userId int : ของผู้ใช้ที่ต้องการลบ

การส่งคืน
boolean เป็นจริงหากเราลบผู้ใช้ได้สำเร็จ มิฉะนั้นจะเป็นเท็จ

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

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

พารามิเตอร์
componentName String : ของผู้ดูแลอุปกรณ์ให้เป็นเจ้าของอุปกรณ์

userId int : ของผู้ใช้ที่เจ้าของอุปกรณ์อาศัยอยู่

การส่งคืน
boolean เป็นจริงหากสำเร็จ มิฉะนั้นจะเป็นเท็จ

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

ตั้งค่าการตั้งค่า

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

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

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

key String

value String

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

ตั้งค่าการตั้งค่า

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

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

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

namespace String

key String

value String

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

startUser

public abstract boolean startUser (int userId)

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

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

การส่งคืน
boolean เป็นจริงหากผู้ใช้เริ่มต้นในเบื้องหลังได้สำเร็จ

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

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

waitFlag boolean : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มต้นและปลดล็อค

การส่งคืน
boolean เป็นจริงหากผู้ใช้เริ่มต้นในเบื้องหลังได้สำเร็จ

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

startVisibleBackgroundUser

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

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

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

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

displayId int : แสดงเพื่อเริ่มมองเห็นผู้ใช้

waitFlag boolean : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มต้นและปลดล็อค

การส่งคืน
boolean true หากผู้ใช้เริ่มมองเห็นได้สำเร็จในเบื้องหลัง

ขว้าง
DeviceNotAvailableException

ผู้ใช้หยุด

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

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

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

waitFlag boolean : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะถูกหยุด

forceFlag boolean : จะบังคับให้ผู้ใช้หยุด

การส่งคืน
boolean เป็นจริงหากผู้ใช้ถูกหยุดสำเร็จ

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

ผู้ใช้หยุด

public abstract boolean stopUser (int userId)

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

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

การส่งคืน
boolean เป็นจริงหากผู้ใช้ถูกหยุดสำเร็จ

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

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

public abstract boolean switchUser (int userId)

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

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

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

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

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

public abstract boolean switchUser (int userId, 
                long timeout)

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

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

timeout long : เพื่อรอก่อนที่จะส่งคืน false สำหรับผู้ใช้สวิตช์ที่ล้มเหลว

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

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

ใช้ Bugreport

public abstract Bugreport takeBugreport ()

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

การส่งคืน
Bugreport

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

public abstract String uninstallPackage (String packageName)

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

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

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

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้

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

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

userId int : ID ผู้ใช้จำนวนเต็มที่จะถอนการติดตั้ง

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

ขว้าง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายและไม่สามารถกู้คืนได้