ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

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

สรุป

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

class ITestDevice.ApexInfo

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

class ITestDevice.MountPointInfo

คลาส Struct อย่างง่ายสำหรับจัดเก็บข้อมูลเกี่ยวกับจุดติดตั้งเพียงจุดเดียว 

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

abstract String adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)

ติดตั้งแพ็กเกจ Android ในอุปกรณ์ด้วยคำสั่ง adb

abstract String adbInstallPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

ติดตั้งแพ็กเกจ Android ในอุปกรณ์ด้วยคำสั่ง adb

abstract boolean canSwitchToHeadlessSystemUser()

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

abstract boolean checkConnectivity()

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

abstract boolean clearErrorDialogs()

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

abstract void clearLastConnectedWifiNetwork()

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

default boolean connectToWifiNetwork(Map<String, String> wifiSsidToPsk, boolean scanSsid)

เลิกใช้เมธอดนี้แล้ว โปรดใช้ connectToWifiNetworkWithResult(Map,boolean) แทน

default boolean connectToWifiNetwork(Map<String, String> wifiSsidToPsk)

เลิกใช้เมธอดนี้แล้ว โปรดใช้ connectToWifiNetworkWithResult(Map) แทน

default boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

เลิกใช้เมธอดนี้แล้ว โปรดใช้ connectToWifiNetworkWithResult(String,String) แทน

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

เลิกใช้เมธอดนี้แล้ว โปรดใช้ connectToWifiNetworkWithResult(String,String,boolean) แทน

default boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)

เลิกใช้เมธอดนี้แล้ว ให้ใช้ connectToWifiNetworkIfNeededWithResult(String,String,boolean) แทน

default boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

เลิกใช้เมธอดนี้แล้ว โปรดใช้ connectToWifiNetworkIfNeededWithResult(String,String) แทน

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk, boolean scanSsid)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk)

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

abstract int createUser(String name)

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

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

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

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

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

abstract int createUserNoThrow(String name)

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

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

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

abstract void disableKeyguard()

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

abstract boolean disableNetworkMonitor()

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

abstract boolean disconnectFromWifi()

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

abstract boolean doesFileExist(String deviceFilePath, int userId)

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

abstract File dumpHeap(String process, String devicePath)

พยายามดัมพ์ฮีปจาก system_server

abstract boolean enableNetworkMonitor()

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

abstract Set<ITestDevice.ApexInfo> getActiveApexes()

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

abstract Map<String, String> getAllSettings(String namespace)

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

abstract String getAndroidId(int userId)

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

abstract Map<Integer, String> getAndroidIds()

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

abstract PackageInfo getAppPackageInfo(String packageName)

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

abstract List<PackageInfo> getAppPackageInfos()

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

abstract InputStreamSource getBugreport()

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

abstract InputStreamSource getBugreportz()

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

abstract DeviceFoldableState getCurrentFoldableState()

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

abstract int getCurrentUser()

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

abstract Set<DeviceFoldableState> getFoldableStates()

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

abstract Set<String> getInstalledPackageNames()

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

abstract String getIpAddress()

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

abstract KeyguardControllerState getKeyguardState()

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

abstract Integer getMainUserId()

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

abstract Set<String> getMainlineModuleInfo()

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

abstract int getMaxNumberOfRunningUsersSupported()

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

abstract int getMaxNumberOfUsersSupported(String userType)

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

abstract int getMaxNumberOfUsersSupported()

เลิกใช้เมธอดนี้แล้ว ใช้ getMaxNumberOfUsersSupported(String userType) เพื่อรับจำนวนผู้ใช้สูงสุดที่ระบบรองรับสำหรับประเภทผู้ใช้ที่ระบุ

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

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

abstract int getRemainingCreatableUserCount(String userType)

แสดงจำนวนผู้ใช้ประเภทผู้ใช้ที่ระบุซึ่งสร้างในอุปกรณ์นี้ได้

abstract InputStreamSource getScreenshot(Long displayId, String format, boolean rescale)

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

abstract InputStreamSource getScreenshot(String format, boolean rescale)

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

abstract InputStreamSource getScreenshot(String format)

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

abstract InputStreamSource getScreenshot(long displayId)

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

abstract InputStreamSource getScreenshot()

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

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

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

abstract String getSetting(String namespace, String key)

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

abstract Set<String> getUninstallablePackageNames()

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

abstract int getUserFlags(int userId)

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

