ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


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

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

สรุป

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

class ITestDevice.ApexInfo

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

class ITestDevice.MountPointInfo

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

enum ITestDevice.RecoveryMode

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

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)

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

abstract int createUserNoThrow (String name)

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

abstract void disableKeyguard ()

ความพยายามที่จะปิดการใช้งานคีย์การ์ด

abstract boolean disableNetworkMonitor ()

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

abstract boolean disconnectFromWifi ()

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

abstract boolean doesFileExist (String deviceFilePath, int userId)

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

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

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

abstract int getCurrentUser ()

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

abstract getFoldableStates ()

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

abstract getInstalledPackageNames ()

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

abstract String getIpAddress ()

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

abstract KeyguardControllerState getKeyguardState ()

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

abstract getMainlineModuleInfo ()

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

abstract int getMaxNumberOfRunningUsersSupported ()

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

abstract int getMaxNumberOfUsersSupported ()

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

abstract TestDeviceOptions getOptions ()

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

abstract Integer getPrimaryUserId ()

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

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

รับ Map of useId ไปยัง UserInfo บนอุปกรณ์

abstract int getUserSerialNumber (int userId)

ส่งคืนหมายเลขซีเรียลที่เกี่ยวข้องกับ 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, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

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

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

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

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

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

abstract listDisplayIds ()

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

abstract listUsers ()

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

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 stopUser (int userId, boolean waitFlag, boolean forceFlag)

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

abstract boolean stopUser (int userId)

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

abstract boolean switchUser (int userId)

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

abstract boolean switchUser (int userId, long timeout)

เปลี่ยนไปใช้ userId อื่นโดยมีระยะหมดเวลาที่ระบุเป็นกำหนดเวลา

abstract String uninstallPackage (String packageName)

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

abstract String uninstallPackageForUser (String packageName, int userId)

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

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

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

public abstract boolean checkConnectivity ()

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

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

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

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

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

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

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

เชื่อมต่อกับWifiNetwork

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

เชื่อมต่อกับWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

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

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

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

เชื่อมต่อกับWifiNetwork

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

เชื่อมต่อกับWifiNetwork

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

connectToWifiNetworkIfNeeded

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

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

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

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

ขว้าง
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

ขว้าง
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

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

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

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

ขว้าง
DeviceNotAvailableException

createUser

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

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

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

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

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

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

ขว้าง
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

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

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

ขว้าง
DeviceNotAvailableException

ปิดการใช้งาน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)

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

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

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

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

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

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

พารามิเตอร์
process String : ชื่อของกระบวนการของอุปกรณ์ที่จะถ่ายโอนข้อมูล

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

คืนสินค้า
File ERROR(/File) ที่มีรายงาน Null ถ้าบางสิ่งบางอย่างล้มเหลว

ขว้าง
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

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

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

getActiveApexes

public abstract  getActiveApexes ()

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

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

ขว้าง
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

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

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

ขว้าง
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

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

คืนสินค้า
String

ขว้าง
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

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

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

ขว้าง
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

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

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

ขว้าง
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

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

ขว้าง
DeviceNotAvailableException

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

คืนสินค้า
DeviceFoldableState

ขว้าง
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

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

คืนสินค้า
int

ขว้าง
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

คืนสินค้า

ขว้าง
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

ขว้าง
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

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

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

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

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

ขว้าง
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

ขว้าง
DeviceNotAvailableException

getMaxNumberOfUsers รองรับ

public abstract int getMaxNumberOfUsersSupported ()

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

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

ขว้าง
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

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

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

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

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

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

public abstract InputStreamSource getScreenshot ()

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

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

ขว้าง
DeviceNotAvailableException

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

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

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

ขว้าง
DeviceNotAvailableException

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

public abstract InputStreamSource getScreenshot (String format)

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

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

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

ขว้าง
DeviceNotAvailableException

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

public abstract InputStreamSource getScreenshot (long displayId)

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

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

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

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

ขว้าง
DeviceNotAvailableException

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

public abstract String getSetting (String namespace, 
                String key)

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

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

key String

คืนสินค้า
String

ขว้าง
DeviceNotAvailableException

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

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

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

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

namespace String

key String

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

ขว้าง
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

ขว้าง
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

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

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

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

ขว้าง
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

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

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

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

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

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

คืนสินค้า
int

ขว้าง
DeviceNotAvailableException

มีคุณสมบัติ

public abstract boolean hasFeature (String feature)

ตรวจสอบว่ามีคุณลักษณะนี้อยู่ในอุปกรณ์หรือไม่

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

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

ขว้าง
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 หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

installPackageForUser

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 หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

installPackageForUser

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

installPackages

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 หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

installPackages

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 หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

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

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

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

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

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

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

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

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

installRemotePackages

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 หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

installRemotePackages

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 หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

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

ขว้าง
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

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

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

ขว้าง
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

ขว้าง
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

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

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

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

ขว้าง
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

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

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

ขว้าง
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

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

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

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

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

listDisplayIds

public abstract  listDisplayIds ()

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

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

ขว้าง
DeviceNotAvailableException

รายการผู้ใช้

public abstract  listUsers ()

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

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

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

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

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

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

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

คืนสินค้า
boolean จริงถ้ามันสำเร็จเท็จอย่างอื่น

ขว้าง
DeviceNotAvailableException

ลบเจ้าของ

public abstract void removeOwners ()

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

ขว้าง
DeviceNotAvailableException

ลบUser

public abstract boolean removeUser (int userId)

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

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

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

ขว้าง
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

คืนสินค้า
boolean จริงถ้ามันสำเร็จเท็จอย่างอื่น

ขว้าง
DeviceNotAvailableException

setSetting

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

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

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

key String

value String

ขว้าง
DeviceNotAvailableException

setSetting

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

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

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

namespace String

key String

value String

ขว้าง
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

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

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

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

ขว้าง
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

ขว้าง
DeviceNotAvailableException

หยุดผู้ใช้

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

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

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

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

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

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

ขว้าง
DeviceNotAvailableException

หยุดผู้ใช้

public abstract boolean stopUser (int userId)

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

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

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

ขว้าง
DeviceNotAvailableException

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

public abstract boolean switchUser (int userId)

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

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

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

ขว้าง
DeviceNotAvailableException

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

public abstract boolean switchUser (int userId, 
                long timeout)

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

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

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

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

ขว้าง
DeviceNotAvailableException

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

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