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

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

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

เชื่อมต่อกับเครือข่าย Wi-Fi

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

เชื่อมต่อกับเครือข่าย Wi-Fi

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

เชื่อมต่อกับเครือข่าย Wi-Fi

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

เชื่อมต่อกับเครือข่าย Wi-Fi

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)

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

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

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

abstract int createUserNoThrow(String name)

สร้างผู้ใช้ที่มีชื่อที่ระบุและค่าสถานะเริ่มต้นเป็น 0

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

นำ IDeviceActionReceiver ที่ลงทะเบียนออก

abstract void disableKeyguard()

พยายามปิดใช้ Keyguard

abstract boolean disableNetworkMonitor()

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

abstract boolean disconnectFromWifi()

ยกเลิกการเชื่อมต่อจากเครือข่าย Wi-Fi

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

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

abstract DeviceFoldableState getCurrentFoldableState()

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

abstract int getCurrentUser()

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

abstract getFoldableStates()

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

abstract getInstalledPackageNames()

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

abstract String getIpAddress()

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

abstract KeyguardControllerState getKeyguardState()

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

abstract Integer getMainUserId()

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

abstract getMainlineModuleInfo()

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

abstract int getMaxNumberOfRunningUsersSupported()

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

abstract int getMaxNumberOfUsersSupported()

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

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

เลิกใช้เมธอดนี้แล้ว เลิกใช้งาน getPrimaryUser จากบริการ UserManager แล้ว ให้ใช้ ERROR(/android.os.UserManager#getMainUserId()) เพื่อรับผู้ใช้แบบเต็มรายแรก หรือ 0 สำหรับระบบ โปรดทราบว่าสำหรับระบบที่ไม่มีส่วนหัว ผู้ใช้จะไม่ใช่ผู้ใช้แบบเต็ม

abstract InputStreamSource getScreenshot(String format, boolean rescale)

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

abstract InputStreamSource getScreenshot(long displayId)

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

abstract InputStreamSource getScreenshot(String format)

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

abstract InputStreamSource getScreenshot()

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

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

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

abstract String getSetting(String namespace, String key)

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

abstract getUninstallablePackageNames()

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

abstract int getUserFlags(int userId)

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

abstract getUserInfos()

รับแผนที่ของ 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, int userId, String... extraArgs)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

abstract boolean isHeadlessSystemUserMode()

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

abstract boolean isMainUserPermanentAdmin()

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

abstract boolean isMultiUserSupported()

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

abstract boolean isPackageInstalled(String packageName, String userId)

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

abstract boolean isPackageInstalled(String packageName)

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

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

ทดสอบว่าเปิดใช้ Wi-Fi หรือไม่

abstract listDisplayIds()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

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

abstract listUsers()

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

abstract boolean logBugreport(String dataName, ITestLogger listener)

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

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

แจ้งให้อุปกรณ์รอจนกว่า snapuserd จะทำงานเสร็จ

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)

หยุดผู้ใช้ที่ระบุ

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

หยุดผู้ใช้ที่ระบุ

abstract boolean switchUser(int userId)

เปลี่ยนไปใช้ 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 จากอุปกรณ์สำหรับผู้ใช้ที่ระบุ

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

หากคาดการณ์ไว้ ให้รอให้ snapuserd เสร็จสมบูรณ์

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

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

คิกรีเทิร์น
boolean

การขว้าง
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

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

คิกรีเทิร์น
boolean true หากอุปกรณ์เชื่อมต่อกับเครือข่ายที่กำลังทำงานอยู่ false มิเช่นนั้น

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

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

คิกรีเทิร์น
boolean true หากไม่มีกล่องโต้ตอบหรือล้างกล่องโต้ตอบเรียบร้อยแล้ว false หรือไม่เช่นนั้น

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

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

เชื่อมต่อกับเครือข่าย Wi-Fi

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

พารามิเตอร์
wifiSsidToPsk : แผนที่ของ SSID ของ Wi-Fi ไปยังรหัสผ่าน

คิกรีเทิร์น
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

เชื่อมต่อกับเครือข่าย Wi-Fi

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

พารามิเตอร์
wifiSsidToPsk : แผนที่ของ SSID ของ Wi-Fi ไปยังรหัสผ่าน

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

คิกรีเทิร์น
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

เชื่อมต่อกับเครือข่าย Wi-Fi

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