abstract Map<Integer, UserInfo> getUserInfos()

รับแผนที่ของ useId ไปยัง UserInfo ในอุปกรณ์

abstract int getUserSerialNumber(int userId)

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

abstract int getUserVisibleOnDisplay(int displayId)

รับรหัสผู้ใช้ของผู้ใช้ที่มองเห็นได้บนจอแสดงผลที่ระบุ

abstract boolean hasFeature(String feature)

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

abstract String installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

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

abstract String installPackage(File packageFile, boolean reinstall, String... extraArgs)

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

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

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

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

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

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

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

default String installPackages(List<File> packageFiles, boolean reinstall, String... extraArgs)

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

default String installPackages(List<File> packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

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

default String installPackagesForUser(List<File> packageFiles, boolean reinstall, int userId, String... extraArgs)

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

default String installPackagesForUser(List<File> packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

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

abstract boolean isHeadlessSystemUserMode()

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

abstract boolean isMainUserPermanentAdmin()

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

abstract boolean isMultiUserSupported()

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

abstract boolean isPackageInstalled(String packageName, String userId)

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

abstract boolean isPackageInstalled(String packageName)

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

abstract boolean isUserRunning(int userId)

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

abstract boolean isUserSecondary(int userId)

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

abstract boolean isUserVisible(int userId)

ตรวจสอบว่าผู้ใช้ที่ระบุปรากฏหรือไม่

abstract boolean isUserVisibleOnDisplay(int userId, int displayId)

ตรวจสอบว่าผู้ใช้ที่ระบุปรากฏในจอแสดงผลที่ระบุหรือไม่

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

แสดงว่าอุปกรณ์อนุญาตให้ผู้ใช้เริ่มแสดงในเบื้องหลังใน ERROR(/java.android.view.Display#DEFAULT_DISPLAY) หรือไม่

abstract boolean isVisibleBackgroundUsersSupported()

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

abstract boolean isWifiEnabled()

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

abstract Set<Long> listDisplayIds()

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

abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers()

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

abstract ArrayList<Integer> listUsers()

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

abstract boolean logBugreport(String dataName, ITestLogger listener)

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

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

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

abstract void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

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

abstract boolean removeAdmin(String componentName, int userId)

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

abstract void removeOwners()

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

abstract boolean removeUser(int userId)

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

abstract boolean setDeviceOwner(String componentName, int userId)

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

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

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

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

เพิ่มค่าการตั้งค่าลงในเนมสเปซของผู้ใช้ที่ต้องการ

abstract boolean startUser(int userId)

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

abstract boolean startUser(int userId, boolean waitFlag)

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

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

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

abstract boolean stopUser(int userId)

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

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

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

abstract boolean switchUser(int userId)

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

abstract boolean switchUser(int userId, long timeout)

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

abstract Bugreport takeBugreport()

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

abstract String uninstallPackage(String packageName)

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

abstract String uninstallPackageForUser(String packageName, int userId)

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

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

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

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

adbInstallPackage

public abstract String adbInstallPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

ติดตั้งแพ็กเกจ Android ในอุปกรณ์ด้วยคำสั่ง adb

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

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

adbInstallPackage

public abstract String adbInstallPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

ติดตั้งแพ็กเกจ Android ในอุปกรณ์ด้วยคำสั่ง adb

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

พารามิเตอร์
packageFile File: ไฟล์ APK ที่จะติดตั้ง
reinstall boolean: true หากควรติดตั้งอีกครั้ง
grantPermissions boolean: หากควรมอบสิทธิ์รันไทม์ทั้งหมด ณ เวลาที่ติดตั้ง
extraArgs String: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm -h"

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

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

การคืนสินค้า
boolean

ส่ง
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

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

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

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

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

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

เลิกใช้เมธอดนี้แล้ว
โปรดใช้ connectToWifiNetworkWithResult(Map,boolean) แทน

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

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

พารามิเตอร์
wifiSsidToPsk Map: แผนที่ของ SSID ของ Wi-Fi ไปยังรหัสผ่าน
scanSsid boolean: จะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่
การคืนสินค้า
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ
ส่ง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

connectToWifiNetwork

public boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk)

เลิกใช้เมธอดนี้แล้ว
โปรดใช้ connectToWifiNetworkWithResult(Map) แทน

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

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

พารามิเตอร์
wifiSsidToPsk Map: แผนที่ของ SSID ของ Wi-Fi ไปยังรหัสผ่าน
การคืนสินค้า
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ
ส่ง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

เลิกใช้เมธอดนี้แล้ว
โปรดใช้ connectToWifiNetworkWithResult(String,String) แทน

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

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

พารามิเตอร์
wifiSsid String: SSID ของ Wi-Fi ที่จะเชื่อมต่อ
wifiPsk String: วลีรหัส PSK หรือ null หากไม่ได้เข้ารหัส
การคืนสินค้า
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ
ส่ง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

connectToWifiNetwork

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

เลิกใช้เมธอดนี้แล้ว
โปรดใช้ connectToWifiNetworkWithResult(String,String,boolean) แทน

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

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

พารามิเตอร์
wifiSsid String: SSID ของ Wi-Fi ที่จะเชื่อมต่อ
wifiPsk String: วลีรหัส PSK หรือ null หากไม่ได้เข้ารหัส
scanSsid boolean: ระบุว่าจะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่
การคืนสินค้า
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ
ส่ง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

connectToWifiNetworkIfNeeded

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

เลิกใช้เมธอดนี้แล้ว
โปรดใช้ connectToWifiNetworkIfNeededWithResult(String,String,boolean) แทน

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

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

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

เลิกใช้เมธอดนี้แล้ว
โปรดใช้ connectToWifiNetworkIfNeededWithResult(String,String) แทน

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

การคืนสินค้า
boolean true หากเชื่อมต่อเครือข่าย Wi-Fi สำเร็จ false หรือ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeededWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

พารามิเตอร์
scanSsid boolean: ระบุว่าจะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่
การคืนสินค้า
IWifiHelper.WifiConnectionResult WifiConnectionResult ซึ่งระบุสถานะของการเชื่อมต่อ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeededWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk)

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

การคืนสินค้า
IWifiHelper.WifiConnectionResult WifiConnectionResult ซึ่งระบุสถานะของการเชื่อมต่อ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (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 ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่
การคืนสินค้า
IWifiHelper.WifiConnectionResult WifiConnectionResult ซึ่งระบุสถานะของการเชื่อมต่อ
ส่ง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk)

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

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

พารามิเตอร์
wifiSsidToPsk Map: แผนที่ของ SSID ของ Wi-Fi ไปยังรหัสผ่าน
การคืนสินค้า
IWifiHelper.WifiConnectionResult WifiConnectionResult ซึ่งระบุสถานะของการเชื่อมต่อ
ส่ง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

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

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

พารามิเตอร์
wifiSsidToPsk Map: แผนที่ของ SSID ของ Wi-Fi ไปยังรหัสผ่าน
scanSsid boolean: จะสแกนหา SSID ที่ซ่อนไว้สำหรับเครือข่ายนี้หรือไม่
การคืนสินค้า
IWifiHelper.WifiConnectionResult WifiConnectionResult ซึ่งระบุสถานะของการเชื่อมต่อ
ส่ง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk)

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

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

