ลองใช้คำสั่งอุปกรณ์อีกครั้งตามจำนวนที่กำหนด และจัดเตรียมอินเทอร์เฟซการกู้คืนอุปกรณ์สำหรับอุปกรณ์ที่ไม่ตอบสนอง
คลาสที่ซ้อนกัน |
---|
class | ITestDevice.ApexInfo คลาส struct ง่าย ๆ เพื่อเก็บข้อมูลเกี่ยวกับ APEX เดียว |
class | ITestDevice.MountPointInfo คลาสโครงสร้างอย่างง่ายในการจัดเก็บข้อมูลเกี่ยวกับจุดเมานท์เดียว |
วิธีการสาธารณะ |
---|
abstract boolean | canSwitchToHeadlessSystemUser () ส่งคืนว่าจะอนุญาตให้สลับไปใช้ผู้ใช้ SYSTEM ที่ไม่มีหัวหรือไม่ |
abstract boolean | checkConnectivity () ตรวจสอบว่าอุปกรณ์นั้นมีการเชื่อมต่อเครือข่าย |
abstract boolean | clearErrorDialogs () พยายามปิดกล่องโต้ตอบข้อผิดพลาดที่แสดงบน UI ของอุปกรณ์ในปัจจุบัน |
abstract void | clearLastConnectedWifiNetwork () ล้างเครือข่าย wifi ที่เชื่อมต่อล่าสุด |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) เชื่อมต่อกับเครือข่าย wifi |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) เชื่อมต่อกับเครือข่าย wifi |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) เชื่อมต่อกับเครือข่าย wifi |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) เชื่อมต่อกับเครือข่าย wifi |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid) ตัวแปรของ connectToWifiNetwork(String, String) ที่เชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ไม่มีการเชื่อมต่อเครือข่าย |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) ตัวแปรของ connectToWifiNetwork(String, String) ที่เชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ไม่มีการเชื่อมต่อเครือข่าย |
abstract int | createUser (String name) สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0 |
abstract int | createUser (String name, boolean guest, boolean ephemeral) สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ให้ไว้ |
abstract int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ให้ไว้ |
abstract int | createUserNoThrow (String name) สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0 |
abstract void | deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) ลบ IDeviceActionReceiver ที่ลงทะเบียนไว้ |
abstract void | disableKeyguard () พยายามปิดการใช้งานคีย์การ์ด |
abstract boolean | disableNetworkMonitor () ปิดใช้งานการตรวจสอบเครือข่ายบนอุปกรณ์ |
abstract boolean | disconnectFromWifi () ตัดการเชื่อมต่อจากเครือข่าย wifi |
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 หากไม่พบจะเป็นโมฆะ |
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 () ส่งคืนอ็อบเจ็กต์เพื่อรับสถานะปัจจุบันของคีย์การ์ดหรือค่าว่างหากไม่รองรับ |
abstract Integer | getMainUserId () ส่งกลับรหัสผู้ใช้หลัก |
abstract | getMainlineModuleInfo () รับข้อมูลเกี่ยวกับโมดูลเมนไลน์ที่ติดตั้งบนอุปกรณ์ |
abstract int | getMaxNumberOfRunningUsersSupported () รับจำนวนผู้ใช้ที่ทำงานพร้อมกันสูงสุดที่รองรับ |
abstract int | getMaxNumberOfUsersSupported () รับจำนวนผู้ใช้ที่รองรับสูงสุด |
abstract TestDeviceOptions | getOptions () ดึงตัวเลือกการทดสอบสำหรับอุปกรณ์ |
abstract Integer | getPrimaryUserId () ส่งกลับรหัสผู้ใช้หลัก |
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 | getUninstallablePackageNames () ดึงข้อมูลชื่อแพ็คเกจแอปพลิเคชันที่สามารถถอนการติดตั้งได้ |
abstract int | getUserFlags (int userId) ค้นหาและส่งคืนแฟล็กของผู้ใช้ที่กำหนด |
abstract | getUserInfos () รับแผนที่ของ useId ไปยัง UserInfo บนอุปกรณ์ |
abstract int | getUserSerialNumber (int 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) installPackages ( packageFiles, boolean reinstall, String... extraArgs) ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) |
default String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ที่วางอยู่บนอุปกรณ์ Android |
default String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกเพิ่มเติมหนึ่งไฟล์) สำหรับผู้ใช้ที่กำหนด |
default String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกเพิ่มเติมหนึ่งไฟล์) สำหรับผู้ใช้ที่กำหนด |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ที่วางอยู่บนอุปกรณ์ Android |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ที่วางอยู่บนอุปกรณ์ Android |
abstract boolean | isHeadlessSystemUserMode () ส่งคืนว่าอุปกรณ์ใช้โหมดผู้ใช้ระบบ headless หรือไม่ |
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 () ทดสอบว่าเปิดใช้งาน wifi หรือไม่ |
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 ดำเนินการให้เสร็จสิ้น |
วิธีการสาธารณะ
สามารถ SwitchToHeadlessSystemUser
public abstract boolean canSwitchToHeadlessSystemUser ()
ส่งคืนว่าจะอนุญาตให้สลับไปใช้ผู้ใช้ SYSTEM ที่ไม่มีหัวหรือไม่
ตรวจสอบการเชื่อมต่อ
public abstract boolean checkConnectivity ()
ตรวจสอบว่าอุปกรณ์นั้นมีการเชื่อมต่อเครือข่าย
การส่งคืน |
---|
boolean | true หากอุปกรณ์มีการเชื่อมต่อเครือข่ายที่ใช้งานได้ จะเป็น false เกิน |
ล้างข้อผิดพลาด Dialogs
public abstract boolean clearErrorDialogs ()
พยายามปิดกล่องโต้ตอบข้อผิดพลาดที่แสดงบน UI ของอุปกรณ์ในปัจจุบัน
การส่งคืน |
---|
boolean | true หากไม่มีไดอะล็อกปรากฏหรือล้างไดอะล็อกสำเร็จ false เป็นอย่างอื่น |
clearLastConnectedWifiNetwork
public abstract void clearLastConnectedWifiNetwork ()
ล้างเครือข่าย wifi ที่เชื่อมต่อล่าสุด ควรเรียกสิ่งนี้เมื่อเริ่มการร้องขอใหม่เพื่อหลีกเลี่ยงการเชื่อมต่อกับเครือข่าย wifi ที่ใช้ในการทดสอบครั้งก่อนหลังจากอุปกรณ์รีบูต
เชื่อมต่อ ToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)
เชื่อมต่อกับเครือข่าย wifi
เปิด wifi และบล็อกจนกว่าจะมีการเชื่อมต่อสำเร็จกับเครือข่าย wifi ใดเครือข่ายหนึ่งที่ระบุในแผนที่ wifiSsidToPsk เมื่อทำการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากรีบูตทุกครั้งจนกว่าจะมีการเรียก ITestDevice#disconnectFromWifi()
หรือ ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ |
---|
wifiSsidToPsk | : แผนที่ wifi SSID เป็นรหัสผ่าน |
การส่งคืน |
---|
boolean | true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false เป็นอย่างอื่น |
เชื่อมต่อ ToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk,
boolean scanSsid)
เชื่อมต่อกับเครือข่าย wifi
เปิด wifi และบล็อกจนกว่าจะมีการเชื่อมต่อสำเร็จกับเครือข่าย wifi ใดเครือข่ายหนึ่งที่ระบุในแผนที่ wifiSsidToPsk เมื่อทำการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากรีบูตทุกครั้งจนกว่าจะมีการเรียก ITestDevice#disconnectFromWifi()
หรือ ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ |
---|
wifiSsidToPsk | : แผนที่ wifi SSID เป็นรหัสผ่าน |
scanSsid | boolean : จะสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่ |
การส่งคืน |
---|
boolean | true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false เป็นอย่างอื่น |
เชื่อมต่อ ToWifiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk)
เชื่อมต่อกับเครือข่าย wifi
เปิด wifi และบล็อกจนกว่าจะเชื่อมต่อกับเครือข่าย wifi ที่ระบุได้สำเร็จ เมื่อทำการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากรีบูตทุกครั้งจนกว่าจะมีการเรียก
ITestDevice#disconnectFromWifi()
หรือ
ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ |
---|
wifiSsid | String : wifi ssid ที่จะเชื่อมต่อ |
wifiPsk | String : ข้อความรหัสผ่าน PSK หรือ null หากไม่ได้เข้ารหัส |
การส่งคืน |
---|
boolean | true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false เป็นอย่างอื่น |
เชื่อมต่อ ToWifiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk,
boolean scanSsid)
เชื่อมต่อกับเครือข่าย wifi
เปิด wifi และบล็อกจนกว่าจะเชื่อมต่อกับเครือข่าย wifi ที่ระบุได้สำเร็จ เมื่อทำการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากรีบูตทุกครั้งจนกว่าจะมีการเรียก
ITestDevice#disconnectFromWifi()
หรือ
ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ |
---|
wifiSsid | String : wifi ssid ที่จะเชื่อมต่อ |
wifiPsk | String : ข้อความรหัสผ่าน PSK หรือ null หากไม่ได้เข้ารหัส |
scanSsid | boolean : จะสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่ |
การส่งคืน |
---|
boolean | true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false เป็นอย่างอื่น |
เชื่อมต่อ ToWifiNetwork ถ้าจำเป็น
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)
ตัวแปรของ connectToWifiNetwork(String, String)
ที่เชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ไม่มีการเชื่อมต่อเครือข่าย
พารามิเตอร์ |
---|
scanSsid | boolean : จะสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่ |
การส่งคืน |
---|
boolean | true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false เป็นอย่างอื่น |
เชื่อมต่อ ToWifiNetwork ถ้าจำเป็น
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)
ตัวแปรของ connectToWifiNetwork(String, String)
ที่เชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ไม่มีการเชื่อมต่อเครือข่าย
การส่งคืน |
---|
boolean | true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false เป็นอย่างอื่น |
createUser
public abstract int createUser (String name)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0
พารามิเตอร์ |
---|
name | String : ของผู้ใช้ที่จะสร้างบนอุปกรณ์ |
การส่งคืน |
---|
int | จำนวนเต็มสำหรับ ID ผู้ใช้ที่สร้างขึ้น |
createUser
public abstract int createUser (String name,
boolean guest,
boolean ephemeral)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ให้ไว้
พารามิเตอร์ |
---|
name | String : ของผู้ใช้ที่จะสร้างบนอุปกรณ์ |
guest | boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --guest ระหว่างการสร้าง |
ephemeral | boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --ชั่วคราวระหว่างการสร้าง |
การส่งคืน |
---|
int | id ของผู้ใช้ที่สร้างขึ้น |
createUser
public abstract int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ให้ไว้
พารามิเตอร์ |
---|
name | String : ของผู้ใช้ที่จะสร้างบนอุปกรณ์ |
guest | boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --guest ระหว่างการสร้าง |
ephemeral | boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --ชั่วคราวระหว่างการสร้าง |
forTesting | boolean : เปิดใช้งานแฟล็กทดสอบ --สำหรับการทดสอบระหว่างการสร้าง |
การส่งคืน |
---|
int | id ของผู้ใช้ที่สร้างขึ้น |
createUserNoThrow
public abstract int createUserNoThrow (String name)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0
พารามิเตอร์ |
---|
name | String : ของผู้ใช้ที่จะสร้างบนอุปกรณ์ |
การส่งคืน |
---|
int | จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้นหรือ -1 สำหรับข้อผิดพลาด |
ปิดการใช้งานKeyguard
public abstract void disableKeyguard ()
พยายามปิดการใช้งานคีย์การ์ด
ขั้นแรกให้รอจนกว่าอินพุตที่จัดส่งจะพร้อม ซึ่งจะเกิดขึ้นเมื่ออุปกรณ์รายงาน BOOT_COMPLETE ซึ่งดูเหมือนจะไม่พร้อมกัน เนื่องจากการใช้งานเฟรมเวิร์กปัจจุบันมีสภาวะการแข่งขันเป็นครั้งคราว จากนั้นคำสั่งจะถูกส่งไปเพื่อยกเลิกการป้องกันคีย์การ์ด (ใช้ได้กับคีย์การ์ดที่ไม่ปลอดภัยเท่านั้น)
ปิดการใช้งาน NetworkMonitor
public abstract boolean disableNetworkMonitor ()
ปิดใช้งานการตรวจสอบเครือข่ายบนอุปกรณ์
การส่งคืน |
---|
boolean | true หากปิดใช้งานการตรวจสอบสำเร็จ false ถ้ามันล้มเหลว |
ตัดการเชื่อมต่อจาก Wifi
public abstract boolean disconnectFromWifi ()
ตัดการเชื่อมต่อจากเครือข่าย wifi
ลบเครือข่ายทั้งหมดออกจากรายการเครือข่ายที่รู้จักและปิดการใช้งาน wifi
การส่งคืน |
---|
boolean | true หากตัดการเชื่อมต่อจากเครือข่าย wifi สำเร็จ false หากการเชื่อมต่อล้มเหลว |
ไม่FileExist
public abstract boolean doesFileExist (String deviceFilePath,
int userId)
วิธีการช่วยเหลือเพื่อตรวจสอบว่าไฟล์ในอุปกรณ์มีอยู่สำหรับผู้ใช้ที่กำหนดหรือไม่
พารามิเตอร์ |
---|
deviceFilePath | String : เส้นทางที่แน่นอนของไฟล์บนอุปกรณ์ที่จะตรวจสอบ |
userId | int : ID ผู้ใช้ที่ใช้ตรวจสอบการมีอยู่ของไฟล์ |
การส่งคืน |
---|
boolean | true หากมีไฟล์อยู่ มิฉะนั้นจะ false |
dumpHeap
public abstract File dumpHeap (String process,
String devicePath)
พยายามดัมพ์ฮีปจาก system_server เป็นความรับผิดชอบของผู้โทรในการล้างไฟล์ที่ทิ้ง
พารามิเตอร์ |
---|
process | String : ชื่อของกระบวนการอุปกรณ์ที่จะดัมพ์ฮีป |
devicePath | String : เส้นทางบนอุปกรณ์ที่จะวางดัมพ์ นี่จะต้องเป็นสถานที่ที่ได้รับอนุญาต |
การส่งคืน |
---|
File | ERROR(/File) ที่มีรายงาน เป็นโมฆะหากมีบางอย่างล้มเหลว |
เปิดใช้งาน NetworkMonitor
public abstract boolean enableNetworkMonitor ()
เปิดใช้งานการตรวจสอบเครือข่ายบนอุปกรณ์
การส่งคืน |
---|
boolean | true หากเปิดใช้งานการตรวจสอบได้สำเร็จ false ถ้ามันล้มเหลว |
getActiveApexes
public abstract getActiveApexes ()
ดึงข้อมูลเกี่ยวกับ APEX ที่เปิดใช้งานบนอุปกรณ์
รับการตั้งค่าทั้งหมด
public abstract getAllSettings (String namespace)
ส่งกลับคู่ค่าคีย์ของเนมสเปซที่ร้องขอ
พารามิเตอร์ |
---|
namespace | String : ต้องเป็นหนึ่งใน {"system", "secure", "global"} |
การส่งคืน |
---|
| แผนที่ของคู่ค่าคีย์ เป็นค่าว่างหากไม่รองรับเนมสเปซ |
รับ AndroidId
public abstract String getAndroidId (int userId)
ค้นหาและส่งกลับ android-id ที่เกี่ยวข้องกับ userId หากไม่พบจะเป็นโมฆะ
รับรหัส Android
public abstract getAndroidIds ()
สร้างแผนที่ของรหัส Android ที่พบว่าตรงกับรหัสผู้ใช้ ไม่มีการประกันว่ารหัสผู้ใช้แต่ละรหัสจะพบรหัส Android ที่เกี่ยวข้องกับฟังก์ชันนี้ ดังนั้นรหัสผู้ใช้บางส่วนอาจตรงกับค่าว่าง
การส่งคืน |
---|
| พบแผนที่รหัส Android ที่ตรงกับรหัสผู้ใช้ |
getAppPackageInfo
public abstract PackageInfo getAppPackageInfo (String packageName)
ดึงข้อมูลเกี่ยวกับแพ็คเกจที่ติดตั้งบนอุปกรณ์
พารามิเตอร์ |
---|
packageName | String |
getAppPackageInfos
public abstract getAppPackageInfos ()
ดึงข้อมูลแพ็คเกจที่ติดตั้งบนอุปกรณ์
รับ Bugreport
public abstract InputStreamSource getBugreport ()
ดึงรายงานข้อบกพร่องจากอุปกรณ์
การดำเนินการนี้รับประกันว่าจะทำงานต่อไปบนอุปกรณ์ที่ไม่มี sdcard (หรือในกรณีที่ยังไม่ได้ติดตั้ง sdcard)
รับ Bugreportz
public abstract InputStreamSource getBugreportz ()
ดึง bugreportz จากอุปกรณ์ รายงานข้อบกพร่องในรูปแบบ ZIP ประกอบด้วยรายงานข้อบกพร่องหลักและไฟล์บันทึกอื่นๆ ที่เป็นประโยชน์สำหรับการแก้ไขข้อบกพร่อง
รองรับเฉพาะ 'เวอร์ชัน adb' > 1.0.36 เท่านั้น
getCurrentFoldableState
public abstract DeviceFoldableState getCurrentFoldableState ()
ส่งคืนสถานะการพับได้ปัจจุบันของอุปกรณ์หรือเป็นค่าว่างหากเกิดปัญหาบางอย่าง
getCurrentUser
public abstract int getCurrentUser ()
คืนรหัสของผู้ใช้ที่ทำงานอยู่ในปัจจุบัน ในกรณีที่เกิดข้อผิดพลาด ให้ส่งคืน -10000
getFoldableStates
public abstract getFoldableStates ()
ส่งคืนรายการสถานะแบบพับได้บนอุปกรณ์ สามารถรับได้ด้วย "cmd device_state print-states"
getInstalledPackageNames
public abstract getInstalledPackageNames ()
ดึงข้อมูลชื่อแพ็คเกจแอปพลิเคชันที่ปรากฏบนอุปกรณ์
getIpAddress
public abstract String getIpAddress ()
รับที่อยู่ IP ของอุปกรณ์
การส่งคืน |
---|
String | ที่อยู่ IP ของอุปกรณ์ หรือ null หากอุปกรณ์ไม่มีที่อยู่ IP |
getKeyguardState
public abstract KeyguardControllerState getKeyguardState ()
ส่งคืนอ็อบเจ็กต์เพื่อรับสถานะปัจจุบันของคีย์การ์ดหรือค่าว่างหากไม่รองรับ
getMainUserId
public abstract Integer getMainUserId ()
ส่งกลับรหัสผู้ใช้หลัก
การส่งคืน |
---|
Integer | userId ของผู้ใช้หลัก หากมี และเป็นโมฆะหากไม่มีผู้ใช้หลัก |
getMainlineModuleInfo
public abstract getMainlineModuleInfo ()
รับข้อมูลเกี่ยวกับโมดูลเมนไลน์ที่ติดตั้งบนอุปกรณ์
public abstract int getMaxNumberOfRunningUsersSupported ()
รับจำนวนผู้ใช้ที่ทำงานพร้อมกันสูงสุดที่รองรับ ค่าเริ่มต้นเป็น 0
การส่งคืน |
---|
int | จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่ทำงานพร้อมกัน |
public abstract int getMaxNumberOfUsersSupported ()
รับจำนวนผู้ใช้ที่รองรับสูงสุด ค่าเริ่มต้นเป็น 0
การส่งคืน |
---|
int | จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่รองรับ |
รับตัวเลือก
public abstract TestDeviceOptions getOptions ()
ดึงตัวเลือกการทดสอบสำหรับอุปกรณ์
รับ PrimaryUserId
public abstract Integer getPrimaryUserId ()
ส่งกลับรหัสผู้ใช้หลัก
การส่งคืน |
---|
Integer | userId ของผู้ใช้หลัก หากมี และเป็นค่าว่างหากไม่มีผู้ใช้หลัก |
รับภาพหน้าจอ
public abstract InputStreamSource getScreenshot (String format,
boolean rescale)
จับภาพหน้าจอจากอุปกรณ์ แนะนำให้ใช้ getScreenshot(String)
แทนการเข้ารหัส JPEG สำหรับขนาดที่เล็กกว่า
พารามิเตอร์ |
---|
format | String : รองรับ PNG, JPEG |
rescale | boolean : หากควรปรับขนาดภาพหน้าจอเพื่อลดขนาดของภาพที่ได้ |
รับภาพหน้าจอ
public abstract InputStreamSource getScreenshot (String format)
จับภาพหน้าจอจากอุปกรณ์ แนะนำให้ใช้ getScreenshot(format) แทนการเข้ารหัส JPEG สำหรับขนาดที่เล็กกว่า
พารามิเตอร์ |
---|
format | String : รองรับ PNG, JPEG |
รับภาพหน้าจอ
public abstract InputStreamSource getScreenshot (long displayId)
จับภาพหน้าจอจากอุปกรณ์ที่ระบุรหัสที่แสดง รูปแบบเป็น PNG
สิ่งที่ต้องทำ: ขยายการใช้งานด้านบนเพื่อรองรับ 'รูปแบบ' และ 'ปรับขนาดใหม่'
พารามิเตอร์ |
---|
displayId | long : รหัสที่แสดงของหน้าจอที่จะรับภาพหน้าจอ |
รับภาพหน้าจอ
public abstract InputStreamSource getScreenshot ()
จับภาพหน้าจอจากอุปกรณ์
รับการตั้งค่า
public abstract String getSetting (int userId,
String namespace,
String key)
ส่งกลับค่าของการตั้งค่าที่ร้องขอ เนมสเปซจะต้องเป็นหนึ่งใน: {"system", "secure", "global"}
พารามิเตอร์ |
---|
userId | int |
namespace | String |
key | String |
การส่งคืน |
---|
String | ค่าที่เกี่ยวข้องกับเนมสเปซ:คีย์ของผู้ใช้ เป็นโมฆะหากไม่พบ |
รับการตั้งค่า
public abstract String getSetting (String namespace,
String key)
ดู getSetting(int, String, String)
และดำเนินการกับผู้ใช้ระบบ
พารามิเตอร์ |
---|
namespace | String |
key | String |
getUninstallablePackageNames
public abstract getUninstallablePackageNames ()
ดึงข้อมูลชื่อแพ็คเกจแอปพลิเคชันที่สามารถถอนการติดตั้งได้ ปัจจุบันถูกกำหนดให้เป็นแพ็คเกจที่ไม่ใช่ระบบ และแพ็คเกจระบบที่อัพเดต
การส่งคืน |
---|
| ERROR(/Set) ของชื่อแพ็คเกจ String ที่สามารถถอนการติดตั้งได้ที่ติดตั้งอยู่ในอุปกรณ์ในปัจจุบัน |
getUserFlags
public abstract int getUserFlags (int userId)
ค้นหาและส่งคืนแฟล็กของผู้ใช้ที่กำหนด การตั้งค่าสถานะถูกกำหนดไว้ในคลาส "android.content.pm.UserInfo" ในโครงการ Android Open Source
การส่งคืน |
---|
int | ค่าสถานะที่เกี่ยวข้องกับ userId ที่ระบุหากพบ -10000 ในกรณีอื่น ๆ |
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)
หากพบ ให้ส่งคืนหมายเลขซีเรียลที่เกี่ยวข้องกับรหัสผู้ใช้ -10000 ในกรณีอื่นๆ
มีคุณลักษณะ
public abstract boolean hasFeature (String feature)
ตรวจสอบว่ามีคุณสมบัติพร้อมใช้งานบนอุปกรณ์หรือไม่
พารามิเตอร์ |
---|
feature | String : รูปแบบใดควรเป็น "feature: " หรือ " " โดยตรง. |
การส่งคืน |
---|
boolean | เป็นจริงหากพบคุณลักษณะ มิฉะนั้นจะเป็นเท็จ |
ติดตั้งแพ็คเกจ
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 หากสำเร็จ |
ติดตั้งแพ็คเกจ
public abstract String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
ติดตั้งแพ็คเกจ Android บนอุปกรณ์
หมายเหตุ: เฉพาะกรณีการใช้งานที่ต้องมีการควบคุมอย่างชัดเจนในการให้สิทธิ์รันไทม์ ณ เวลาติดตั้งเท่านั้นที่ควรเรียกใช้ฟังก์ชันนี้
พารามิเตอร์ |
---|
packageFile | File : ไฟล์ apk ที่จะติดตั้ง |
reinstall | boolean : true หากควรทำการติดตั้งใหม่ |
grantPermissions | boolean : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง |
extraArgs | String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี |
การส่งคืน |
---|
String | String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
ขว้าง |
---|
DeviceNotAvailableException | หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้ |
UnsupportedOperationException | หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์ |
ติดตั้ง PackageForUser
public abstract String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
ติดตั้งแพ็คเกจ Android บนอุปกรณ์สำหรับผู้ใช้ที่กำหนด
พารามิเตอร์ |
---|
packageFile | File : ไฟล์ apk ที่จะติดตั้ง |
reinstall | boolean : true หากควรทำการติดตั้งใหม่ |
userId | int : ID ผู้ใช้จำนวนเต็มที่จะติดตั้ง |
extraArgs | String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี |
การส่งคืน |
---|
String | String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
ติดตั้ง PackageForUser
public abstract String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
ติดตั้งแพ็คเกจ Android บนอุปกรณ์สำหรับผู้ใช้ที่กำหนด
หมายเหตุ: เฉพาะกรณีการใช้งานที่ต้องมีการควบคุมอย่างชัดเจนในการให้สิทธิ์รันไทม์ ณ เวลาติดตั้งเท่านั้นที่ควรเรียกใช้ฟังก์ชันนี้
พารามิเตอร์ |
---|
packageFile | File : ไฟล์ apk ที่จะติดตั้ง |
reinstall | boolean : true หากควรทำการติดตั้งใหม่ |
grantPermissions | boolean : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง |
userId | int : ID ผู้ใช้จำนวนเต็มที่จะติดตั้ง |
extraArgs | String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี |
การส่งคืน |
---|
String | String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
ขว้าง |
---|
DeviceNotAvailableException | หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้ |
UnsupportedOperationException | หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์ |
ติดตั้งแพ็คเกจ
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ดู "https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีการแบ่ง APK เป็นหลายไฟล์
พารามิเตอร์ |
---|
packageFiles | : ไฟล์ apk ในเครื่อง |
reinstall | boolean : true หากควรทำการติดตั้งใหม่ |
extraArgs | String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี |
การส่งคืน |
---|
String | String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
ขว้าง |
---|
DeviceNotAvailableException | หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้ |
UnsupportedOperationException | หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์ |
ติดตั้งแพ็คเกจ
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ที่วางอยู่บนอุปกรณ์ Android ดู "https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีการแบ่ง APK เป็นหลายไฟล์
หมายเหตุ: เฉพาะกรณีการใช้งานที่ต้องมีการควบคุมอย่างชัดเจนในการให้สิทธิ์รันไทม์ ณ เวลาติดตั้งเท่านั้นที่ควรเรียกใช้ฟังก์ชันนี้
พารามิเตอร์ |
---|
packageFiles | : เส้นทางไฟล์ APK ระยะไกลที่จะติดตั้ง |
reinstall | boolean : true หากควรทำการติดตั้งใหม่ |
grantPermissions | boolean : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง |
extraArgs | String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี |
การส่งคืน |
---|
String | String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
ขว้าง |
---|
DeviceNotAvailableException | หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้ |
UnsupportedOperationException | หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์ |
ติดตั้งPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกเพิ่มเติมหนึ่งไฟล์) สำหรับผู้ใช้ที่กำหนด ดู "https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีการแบ่ง APK เป็นหลายไฟล์
พารามิเตอร์ |
---|
packageFiles | : ไฟล์ apk ในเครื่อง |
reinstall | boolean : true หากควรทำการติดตั้งใหม่ |
userId | int : ID ผู้ใช้จำนวนเต็มที่จะติดตั้ง |
extraArgs | String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี |
การส่งคืน |
---|
String | String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
ขว้าง |
---|
DeviceNotAvailableException | หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้ |
UnsupportedOperationException | หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์ |
ติดตั้งPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกเพิ่มเติมหนึ่งไฟล์) สำหรับผู้ใช้ที่กำหนด ดู "https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีการแบ่ง APK เป็นหลายไฟล์
หมายเหตุ: เฉพาะกรณีการใช้งานที่ต้องมีการควบคุมอย่างชัดเจนในการให้สิทธิ์รันไทม์ ณ เวลาติดตั้งเท่านั้นที่ควรเรียกใช้ฟังก์ชันนี้
พารามิเตอร์ |
---|
packageFiles | : ไฟล์ apk ในเครื่อง |
reinstall | boolean : true หากควรทำการติดตั้งใหม่ |
grantPermissions | boolean : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง |
userId | int : ID ผู้ใช้จำนวนเต็มที่จะติดตั้ง |
extraArgs | String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี |
การส่งคืน |
---|
String | String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
ขว้าง |
---|
DeviceNotAvailableException | หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้ |
UnsupportedOperationException | หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์ |
ติดตั้ง RemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ที่วางอยู่บนอุปกรณ์ Android ดู "https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีการแบ่ง APK เป็นหลายไฟล์
พารามิเตอร์ |
---|
remoteApkPaths | : เส้นทางไฟล์ APK ระยะไกล |
reinstall | boolean : true หากควรทำการติดตั้งใหม่ |
extraArgs | String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี |
การส่งคืน |
---|
String | String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
ขว้าง |
---|
DeviceNotAvailableException | หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้ |
UnsupportedOperationException | หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์ |
ติดตั้ง RemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจหลักและแพ็คเกจแยกพิเศษหนึ่งไฟล์) ที่วางอยู่บนอุปกรณ์ Android ดู "https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีการแบ่ง APK เป็นหลายไฟล์
หมายเหตุ: เฉพาะกรณีการใช้งานที่ต้องมีการควบคุมอย่างชัดเจนในการให้สิทธิ์รันไทม์ ณ เวลาติดตั้งเท่านั้นที่ควรเรียกใช้ฟังก์ชันนี้
พารามิเตอร์ |
---|
remoteApkPaths | : เส้นทางไฟล์ APK ระยะไกล |
reinstall | boolean : true หากควรทำการติดตั้งใหม่ |
grantPermissions | boolean : หากควรให้สิทธิ์รันไทม์ทั้งหมด ณ เวลาติดตั้ง |
extraArgs | String : อาร์กิวเมนต์พิเศษเพิ่มเติมที่จะผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี |
การส่งคืน |
---|
String | String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
ขว้าง |
---|
DeviceNotAvailableException | หากการเชื่อมต่อกับอุปกรณ์ขาดหายไปและไม่สามารถกู้คืนได้ |
UnsupportedOperationException | หากแพลตฟอร์มบนอุปกรณ์ไม่รองรับการอนุญาตรันไทม์ |
isHeadlessSystemUserMode
public abstract boolean isHeadlessSystemUserMode ()
ส่งคืนว่าอุปกรณ์ใช้โหมดผู้ใช้ระบบ headless หรือไม่
isMainUserPermanentAdmin
public abstract boolean isMainUserPermanentAdmin ()
คืนค่าว่าผู้ใช้หลักเป็นผู้ดูแลระบบถาวรหรือไม่ และไม่สามารถลบหรือดาวน์เกรดเป็นสถานะที่ไม่ใช่ผู้ดูแลระบบได้
รองรับผู้ใช้หลายราย
public abstract boolean isMultiUserSupported ()
กำหนดว่ารองรับผู้ใช้หลายรายหรือไม่
การส่งคืน |
---|
boolean | จริงหากรองรับผู้ใช้หลายคน มิฉะนั้นจะเป็นเท็จ |
isPackageInstalled แล้ว
public abstract boolean isPackageInstalled (String packageName,
String userId)
ค้นหาอุปกรณ์สำหรับชื่อแพ็คเกจที่กำหนดและรหัสผู้ใช้ที่กำหนดเพื่อตรวจสอบว่ามีการติดตั้งในปัจจุบันหรือไม่สำหรับผู้ใช้นั้น
พารามิเตอร์ |
---|
packageName | String : แพ็คเกจที่เรากำลังตรวจสอบว่าติดตั้งแล้วหรือไม่ |
userId | String : รหัสผู้ใช้ที่เรากำลังตรวจสอบแพ็คเกจได้รับการติดตั้งแล้ว หากเป็นค่าว่าง ระบบจะใช้ศูนย์ผู้ใช้หลัก |
การส่งคืน |
---|
boolean | เป็นจริงหากแพ็กเกจถูกรายงานว่าติดตั้งแล้ว เท็จเป็นอย่างอื่น |
isPackageInstalled แล้ว
public abstract boolean isPackageInstalled (String packageName)
ค้นหาอุปกรณ์สำหรับชื่อแพ็คเกจที่กำหนดเพื่อตรวจสอบว่ามีการติดตั้งอยู่หรือไม่
พารามิเตอร์ |
---|
packageName | String |
การส่งคืน |
---|
boolean | เป็นจริงหากแพ็กเกจถูกรายงานว่าติดตั้งแล้ว เท็จเป็นอย่างอื่น |
isUserRunning
public abstract boolean isUserRunning (int userId)
ตรวจสอบว่าผู้ใช้ที่กำหนดกำลังทำงานอยู่หรือไม่
การส่งคืน |
---|
boolean | เป็นจริงหากผู้ใช้กำลังทำงานอยู่ จะเป็นเท็จในทุกกรณี |
isUserSecondary
public abstract boolean isUserSecondary (int userId)
ส่งคืนว่าผู้ใช้ที่ระบุเป็นผู้ใช้รองตามแฟล็กหรือไม่
การส่งคืน |
---|
boolean | จริงหากผู้ใช้เป็นผู้ใช้รอง มิฉะนั้นจะเป็นเท็จ |
isUserVisible
public abstract boolean isUserVisible (int userId)
ตรวจสอบว่าผู้ใช้ที่ระบุปรากฏให้เห็นหรือไม่
ผู้ใช้ที่ "มองเห็นได้" คือผู้ใช้ที่กำลังโต้ตอบกับผู้ใช้ "มนุษย์" และด้วยเหตุนี้จึงสามารถเปิดกิจกรรมการเปิดตัวได้ (โดยทั่วไปจะอยู่ในจอแสดงผลเริ่มต้น)
isUserVisibleOnDisplay
public abstract boolean isUserVisibleOnDisplay (int userId,
int displayId)
ตรวจสอบว่าผู้ใช้ที่กำหนดปรากฏให้เห็นในจอแสดงผลที่กำหนดหรือไม่
ผู้ใช้ที่ "มองเห็นได้" คือผู้ใช้ที่กำลังโต้ตอบกับผู้ใช้ "มนุษย์" และด้วยเหตุนี้จึงสามารถเปิดกิจกรรมการเปิดตัวในจอแสดงผลนั้นได้
พารามิเตอร์ |
---|
userId | int |
displayId | int |
เปิดใช้งาน Wifi แล้ว
public abstract boolean isWifiEnabled ()
ทดสอบว่าเปิดใช้งาน wifi หรือไม่
ตรวจสอบว่าเปิดใช้งาน wifi บนอุปกรณ์หรือไม่ มีประโยชน์สำหรับการยืนยันสถานะ wifi ก่อนการทดสอบที่ไม่ควรทำงานด้วย wifi เช่น การทดสอบข้อมูลมือถือ
การส่งคืน |
---|
boolean | true หากเปิดใช้งาน wifi false หากปิดใช้งาน |
listDisplayIds
public abstract listDisplayIds ()
รวบรวมรายการรหัสการแสดงผลที่มีอยู่บนอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger"
การส่งคืน |
---|
| รายการจอแสดงผล ค่าเริ่มต้นจะส่งคืนการแสดงผลเริ่มต้น 0 เสมอ |
รายชื่อผู้ใช้
public abstract listUsers ()
รับรายชื่อผู้ใช้บนอุปกรณ์ จะส่ง DeviceRuntimeException
หากเอาต์พุตจากอุปกรณ์ไม่เป็นไปตามที่คาดไว้
การส่งคืน |
---|
| รายการรหัสผู้ใช้ |
ขว้าง |
---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException | |
บันทึกรายงานข้อบกพร่อง
public abstract boolean logBugreport (String dataName,
ITestLogger listener)
วิธีการช่วยเหลือในการจัดทำรายงานข้อผิดพลาดและบันทึกไปยังผู้รายงาน
พารามิเตอร์ |
---|
dataName | String : ชื่อที่จะใช้รายงานรายงานข้อบกพร่อง |
listener | ITestLogger : ITestLogger เพื่อบันทึกรายงานจุดบกพร่อง |
การส่งคืน |
---|
boolean | เป็นจริงหากการบันทึกสำเร็จ มิฉะนั้นจะเป็นเท็จ |
แจ้ง Snapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
แจ้งอุปกรณ์ให้รอ snapuserd เสร็จสิ้น
พารามิเตอร์ |
---|
waitPhase | SnapuserdWaitPhase |
ลบผู้ดูแลระบบ
public abstract boolean removeAdmin (String componentName,
int userId)
ลบผู้ดูแลอุปกรณ์ที่กำหนดในผู้ใช้ที่กำหนด และคืนค่า true
หากดำเนินการสำเร็จ หากทำได้จะเป็น false
พารามิเตอร์ |
---|
componentName | String : ของผู้ดูแลระบบอุปกรณ์ที่จะลบออก |
userId | int : ของผู้ใช้ที่ผู้ดูแลอุปกรณ์อาศัยอยู่ |
การส่งคืน |
---|
boolean | เป็นจริงหากสำเร็จ มิฉะนั้นจะเป็นเท็จ |
ลบเจ้าของ
public abstract void removeOwners ()
ลบเจ้าของโปรไฟล์อุปกรณ์ที่มีอยู่ทั้งหมดออกด้วยความพยายามอย่างดีที่สุด
removeUser
public abstract boolean removeUser (int userId)
ลบผู้ใช้ที่กำหนดออกจากอุปกรณ์
พารามิเตอร์ |
---|
userId | int : ของผู้ใช้ที่จะลบ |
การส่งคืน |
---|
boolean | จริงถ้าเราประสบความสำเร็จในการลบผู้ใช้เท็จเป็นอย่างอื่น |
setDeviceOwner
public abstract boolean setDeviceOwner (String componentName,
int userId)
ตั้งค่าส่วนประกอบผู้ดูแลระบบอุปกรณ์เป็นเจ้าของอุปกรณ์ในผู้ใช้ที่กำหนด
พารามิเตอร์ |
---|
componentName | String : ผู้ดูแลระบบอุปกรณ์เป็นเจ้าของอุปกรณ์ |
userId | int : ของผู้ใช้ที่เจ้าของอุปกรณ์อาศัยอยู่ |
การส่งคืน |
---|
boolean | จริงถ้ามันประสบความสำเร็จเท็จเป็นอย่างอื่น |
การตั้งค่า
public abstract void setSetting (String namespace,
String key,
String value)
ดู setSetting(int, String, String, String)
และดำเนินการกับผู้ใช้ระบบ
พารามิเตอร์ |
---|
namespace | String |
key | String |
value | String |
การตั้งค่า
public abstract void setSetting (int userId,
String namespace,
String key,
String value)
เพิ่มค่าการตั้งค่าให้กับเนมสเปซของผู้ใช้ที่กำหนด การตั้งค่าบางอย่างจะพร้อมใช้งานหลังจากรีบูตเท่านั้น เนมสเปซต้องเป็นหนึ่งใน: {"ระบบ", "ปลอดภัย", "ทั่วโลก"}
พารามิเตอร์ |
---|
userId | int |
namespace | String |
key | String |
value | String |
ผู้เริ่มต้น
public abstract boolean startUser (int userId)
เริ่มต้นผู้ใช้ที่กำหนดในพื้นหลังหากหยุดอยู่ในปัจจุบัน หากผู้ใช้ทำงานอยู่ในพื้นหลังแล้ววิธีนี้เป็น Noop
พารามิเตอร์ |
---|
userId | int : ของผู้ใช้ที่จะเริ่มต้นในพื้นหลัง |
การส่งคืน |
---|
boolean | จริงถ้าผู้ใช้เริ่มต้นได้สำเร็จในพื้นหลัง |
ผู้เริ่มต้น
public abstract boolean startUser (int userId,
boolean waitFlag)
เริ่มต้นผู้ใช้ที่กำหนดในพื้นหลังหากหยุดอยู่ในปัจจุบัน หากผู้ใช้ทำงานอยู่ในพื้นหลังแล้ววิธีนี้เป็น Noop เป็นไปได้ที่จะให้ธงพิเศษเพื่อรอให้การดำเนินการมีผล
พารามิเตอร์ |
---|
userId | int : ของผู้ใช้ที่จะเริ่มต้นในพื้นหลัง |
waitFlag | boolean : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มและปลดล็อค |
การส่งคืน |
---|
boolean | จริงถ้าผู้ใช้เริ่มต้นได้สำเร็จในพื้นหลัง |
startVisibleBackgroundUser
public abstract boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
เริ่มต้นผู้ใช้ที่กำหนดในพื้นหลังซึ่งมองเห็นได้ในการแสดงผลที่กำหนด (เช่นช่วยให้ผู้ใช้สามารถเปิดกิจกรรมในจอแสดงผลนั้น)
หมายเหตุ: คำสั่งนี้ไม่ได้ตรวจสอบว่าผู้ใช้มีอยู่หรือไม่แสดงให้เห็น device supports such feature
ฯลฯ
พารามิเตอร์ |
---|
userId | int : ของผู้ใช้ที่จะเริ่มต้นในพื้นหลัง |
displayId | int : แสดงเพื่อเริ่มต้นผู้ใช้ที่มองเห็นได้ |
waitFlag | boolean : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มและปลดล็อค |
การส่งคืน |
---|
boolean | true ถ้าผู้ใช้เริ่มมองเห็นได้สำเร็จในพื้นหลัง |
ผู้หยุดยั้ง
public abstract boolean stopUser (int userId)
หยุดผู้ใช้ที่กำหนด หากผู้ใช้หยุดแล้ววิธีนี้เป็น noop ไม่สามารถหยุดผู้ใช้ปัจจุบันและระบบ
พารามิเตอร์ |
---|
userId | int : ของผู้ใช้ที่จะหยุด |
การส่งคืน |
---|
boolean | จริงถ้าผู้ใช้หยุดสำเร็จ |
ผู้หยุดยั้ง
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
หยุดผู้ใช้ที่กำหนด เป็นไปได้ที่จะให้ธงพิเศษเพื่อรอให้การดำเนินการมีผลและบังคับให้ยุติผู้ใช้ ไม่สามารถหยุดผู้ใช้ปัจจุบันและระบบ
พารามิเตอร์ |
---|
userId | int : ของผู้ใช้ที่จะหยุด |
waitFlag | boolean : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะหยุด |
forceFlag | boolean : จะบังคับให้หยุดผู้ใช้ |
การส่งคืน |
---|
boolean | จริงถ้าผู้ใช้หยุดสำเร็จ |
เปลี่ยนผู้ใช้
public abstract boolean switchUser (int userId)
สลับไปยังผู้ใช้อื่นที่มีการหมดเวลาเริ่มต้น switchUser(int, long)
การส่งคืน |
---|
boolean | จริงถ้าผู้ใช้ใหม่ตรงกับผู้ให้บริการ USERID เท็จเป็นอย่างอื่น |
เปลี่ยนผู้ใช้
public abstract boolean switchUser (int userId,
long timeout)
สลับไปยังผู้ใช้อื่นที่มีการหมดเวลาที่ให้ไว้เป็นกำหนดเวลา พยายามปิดการใช้งาน KeyGuard หลังจากการเปลี่ยนแปลงของผู้ใช้สำเร็จ
พารามิเตอร์ |
---|
userId | int |
timeout | long : เพื่อรอก่อนที่จะส่งคืน FALSE สำหรับ Switch-user ล้มเหลว |
การส่งคืน |
---|
boolean | จริงถ้าผู้ใช้ใหม่ตรงกับผู้ให้บริการ USERID เท็จเป็นอย่างอื่น |
Takebugreport
public abstract Bugreport takeBugreport ()
ใช้ bupgreport และส่งคืนภายในวัตถุ Bugreport
เพื่อจัดการ ส่งคืนโมฆะในกรณีที่มีปัญหา ไฟล์ที่อ้างอิงในวัตถุ BUGREPORT จำเป็นต้องได้รับการทำความสะอาดผ่าน Bugreport.close()
ถอนการติดตั้ง
public abstract String uninstallPackage (String packageName)
ถอนการติดตั้งแพ็คเกจ Android จากอุปกรณ์
พารามิเตอร์ |
---|
packageName | String : แพ็คเกจ Android เพื่อถอนการติดตั้ง |
การส่งคืน |
---|
String | String ที่มีรหัสข้อผิดพลาดหรือ null หากประสบความสำเร็จ |
ถอนการติดตั้ง PackageForUser
public abstract String uninstallPackageForUser (String packageName,
int userId)
ถอนการติดตั้งแพ็คเกจ Android จากอุปกรณ์สำหรับผู้ใช้ที่กำหนด
พารามิเตอร์ |
---|
packageName | String : แพ็คเกจ Android เพื่อถอนการติดตั้ง |
userId | int : ID ผู้ใช้จำนวนเต็มเพื่อถอนการติดตั้ง |
การส่งคืน |
---|
String | String ที่มีรหัสข้อผิดพลาดหรือ null หากประสบความสำเร็จ |
Waitforsnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
หากคาดว่าจะรอให้ Snapuserd เสร็จสมบูรณ์
พารามิเตอร์ |
---|
currentPhase | SnapuserdWaitPhase |
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-04-02 UTC
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"ไม่มีข้อมูลที่ฉันต้องการ"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"ล้าสมัย"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ปัญหาเกี่ยวกับการแปล"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"อื่นๆ"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"เข้าใจง่าย"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"แก้ปัญหาของฉันได้"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"อื่นๆ"
}]
{
"last_modified": "อัปเดตล่าสุด 2024-04-02 UTC",
"state": ""
}