พารามิเตอร์
wifiSsid String: SSID ของ Wi-Fi ที่จะเชื่อมต่อ

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

คิกรีเทิร์น
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ

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

connectToWifiNetwork

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

เชื่อมต่อกับเครือข่าย Wi-Fi

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

พารามิเตอร์
wifiSsid String: SSID ของ Wi-Fi ที่จะเชื่อมต่อ

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

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

คิกรีเทิร์น
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ

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

connectToWifiNetworkIfNeeded

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

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

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

คิกรีเทิร์น
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ

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

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

คิกรีเทิร์น
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ

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

createUser

public abstract int createUser (String name)

สร้างผู้ใช้ที่มีชื่อที่ระบุและค่าสถานะเริ่มต้นเป็น 0

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

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

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

createUser

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

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

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

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

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

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

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

createUser

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

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

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

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

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

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

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

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

createUserNoThrow

public abstract int createUserNoThrow (String name)

สร้างผู้ใช้ที่มีชื่อที่ระบุและค่าสถานะเริ่มต้นเป็น 0

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

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

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

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

นำ IDeviceActionReceiver ที่ลงทะเบียนออก

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

disableKeyguard

public abstract void disableKeyguard ()

พยายามปิดใช้ Keyguard

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

การขว้าง
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

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

คิกรีเทิร์น
boolean true หากปิดใช้การตรวจสอบเรียบร้อยแล้ว false หากไม่สำเร็จ

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

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

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

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

คิกรีเทิร์น
boolean true หากยกเลิกการเชื่อมต่อจากเครือข่าย Wi-Fi สำเร็จ false หากยกเลิกการเชื่อมต่อไม่สำเร็จ

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

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

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

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

devicePath String: เส้นทางในอุปกรณ์ที่จะวางไฟล์การทิ้ง ต้องเป็นตำแหน่งที่ สิทธิ์อนุญาต

คิกรีเทิร์น
File ERROR(/File)ที่มีรายงาน เป็น Null หากเกิดข้อผิดพลาด

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

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

คิกรีเทิร์น
boolean true หากเปิดใช้การตรวจสอบสำเร็จ false หากไม่สำเร็จ

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

getActiveApexes

public abstract  getActiveApexes ()

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

คิกรีเทิร์น
ERROR(/Set) จาก ApexInfo ที่เปิดใช้งานอยู่ในอุปกรณ์

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

getAllSettings

public abstract  getAllSettings (String namespace)

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

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

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

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

getAndroidId

public abstract String getAndroidId (int userId)

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

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

คิกรีเทิร์น
String

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

getAndroidIds

public abstract  getAndroidIds ()

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

คิกรีเทิร์น
แผนที่ของรหัส 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 ()

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

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

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

คิกรีเทิร์น
DeviceFoldableState

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

getCurrentUser

public abstract int getCurrentUser ()

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

คิกรีเทิร์น
int

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

getFoldableStates

public abstract  getFoldableStates ()

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

คิกรีเทิร์น

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

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

getIpAddress

public abstract String getIpAddress ()

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

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

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

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

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

getMainUserId

public abstract Integer getMainUserId ()

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

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

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

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

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

getOptions

public abstract TestDeviceOptions getOptions ()

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

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

เลิกใช้เมธอดนี้แล้ว
เลิกใช้งาน getPrimaryUser จากบริการ UserManager แล้ว ให้ใช้ ERROR(/android.os.UserManager#getMainUserId()) เพื่อรับผู้ใช้แบบเต็มรายแรก หรือ 0 สำหรับระบบ โปรดทราบว่าสำหรับระบบที่ไม่มีส่วนหัว ระบบจะไม่ใช่ผู้ใช้แบบเต็ม

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

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

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

getScreenshot

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

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

TODO: extend the implementations above to support 'format' and 'rescale'

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

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

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

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

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

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

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

getScreenshot

public abstract InputStreamSource getScreenshot ()

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

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

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

getSetting

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

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

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

namespace String

key String

คิกรีเทิร์น
String ค่าที่เชื่อมโยงกับ namespace:key ของผู้ใช้ เป็น Null หากไม่พบ

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

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

key String

คิกรีเทิร์น
String

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

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

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

getUserFlags

public abstract int getUserFlags (int userId)

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

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

คิกรีเทิร์น
int the flags associated with the userId provided if found, -10000 in any other cases.

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

getUserInfos

public abstract  getUserInfos ()

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

คิกรีเทิร์น
รายการออบเจ็กต์ UserInfo

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

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

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

คิกรีเทิร์น
int

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

hasFeature

public abstract boolean hasFeature (String feature)

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

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

คิกรีเทิร์น
boolean เป็นจริงหากพบฟีเจอร์ เป็นเท็จหากไม่พบ

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

installPackage

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

installPackage

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, 
                int userId, 
                String... extraArgs)

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

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