พารามิเตอร์
wifiSsid String: SSID ของ Wi-Fi ที่จะเชื่อมต่อ
wifiPsk String: วลีรหัส PSK หรือ null หากไม่ได้เข้ารหัส
การคืนสินค้า
IWifiHelper.WifiConnectionResult WifiConnectionResult ซึ่งระบุสถานะของการเชื่อมต่อ
ส่ง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

createUser

public abstract int createUser (String name)

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

พารามิเตอร์
name String: ของผู้ใช้เพื่อสร้างในอุปกรณ์
การคืนสินค้า
int จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้น
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException
IllegalStateException

createUser

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

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

พารามิเตอร์
name String: ของผู้ใช้เพื่อสร้างในอุปกรณ์
guest boolean: เปิดใช้ค่าสถานะผู้ใช้ --guest ในระหว่างการสร้าง
ephemeral boolean: เปิดใช้แฟล็กผู้ใช้ --ephemeral ระหว่างการสร้าง
การคืนสินค้า
int รหัสของผู้ใช้ที่สร้างขึ้น
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException
IllegalStateException

createUser

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

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

พารามิเตอร์
name String: ของผู้ใช้เพื่อสร้างในอุปกรณ์
guest boolean: เปิดใช้ค่าสถานะผู้ใช้ --guest ในระหว่างการสร้าง
ephemeral boolean: เปิดใช้แฟล็กผู้ใช้ --ephemeral ระหว่างการสร้าง
forTesting boolean: เปิดใช้ Flag การทดสอบ --for-testing ระหว่างการสร้าง
การคืนสินค้า
int รหัสของผู้ใช้ที่สร้างขึ้น
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException
IllegalStateException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

