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)

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

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

abstract Integer getMainUserId()

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

abstract getMainlineModuleInfo()

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

abstract int getMaxNumberOfRunningUsersSupported()

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

abstract int getMaxNumberOfUsersSupported()

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

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

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

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

connectToWifiNetworkIfNeeded

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

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

พารามิเตอร์
scanSsid boolean: กำหนดว่าจะสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่
คิกรีเทิร์น
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false otherwise
การโยน
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

คิกรีเทิร์น
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false otherwise
การโยน
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: เปิดใช้ Flag การทดสอบ --for-testing ระหว่างการสร้าง
คิกรีเทิร์น
int รหัสของผู้ใช้ที่สร้าง
การโยน
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

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

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

คิกรีเทิร์น
boolean true หากยกเลิกการเชื่อมต่อจากเครือข่าย Wi-Fi เรียบร้อยแล้ว false if disconnect failed.
การโยน
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: ชื่อกระบวนการของอุปกรณ์ที่จะแสดงผล heap
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 ()

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

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

รองรับเฉพาะ "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 ของผู้ใช้หลัก หากมี และค่าว่างหากไม่มีผู้ใช้หลัก
การโยน
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 ()

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

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

คิกรีเทิร์น
Integer userId ของผู้ใช้หลัก หากมี และค่าว่างหากไม่มีผู้ใช้หลัก
การโยน
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 ค่าที่เชื่อมโยงกับ 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)

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

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

คิกรีเทิร์น
int Flag ที่เชื่อมโยงกับรหัสผู้ใช้ที่ระบุ หากพบ -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 หากแพลตฟอร์มในอุปกรณ์ไม่รองรับสิทธิ์รันไทม์

installPackagesForUser

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

installPackagesForUser

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

installRemotePackages

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

installRemotePackages

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

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)

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

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)

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

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)

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

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