ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


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

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

สรุป

ชั้นเรียนที่ซ้อนกัน

class ITestDevice.ApexInfo

คลาสสตริงท์แบบง่ายสำหรับจัดเก็บข้อมูลเกี่ยวกับ APEX รายการเดียว 

class ITestDevice.MountPointInfo

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

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

abstract boolean canSwitchToHeadlessSystemUser()

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

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)

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

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

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

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

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

abstract int createUserNoThrow(String name)

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

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

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

abstract void disableKeyguard()

พยายามปิดใช้การป้องกันจากการกดแป้นพิมพ์

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 หรือแสดงผลเป็นค่าว่างหากอุปกรณ์ไม่รองรับ

abstract Integer getMainUserId()

แสดงผล User-ID หลัก

abstract getMainlineModuleInfo()

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

abstract int getMaxNumberOfRunningUsersSupported()

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

abstract int getMaxNumberOfUsersSupported()

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

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

แสดงผล User-ID หลัก

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 ในอุปกรณ์สำหรับผู้ใช้รายหนึ่งๆ

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)

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

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)

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

abstract boolean switchUser(int userId, long timeout)

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

abstract Bugreport takeBugreport()

รับรายงานข้อบกพร่องและแสดงผลภายในออบเจ็กต์ Bugreport เพื่อจัดการ

abstract String uninstallPackage(String packageName)

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

abstract String uninstallPackageForUser(String packageName, int userId)

ถอนการติดตั้งแพ็กเกจ Android จากอุปกรณ์ของผู้ใช้รายหนึ่ง

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

โปรดรอให้ snapuserd ทำงานเสร็จสิ้น หากต้องการ

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

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

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

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

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

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

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

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

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 หรือค่าว่างหากไม่มีการเข้ารหัส

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

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

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)

สร้างผู้ใช้ที่มีชื่อที่ระบุและ Flag เริ่มต้น 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: เปิดใช้ Flag ผู้ใช้ --guest ระหว่างการสร้าง

ephemeral boolean: เปิดใช้ Flag ของผู้ใช้ --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: เปิดใช้ Flag ผู้ใช้ --guest ระหว่างการสร้าง

ephemeral boolean: เปิดใช้ Flag ของผู้ใช้ --ephemeral ระหว่างการสร้าง

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

คิกรีเทิร์น
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 ()

พยายามปิดใช้การป้องกันจากการกดแป้นพิมพ์

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

การขว้าง
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

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

คิกรีเทิร์น
boolean true หากปิดใช้การตรวจสอบเรียบร้อยแล้ว false if it failed.

การขว้าง
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: ชื่อกระบวนการของอุปกรณ์ที่จะถ่ายโอนข้อมูล

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

คิกรีเทิร์น
File ERROR(/File) ที่มีรายงาน Null หากการดำเนินการไม่สำเร็จ

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

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

คิกรีเทิร์น
boolean trueหากเปิดใช้การตรวจสอบเรียบร้อยแล้ว false if it failed.

การขว้าง
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

รับรหัส Android

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

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

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

คิกรีเทิร์น
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 หรือแสดงผลเป็นค่าว่างหากอุปกรณ์ไม่รองรับ

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

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

getMainUserId

public abstract Integer getMainUserId ()

แสดงผล User-ID หลัก

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

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

โยน
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 ()

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

คิกรีเทิร์น
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: ขยายการใช้งานด้านบนเพื่อรองรับ "format" และ "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)

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

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

namespace String

key String

คิกรีเทิร์น
String ค่าที่เชื่อมโยงกับเนมสเปซ:คีย์ของผู้ใช้ 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)

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

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

คิกรีเทิร์น
int ค่าสถานะที่เชื่อมโยงกับ UserId ที่ระบุ หากพบ คือ -10000 ในกรณีอื่นๆ

โยน
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

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

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

โยน
com.android.tradefed.device.DeviceNotavailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

แสดงผลหมายเลขซีเรียลที่เชื่อมโยงกับ 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 ในอุปกรณ์

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

พารามิเตอร์
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 ในอุปกรณ์สำหรับผู้ใช้ที่กำหนด

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

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

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

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

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

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

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

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

installPackages

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

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

พารามิเตอร์
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 ดูวิธีแยก APK ไปยังหลายไฟล์ได้ที่ "https://developer.android.com/studio/build/configure-apk-splits"

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

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

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

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

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

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

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

ติดตั้งแพ็กเกจสำหรับผู้ใช้

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

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

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

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

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

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

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

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

ติดตั้งแพ็กเกจสำหรับผู้ใช้

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

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

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

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

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

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

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

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

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

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

ติดตั้ง RemotePackages

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

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

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

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

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

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

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

ติดตั้ง RemotePackages

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

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

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

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

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

public abstract boolean isPackageInstalled (String packageName)

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

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

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

โยน
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ผู้ใช้กำลังทำงาน

public abstract boolean isUserRunning (int userId)

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

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

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

โยน
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

เป็นผู้ใช้รอง

public abstract boolean isUserSecondary (int userId)

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

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

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

โยน
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

คิกรีเทิร์น

โยน
DeviceNotAvailableException

แสดงรายการผู้ใช้

public abstract  listUsers ()

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

คิกรีเทิร์น
รายการรหัสผู้ใช้

โยน
com.android.tradefed.device.DeviceNotavailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

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

นำผู้ใช้ออก

public abstract boolean removeUser (int userId)

นำผู้ใช้ออกจากอุปกรณ์

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

คิกรีเทิร์น
boolean true หากเรานำผู้ใช้ออกจากระบบสำเร็จ มิฉะนั้นจะเป็นเท็จ

โยน
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ตั้งค่าอุปกรณ์เจ้าของ

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

คิกรีเทิร์น
boolean จริง หากสำเร็จ หรือเป็นเท็จ

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

การตั้งค่า

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

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

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

key String

value String

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

setSetting

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

เพิ่มค่าการตั้งค่าลงในเนมสเปซของผู้ใช้รายหนึ่งๆ การตั้งค่าบางอย่างจะใช้ได้หลังจากรีบูตเท่านั้น Namespace ต้องเป็น {"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)

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

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

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

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

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

startVisibleBackgroundUser

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

เริ่มผู้ใช้ที่ระบุในเบื้องหลัง ซึ่งจะปรากฏในจอแสดงผลที่ระบุ (กล่าวคือ อนุญาตให้ผู้ใช้เปิดกิจกรรมในจอแสดงผลนั้น)

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

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

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

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

คิกรีเทิร์น
boolean true หากเริ่มแสดงผู้ใช้ในเบื้องหลังเรียบร้อยแล้ว

การขว้าง
DeviceNotAvailableException

ผู้ใช้

public abstract boolean stopUser (int userId)

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

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

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

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

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

โยน
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

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