พารามิเตอร์
name String: ของผู้ใช้เพื่อสร้างในอุปกรณ์
การคืนสินค้า
int จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้น หรือ -1 สำหรับข้อผิดพลาด
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

disableKeyguard

public abstract void disableKeyguard ()

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

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

ส่ง
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

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

การคืนสินค้า
boolean true หากปิดใช้การตรวจสอบสำเร็จ false หากไม่สำเร็จ
ส่ง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

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

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

การคืนสินค้า
boolean true หากยกเลิกการเชื่อมต่อจากเครือข่าย Wi-Fi สำเร็จ false หากยกเลิกการเชื่อมต่อไม่สำเร็จ
ส่ง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

พารามิเตอร์
deviceFilePath String: เส้นทางแบบเต็มของไฟล์ในอุปกรณ์ที่จะตรวจสอบ
userId int: รหัสผู้ใช้ที่จะใช้ตรวจสอบว่ามีไฟล์อยู่หรือไม่
การคืนสินค้า
boolean true หากมีไฟล์อยู่ false มิฉะนั้น
ส่ง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

พารามิเตอร์
process String: ชื่อของกระบวนการอุปกรณ์ที่จะเรียกใช้ dumpheap
devicePath String: เส้นทางในอุปกรณ์ที่จะวางไฟล์ดัมพ์ ต้องเป็นตำแหน่งที่ สิทธิ์อนุญาต
การคืนสินค้า
File Fileที่มีรายงาน เป็น Null หากเกิดข้อผิดพลาด
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

การคืนสินค้า
boolean true หากเปิดใช้การตรวจสอบสำเร็จ false หากไม่สำเร็จ
ส่ง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

getActiveApexes

public abstract Set<ITestDevice.ApexInfo> getActiveApexes ()

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

การคืนสินค้า
Set<ITestDevice.ApexInfo> Set จาก ApexInfo เปิดใช้งานอยู่ในอุปกรณ์
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract Map<String, String> getAllSettings (String namespace)

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

พารามิเตอร์
namespace String: ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้ {"system", "secure", "global"}
การคืนสินค้า
Map<String, String> แผนที่ของคู่คีย์-ค่า เป็น 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 Map<Integer, String> getAndroidIds ()

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

การคืนสินค้า
Map<Integer, String> แผนที่ของรหัส 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 List<PackageInfo> getAppPackageInfos ()

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

การคืนสินค้า
List<PackageInfo> List จาก PackageInfo ที่ติดตั้งในอุปกรณ์
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

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

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

การคืนสินค้า
InputStreamSource InputStreamSource ซึ่งจะสร้างเนื้อหาของรายงานข้อบกพร่องตามคำขอ ใน กรณีที่ดำเนินการไม่สำเร็จ InputStreamSource จะสร้าง 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 Set<DeviceFoldableState> getFoldableStates ()

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

การคืนสินค้า
Set<DeviceFoldableState>

ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract Set<String> getInstalledPackageNames ()

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

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

getMainUserId

public abstract Integer getMainUserId ()

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

การคืนสินค้า
Integer userId ของผู้ใช้หลัก (หากมี) และ null หากไม่มีผู้ใช้หลัก
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException หากเอาต์พุตจากอุปกรณ์ไม่เป็นไปตามที่คาดไว้
DeviceNotAvailableException

getMainlineModuleInfo

public abstract Set<String> getMainlineModuleInfo ()

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

การคืนสินค้า
Set<String> Set ของโมดูล String mainline ที่ติดตั้งในอุปกรณ์ในปัจจุบัน
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported (String userType)

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

พารามิเตอร์
userType String: ประเภทผู้ใช้ตามที่กำหนดไว้ใน UserManager เช่น "android.os.usertype.full.SECONDARY"
การคืนสินค้า
int จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่รองรับของประเภทผู้ใช้ที่ระบุ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

เลิกใช้เมธอดนี้แล้ว
ใช้ getMaxNumberOfUsersSupported(String userType) เพื่อรับจำนวนผู้ใช้สูงสุดที่ รองรับสำหรับประเภทผู้ใช้ที่ระบุ