reinstall boolean: true หากควรติดตั้งอีกครั้ง

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

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

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

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

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

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

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

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

installPackageWithIncrementalMode

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

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

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

extraArgs String

userId String

คิกรีเทิร์น
boolean

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

installPackages

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลัก 1 รายการและแพ็กเกจแยกเพิ่มเติม) ดู "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 หลายไฟล์ (แพ็กเกจหลัก 1 รายการและแพ็กเกจแยกเพิ่มเติม) ซึ่งอยู่ในอุปกรณ์ 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, 
                int userId, 
                String... extraArgs)

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

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

reinstall boolean: true หากควรติดตั้งอีกครั้ง

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

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 หลายไฟล์ (แพ็กเกจหลัก 1 รายการและแพ็กเกจแยกเพิ่มเติม) สำหรับผู้ใช้ที่ระบุ ดู "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 String พร้อมรหัสข้อผิดพลาด หรือ null หากสำเร็จ

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

installRemotePackages

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

ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลัก 1 รายการและแพ็กเกจแยกเพิ่มเติม) ซึ่งอยู่ในอุปกรณ์ 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 หากแพลตฟอร์มไม่รองรับสิทธิ์รันไทม์ ในอุปกรณ์

installRemotePackages

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

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

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

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

reinstall boolean: true หากควรติดตั้งอีกครั้ง

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

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

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

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

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

คิกรีเทิร์น
boolean

การขว้าง
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

คิกรีเทิร์น
boolean

การขว้าง
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

คิกรีเทิร์น
boolean จริงหากรองรับผู้ใช้หลายคน เท็จหากไม่รองรับ

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

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

isWifiEnabled

public abstract boolean isWifiEnabled ()

ทดสอบว่าเปิดใช้ Wi-Fi หรือไม่

ตรวจสอบว่าเปิดใช้ Wi-Fi ในอุปกรณ์หรือไม่ มีประโยชน์ในการยืนยันสถานะ Wi-Fi ก่อนการทดสอบที่ไม่ควรเรียกใช้กับ Wi-Fi เช่น การทดสอบอินเทอร์เน็ตมือถือ

คิกรีเทิร์น
boolean true หากเปิดใช้ Wi-Fi false หากปิดใช้

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

listDisplayIds

public abstract  listDisplayIds ()

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

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

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

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

คิกรีเทิร์น

การขว้าง
DeviceNotAvailableException

listUsers

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 เป็นจริงหากการบันทึกสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

แจ้งให้อุปกรณ์รอจนกว่า snapuserd จะทำงานเสร็จ

พารามิเตอร์
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

พารามิเตอร์
deviceActionReceiver IDeviceActionReceiver: IDeviceActionReceiver ที่จะจดทะเบียน

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

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

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

คิกรีเทิร์น
boolean เป็นจริงหากสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ

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

removeOwners

public abstract void removeOwners ()

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

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

removeUser

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

setSetting

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

setSetting

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

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

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

namespace String

key String

value String

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

startUser

public abstract boolean startUser (int userId)

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

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

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

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

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

stopUser

public abstract boolean stopUser (int userId)

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

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

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

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

stopUser

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

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

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

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

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

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

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

switchUser

public abstract boolean switchUser (int userId)

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

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

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

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

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

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

timeout long: เพื่อรอให้การเปลี่ยนผู้ใช้ล้มเหลวก่อนที่จะส่งคืนค่าเป็นเท็จ

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

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

takeBugreport

public abstract Bugreport takeBugreport ()

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

คิกรีเทิร์น
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

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

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

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

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

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

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

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

หากคาดการณ์ไว้ ให้รอให้ snapuserd เสร็จสมบูรณ์

พารามิเตอร์
currentPhase SnapuserdWaitPhase

การขว้าง
DeviceNotAvailableException