ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

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

สรุป

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

class ITestDevice.ApexInfo

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

class ITestDevice.MountPointInfo

คลาส struct อย่างง่ายเพื่อเก็บข้อมูลเกี่ยวกับจุดเมานต์เดียว

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

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 หากไม่พบจะเป็น null

abstract getAndroidIds ()

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

abstract PackageInfo getAppPackageInfo (String packageName)

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

abstract getAppPackageInfos ()

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

abstract InputStreamSource getBugreport ()

ดึงรายงานข้อผิดพลาดจากอุปกรณ์

abstract InputStreamSource getBugreportz ()

ดึงรายงานข้อผิดพลาดจากอุปกรณ์

abstract DeviceFoldableState getCurrentFoldableState ()

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

abstract int getCurrentUser ()

ส่งคืน id ของผู้ใช้ที่กำลังทำงานอยู่

abstract getFoldableStates ()

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

abstract getInstalledPackageNames ()

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

abstract String getIpAddress ()

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

abstract KeyguardControllerState getKeyguardState ()

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

abstract Integer getMainUserId ()

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

abstract getMainlineModuleInfo ()

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

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)

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

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)

ส่งคืนหมายเลขซีเรียลที่เกี่ยวข้องกับ userId หากพบ -10,000 ในกรณีอื่นๆ

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

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

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

รวบรวมรายชื่อ display id ที่มีอยู่บนอุปกรณ์ตามที่รายงานโดย "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)

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

abstract Bugreport takeBugreport ()

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

abstract String uninstallPackage (String packageName)

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

abstract String uninstallPackageForUser (String packageName, int userId)

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

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

สามารถสลับเป็น HeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

ส่งคืน
boolean

พ่น
DeviceNotAvailableException

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

public abstract boolean checkConnectivity ()

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

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

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

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

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

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

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiเครือข่าย

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

พารามิเตอร์
wifiSsidToPsk : แผนที่ของ wifi SSIDs กับรหัสผ่าน

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

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

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

connectToWifiเครือข่าย

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

พารามิเตอร์
wifiSsidToPsk : แผนที่ของ wifi SSIDs กับรหัสผ่าน

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

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

connectToWifiเครือข่าย

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

connectToWifiเครือข่าย

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

connectToWifiNetworkถ้าจำเป็น

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

connectToWifiNetworkถ้าจำเป็น

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

สร้างผู้ใช้

public abstract int createUser (String name)

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

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

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

สร้างผู้ใช้

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

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

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

guest boolean : เปิดใช้งานแฟล็กผู้ใช้ --guest ระหว่างการสร้าง

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

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

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

สร้างผู้ใช้

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

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

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

guest boolean : เปิดใช้งานแฟล็กผู้ใช้ --guest ระหว่างการสร้าง

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

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

สร้าง UserNoThrow

public abstract int createUserNoThrow (String name)

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

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

ส่งคืน
int จำนวนเต็มสำหรับ ID ผู้ใช้ที่สร้างขึ้นหรือ -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 หากการเชื่อมต่อกับอุปกรณ์ขาดหายและไม่สามารถกู้คืนได้

มีไฟล์อยู่

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

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

กองขยะ

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

รับรหัส Android

public abstract String getAndroidId (int userId)

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

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

getBugreport

public abstract InputStreamSource getBugreport ()

ดึงรายงานข้อผิดพลาดจากอุปกรณ์

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

รองรับเฉพาะ 'adb version' > 1.0.36

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

ส่งคืน
DeviceFoldableState

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

รับผู้ใช้ปัจจุบัน

public abstract int getCurrentUser ()

ส่งคืน id ของผู้ใช้ที่กำลังทำงานอยู่ ในกรณีที่เกิดข้อผิดพลาด ให้ส่งคืน -10,000

ส่งคืน
int

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

ส่งคืน

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

รับติดตั้งชื่อแพ็คเกจ

public abstract  getInstalledPackageNames ()

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

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

รับที่อยู่ IP

public abstract String getIpAddress ()

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

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

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

รับ KeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

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

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

public abstract Integer getMainUserId ()

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

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

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

รับMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsers รองรับ

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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

public abstract int getMaxNumberOfUsersSupported ()

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

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

รับตัวเลือก

public abstract TestDeviceOptions getOptions ()

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

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

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

public abstract Integer getPrimaryUserId ()

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

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

พ่น
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(รูปแบบ) แทนการเข้ารหัส JPEG สำหรับขนาดที่เล็กลง

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

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

รับสกรีนช็อต

public abstract InputStreamSource getScreenshot (long displayId)

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

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

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

ส่งคืน
int แฟล็กที่เกี่ยวข้องกับ userId ที่ระบุหากพบ -10,000 ในกรณีอื่นๆ

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

รับข้อมูลผู้ใช้

public abstract  getUserInfos ()

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

ส่งคืน
รายการวัตถุ UserInfo

พ่น
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

รับ UserSerialNumber

public abstract int getUserSerialNumber (int userId)

ส่งคืนหมายเลขซีเรียลที่เกี่ยวข้องกับ userId หากพบ -10,000 ในกรณีอื่นๆ

พารามิเตอร์
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 ERROR(/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 ERROR(/String) พร้อมรหัสข้อผิดพลาด หรือ null หากสำเร็จ

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

ติดตั้ง 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 : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง

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

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

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

ติดตั้ง PackageForUser

public abstract 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 ERROR(/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 ERROR(/String) พร้อมรหัสข้อผิดพลาด หรือ null หากสำเร็จ

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

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

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 ERROR(/String) พร้อมรหัสข้อผิดพลาด หรือ null หากสำเร็จ

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

installPackagesForUser

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 : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง

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

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

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

installPackagesForUser

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 : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง

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

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

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

ติดตั้งแพ็คเกจระยะไกล

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 ERROR(/String) พร้อมรหัสข้อผิดพลาด หรือ null หากสำเร็จ

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

ติดตั้งแพ็คเกจระยะไกล

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 ERROR(/String) พร้อมรหัสข้อผิดพลาด หรือ null หากสำเร็จ

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

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

ส่งคืน
boolean

พ่น
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

ส่งคืน
boolean

พ่น
DeviceNotAvailableException

รองรับ MultiUser

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

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

ส่งคืน
boolean

พ่น
DeviceNotAvailableException

isWifiเปิดใช้งาน

public abstract boolean isWifiEnabled ()

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

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

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

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

รายการรหัสที่แสดง

public abstract  listDisplayIds ()

รวบรวมรายชื่อ display id ที่มีอยู่บนอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger"

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsFor StartingVisibleBackgroundUsers

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

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

listener ITestLogger : ITestLogger เพื่อบันทึกรายงานข้อบกพร่อง

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

registerDeviceActionReceiver

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

ผู้ใช้เริ่มต้น

public abstract boolean startUser (int userId)

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

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

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ผู้ใช้เริ่มต้น

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

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

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

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

พ่น
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

TakeBugreport

public abstract Bugreport takeBugreport ()

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

ส่งคืน
Bugreport

ถอนการติดตั้งแพ็คเกจ

public abstract String uninstallPackage (String packageName)

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

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

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

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

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

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

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

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