รับจำนวนผู้ใช้ที่เปลี่ยนได้สูงสุดที่ระบบรองรับ โดยไม่รวมผู้ใช้ที่เป็นแขกรับเชิญ หลังจาก API เวอร์ชัน 36 จะไม่รวมผู้ใช้ที่เปลี่ยนไม่ได้ (เช่น โปรไฟล์) ค่าเริ่มต้นคือ 0

การคืนสินค้า
int จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่เปลี่ยนได้ที่รองรับ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

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

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

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

การคืนสินค้า
Integer userId ของผู้ใช้หลัก (หากมี) และ null หากไม่มีผู้ใช้หลัก
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException หากเอาต์พุตจากอุปกรณ์ไม่เป็นไปตามที่คาดไว้
DeviceNotAvailableException

getRemainingCreatableUserCount

public abstract int getRemainingCreatableUserCount (String userType)

แสดงจำนวนผู้ใช้ประเภทผู้ใช้ที่ระบุซึ่งสร้างในอุปกรณ์นี้ได้

พารามิเตอร์
userType String: ประเภทผู้ใช้ตามที่กำหนดไว้ใน UserManager เช่น "android.os.usertype.full.SECONDARY"
การคืนสินค้า
int เพิ่มผู้ใช้ประเภทที่ระบุได้กี่ราย
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (Long displayId, 
                String format, 
                boolean rescale)

ถ่ายภาพหน้าจอจากอุปกรณ์ที่ระบุรหัสจอแสดงผลในรูปแบบที่รองรับ อนุญาตให้ปรับขนาดเพื่อ รองรับขนาดที่เล็กลง

พารามิเตอร์
displayId Long: รหัสการแสดงผลของหน้าจอที่จะจับภาพหน้าจอ
format String: รองรับ PNG, JPEG
rescale boolean: หากควรปรับขนาดภาพหน้าจอเพื่อลดขนาดของรูปภาพที่ได้
การคืนสินค้า
InputStreamSource InputStreamSource ของภาพหน้าจอในรูปแบบ หรือ null หาก ภาพหน้าจอไม่สำเร็จ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
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 (String format)

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

พารามิเตอร์
format String: รองรับ PNG, JPEG
การคืนสินค้า
InputStreamSource InputStreamSource ของภาพหน้าจอในรูปแบบ หรือ null หาก ภาพหน้าจอไม่สำเร็จ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

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

พารามิเตอร์
displayId long: รหัสการแสดงผลของหน้าจอที่จะจับภาพหน้าจอ
การคืนสินค้า
InputStreamSource InputStreamSource ของภาพหน้าจอในรูปแบบ หรือ null หาก ภาพหน้าจอไม่สำเร็จ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

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

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

getSetting

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

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

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

namespace String

key String

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

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

key String

การคืนสินค้า
String

ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract Set<String> getUninstallablePackageNames ()

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

การคืนสินค้า
Set<String> 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 Map<Integer, UserInfo> getUserInfos ()

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

การคืนสินค้า
Map<Integer, UserInfo> รายการออบเจ็กต์ 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

getUserVisibleOnDisplay

public abstract int getUserVisibleOnDisplay (int displayId)

รับรหัสผู้ใช้ของผู้ใช้ที่มองเห็นได้บนจอแสดงผลที่ระบุ

พารามิเตอร์
displayId int: รหัสของจอแสดงผล
การคืนสินค้า
int รหัสผู้ใช้ของผู้ใช้ที่มองเห็นได้บนจอแสดงผลที่ระบุ โดยจะไม่แยกความแตกต่างระหว่างผู้ใช้ที่ทำงานในเบื้องหลังซึ่งมองเห็นได้กับผู้ใช้ที่ทำงานในเบื้องหน้าปัจจุบัน เนื่องจากผู้ใช้ทั้ง 2 ประเภทมองเห็นได้ หากต้องการ แยกความแตกต่าง ให้เปรียบเทียบกับผลลัพธ์ของ getCurrentUser() เพิ่มเติม
ส่ง
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, 
                boolean grantPermissions, 
                String... extraArgs)

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

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

พารามิเตอร์
packageFile File: ไฟล์ APK ที่จะติดตั้ง
reinstall boolean: true หากควรติดตั้งอีกครั้ง
grantPermissions boolean: หากควรมอบสิทธิ์รันไทม์ทั้งหมด ณ เวลาที่ติดตั้ง
extraArgs String: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm -h"

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

installPackageForUser

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

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

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

พารามิเตอร์
packageFile File: ไฟล์ APK ที่จะติดตั้ง
reinstall boolean: true หากควรติดตั้งอีกครั้ง
grantPermissions boolean: หากควรมอบสิทธิ์รันไทม์ทั้งหมด ณ เวลาที่ติดตั้ง
userId int: รหัสผู้ใช้ที่เป็นจำนวนเต็มที่จะติดตั้ง
extraArgs String: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm -h"

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

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

installPackageWithIncrementalMode

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

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

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

userId String

การคืนสินค้า
boolean

ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackages

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                String... extraArgs)

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

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

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

installPackages

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

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

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

พารามิเตอร์
packageFiles List: เส้นทางไฟล์ APK ระยะไกลที่จะติดตั้ง
reinstall boolean: true หากควรติดตั้งอีกครั้ง
grantPermissions boolean: หากควรมอบสิทธิ์รันไทม์ทั้งหมด ณ เวลาที่ติดตั้ง
extraArgs String: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm -h"

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

installPackagesForUser

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

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

พารามิเตอร์
packageFiles List: ไฟล์ APK ในเครื่อง
reinstall boolean: true หากควรติดตั้งอีกครั้ง
userId int: รหัสผู้ใช้ที่เป็นจำนวนเต็มที่จะติดตั้ง
extraArgs String: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm -h"

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

installPackagesForUser

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

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

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

พารามิเตอร์
packageFiles List: ไฟล์ APK ในเครื่อง
reinstall boolean: true หากควรติดตั้งอีกครั้ง
grantPermissions boolean: หากควรมอบสิทธิ์รันไทม์ทั้งหมด ณ เวลาที่ติดตั้ง
userId int: รหัสผู้ใช้ที่เป็นจำนวนเต็มที่จะติดตั้ง
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 ()

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

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

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

การคืนสินค้า
boolean อุปกรณ์รองรับผู้ใช้หลายคนที่สลับได้หรือไม่
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

พารามิเตอร์
packageName String: แพ็กเกจที่เรากำลังตรวจสอบว่ามีการติดตั้งหรือไม่
userId String: รหัสผู้ใช้ที่เรากำลังตรวจสอบว่ามีการติดตั้งแพ็กเกจไว้หรือไม่ หากเป็นค่าว่าง ระบบจะใช้ผู้ใช้หลัก เป็น 0
การคืนสินค้า
boolean จริง หากมีการรายงานว่าติดตั้งแพ็กเกจแล้ว มิเช่นนั้นจะเป็น "เท็จ"
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

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

การคืนสินค้า
boolean จริง หากมีการรายงานว่าติดตั้งแพ็กเกจแล้ว มิเช่นนั้นจะเป็น "เท็จ"
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

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

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

การคืนสินค้า
boolean เป็นจริงหากผู้ใช้กำลังวิ่ง และเป็นเท็จในกรณีอื่นๆ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

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

การคืนสินค้า
boolean จริง หากผู้ใช้เป็นผู้ใช้รอง เท็จ หากไม่ใช่
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

ตรวจสอบว่าผู้ใช้ที่ระบุปรากฏหรือไม่

ผู้ใช้ที่ "มองเห็นได้" คือผู้ใช้ที่โต้ตอบกับผู้ใช้ "ที่เป็นมนุษย์" และจึงสามารถ เปิดกิจกรรมการเปิดแอป (โดยปกติจะอยู่ในจอแสดงผลเริ่มต้น)

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

การคืนสินค้า
boolean

ส่ง
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

ตรวจสอบว่าผู้ใช้ที่ระบุปรากฏในจอแสดงผลที่ระบุหรือไม่

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

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

displayId int

การคืนสินค้า
boolean

ส่ง
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

แสดงว่าอุปกรณ์อนุญาตให้ผู้ใช้เริ่มแสดงในเบื้องหลังใน ERROR(/java.android.view.Display#DEFAULT_DISPLAY) หรือไม่

หากเป็นเช่นนั้น คุณสามารถเรียก startVisibleBackgroundUser(int, int, boolean) โดยส่ง จอแสดงผลที่ listDisplayIdsForStartingVisibleBackgroundUsers() ส่งคืน (ซึ่ง ควรมี ERROR(/java.android.view.Display#DEFAULT_DISPLAY))

การคืนสินค้า
boolean

ส่ง
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

หากเป็นเช่นนั้น คุณก็เรียกใช้ startVisibleBackgroundUser(int, int, boolean) ได้โดยส่ง จอแสดงผลที่ listDisplayIdsForStartingVisibleBackgroundUsers() แสดงผล

การคืนสินค้า
boolean

ส่ง
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

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

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

การคืนสินค้า
boolean true หากเปิดใช้ Wi-Fi false หากปิดใช้
ส่ง
DeviceNotAvailableException หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและกู้คืนไม่ได้

listDisplayIds

public abstract Set<Long> listDisplayIds ()

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

การคืนสินค้า
Set<Long> รายการจอแสดงผล ค่าเริ่มต้นจะแสดงผลเป็นค่าเริ่มต้น 0 เสมอ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

การคืนสินค้า
Set<Integer>

ส่ง
DeviceNotAvailableException

listUsers

public abstract ArrayList<Integer> listUsers ()

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

การคืนสินค้า
ArrayList<Integer> รายการรหัสผู้ใช้
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

พารามิเตอร์
dataName String: ชื่อที่จะใช้รายงานข้อบกพร่อง
listener ITestLogger: ITestLogger เพื่อบันทึกรายงานข้อบกพร่อง
การคืนสินค้า
boolean เป็นจริงหากการบันทึกสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

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

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

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

พารามิเตอร์
componentName String: ของผู้ดูแลระบบอุปกรณ์ที่จะนำออก
userId int: ของผู้ใช้ที่ผู้ดูแลระบบอุปกรณ์อาศัยอยู่
การคืนสินค้า
boolean เป็นจริงหากสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

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

ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

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

พารามิเตอร์
userId int: ของผู้ใช้ที่ต้องการนำออก
การคืนสินค้า
boolean จริง หากเรานำผู้ใช้ออกได้สำเร็จ หรือเป็นเท็จ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

พารามิเตอร์
componentName String: ของผู้ดูแลระบบอุปกรณ์ให้เป็นเจ้าของอุปกรณ์
userId int: ของผู้ใช้ที่เจ้าของอุปกรณ์อาศัยอยู่
การคืนสินค้า
boolean เป็นจริงหากสำเร็จ ไม่เช่นนั้นจะเป็นเท็จ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

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

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

key String

value String

ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

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

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

namespace String

key String

value String

ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

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

พารามิเตอร์
userId int: ของผู้ใช้ให้เริ่มทำงานในเบื้องหลัง
การคืนสินค้า
boolean จริง หากเริ่มผู้ใช้ในเบื้องหลังได้สำเร็จ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

พารามิเตอร์
userId int: ของผู้ใช้ให้เริ่มทำงานในเบื้องหลัง
waitFlag boolean: จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มและปลดล็อก
การคืนสินค้า
boolean จริง หากเริ่มผู้ใช้ในเบื้องหลังได้สำเร็จ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

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

พารามิเตอร์
userId int: ของผู้ใช้ให้เริ่มทำงานในเบื้องหลัง
displayId int: แสดงเพื่อเริ่มให้ผู้ใช้เห็นใน
waitFlag boolean: จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มและปลดล็อก
การคืนสินค้า
boolean true หากเริ่มผู้ใช้ให้มองเห็นในเบื้องหลังได้สำเร็จ
ส่ง
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

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

พารามิเตอร์
userId int: ของผู้ใช้เพื่อหยุด
การคืนสินค้า
boolean เป็นจริงหากหยุดผู้ใช้สำเร็จ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

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

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

พารามิเตอร์
userId int: ของผู้ใช้เพื่อหยุด
waitFlag boolean: จะทำให้คำสั่งรอจนกว่าผู้ใช้จะหยุด
forceFlag boolean: จะบังคับให้ผู้ใช้หยุด
การคืนสินค้า
boolean เป็นจริงหากหยุดผู้ใช้สำเร็จ
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

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

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

การคืนสินค้า
boolean จริง หาก userId ใหม่ตรงกับผู้ให้บริการ userId มิเช่นนั้นจะเป็น "เท็จ"
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

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

timeout long: เพื่อรอให้การเปลี่ยนผู้ใช้ล้มเหลวก่อนที่จะส่งคืนค่าเป็นเท็จ
การคืนสินค้า
boolean จริง หาก userId ใหม่ตรงกับผู้ให้บริการ userId มิเช่นนั้นจะเป็น "เท็จ"
ส่ง
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

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

การคืนสินค้า
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

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

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

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

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

ส่ง
DeviceNotAvailableException