ลองคำสั่งอุปกรณ์ตามจำนวนที่กำหนดได้ และจัดเตรียมอินเทอร์เฟซการกู้คืนอุปกรณ์สำหรับอุปกรณ์ที่ไม่ตอบสนอง
คลาสที่ซ้อนกัน |
---|
class | ITestDevice.ApexInfo คลาส struct อย่างง่ายเพื่อเก็บข้อมูลเกี่ยวกับ APEX เดียว |
class | ITestDevice.MountPointInfo คลาส struct อย่างง่ายเพื่อเก็บข้อมูลเกี่ยวกับจุดเมานต์เดียว |
วิธีการสาธารณะ |
---|
abstract boolean | canSwitchToHeadlessSystemUser () ส่งคืนว่าอนุญาตให้เปลี่ยนเป็นผู้ใช้ SYSTEM ที่ไม่มีหัวหรือไม่ |
abstract boolean | checkConnectivity () ตรวจสอบว่าอุปกรณ์มีการเชื่อมต่อเครือข่าย |
abstract boolean | clearErrorDialogs () พยายามปิดกล่องโต้ตอบแสดงข้อผิดพลาดที่แสดงอยู่บน UI ของอุปกรณ์ในปัจจุบัน |
abstract void | clearLastConnectedWifiNetwork () ล้างเครือข่าย wifi ที่เชื่อมต่อล่าสุด |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) เชื่อมต่อกับเครือข่าย wifi |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) เชื่อมต่อกับเครือข่าย 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, boolean forTesting) สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ให้มา |
abstract int | createUser (String name, boolean guest, boolean ephemeral) สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ให้มา |
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 หากไม่พบจะเป็น null |
abstract | getAndroidIds () สร้างแผนที่ของรหัส android พบรหัสผู้ใช้ที่ตรงกัน |
abstract PackageInfo | getAppPackageInfo (String packageName) ดึงข้อมูลเกี่ยวกับแพ็คเกจที่ติดตั้งบนอุปกรณ์ |
abstract | getAppPackageInfos () ดึงข้อมูลแพ็คเกจที่ติดตั้งบนอุปกรณ์ |
abstract InputStreamSource | getBugreport () ดึงรายงานข้อผิดพลาดจากอุปกรณ์ |
abstract InputStreamSource | getBugreportz () ดึงรายงานข้อผิดพลาดจากอุปกรณ์ |
abstract DeviceFoldableState | getCurrentFoldableState () คืนค่าสถานะพับได้ปัจจุบันของอุปกรณ์หรือค่า null หากเกิดปัญหาบางอย่างขึ้น |
abstract int | getCurrentUser () ส่งคืน id ของผู้ใช้ที่กำลังทำงานอยู่ |
abstract | getFoldableStates () ส่งกลับรายการสถานะการพับบนอุปกรณ์ |
abstract | getInstalledPackageNames () ดึงชื่อแพ็คเกจแอปพลิเคชันที่มีอยู่ในอุปกรณ์ |
abstract String | getIpAddress () รับที่อยู่ IP ของอุปกรณ์ |
abstract KeyguardControllerState | getKeyguardState () ส่งคืนวัตถุเพื่อรับสถานะปัจจุบันของคีย์การ์ดหรือค่าว่างหากไม่รองรับ |
abstract Integer | getMainUserId () ส่งคืนรหัสผู้ใช้หลัก |
abstract | getMainlineModuleInfo () รับข้อมูลเกี่ยวกับโมดูล mainline ที่ติดตั้งบนอุปกรณ์ |
abstract int | getMaxNumberOfRunningUsersSupported () รับจำนวนสูงสุดที่รองรับผู้ใช้ที่รันพร้อมกัน |
abstract int | getMaxNumberOfUsersSupported () รับจำนวนผู้ใช้ที่รองรับสูงสุด |
abstract TestDeviceOptions | getOptions () เรียกตัวเลือกการทดสอบสำหรับอุปกรณ์ |
abstract Integer | getPrimaryUserId () ส่งคืนรหัสผู้ใช้หลัก |
abstract InputStreamSource | getScreenshot () จับภาพหน้าจอจากอุปกรณ์ |
abstract InputStreamSource | getScreenshot (String format, boolean rescale) จับภาพหน้าจอจากอุปกรณ์ |
abstract InputStreamSource | getScreenshot (String format) จับภาพหน้าจอจากอุปกรณ์ |
abstract InputStreamSource | getScreenshot (long displayId) จับภาพหน้าจอจากอุปกรณ์ที่ระบุ ID ที่แสดง |
abstract String | getSetting (String namespace, String key) ดู getSetting(int, String, String) และดำเนินการกับผู้ใช้ระบบ |
abstract String | getSetting (int userId, String namespace, String key) ส่งกลับค่าของการตั้งค่าที่ร้องขอ |
abstract | getUninstallablePackageNames () เรียกค้นชื่อแพ็กเกจแอปพลิเคชันที่สามารถถอนการติดตั้งได้ |
abstract int | getUserFlags (int userId) ค้นหาและส่งคืนแฟล็กของผู้ใช้ที่กำหนด |
abstract | getUserInfos () รับแผนที่ของ useId ไปยัง UserInfo บนอุปกรณ์ |
abstract int | getUserSerialNumber (int userId) ส่งคืนหมายเลขซีเรียลที่เกี่ยวข้องกับ userId หากพบ -10,000 ในกรณีอื่นๆ |
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, boolean grantPermissions, int userId, String... extraArgs) ติดตั้งแพ็คเกจ Android บนอุปกรณ์สำหรับผู้ใช้ที่ระบุ |
abstract String | installPackageForUser (File packageFile, boolean reinstall, 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, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็คเกจแยกหลักและแยกพิเศษหนึ่งแพ็คเกจ) สำหรับผู้ใช้ที่กำหนด |
default String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, 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 () ส่งคืนว่าอุปกรณ์ใช้โหมดผู้ใช้ระบบหัวขาดหรือไม่ |
abstract boolean | isMainUserPermanentAdmin () ส่งคืนว่าผู้ใช้หลักเป็นผู้ดูแลระบบถาวรและไม่สามารถลบหรือลดระดับเป็นสถานะที่ไม่ใช่ผู้ดูแลระบบ |
abstract boolean | isMultiUserSupported () กำหนดว่ารองรับผู้ใช้หลายคนหรือไม่ |
abstract boolean | isPackageInstalled (String packageName) สอบถามอุปกรณ์สำหรับชื่อแพ็คเกจที่กำหนดเพื่อตรวจสอบว่าติดตั้งอยู่หรือไม่ |
abstract boolean | isPackageInstalled (String packageName, String userId) ค้นหาอุปกรณ์สำหรับชื่อแพ็คเกจที่กำหนดและรหัสผู้ใช้ที่กำหนดเพื่อตรวจสอบว่าติดตั้งอยู่หรือไม่สำหรับผู้ใช้รายนั้น |
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 () รวบรวมรายชื่อ display id ที่มีอยู่บนอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger" |
abstract | listDisplayIdsForStartingVisibleBackgroundUsers () รับรายการจอแสดงผลที่สามารถใช้เพื่อ start a user visible in the background |
abstract | listUsers () รับรายชื่อผู้ใช้บนอุปกรณ์ |
abstract boolean | logBugreport (String dataName, ITestLogger listener) วิธีการช่วยเหลือในการรายงานข้อผิดพลาดและบันทึกไปยังนักข่าว |
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, boolean waitFlag, boolean forceFlag) หยุดผู้ใช้ที่กำหนด |
abstract boolean | stopUser (int userId) หยุดผู้ใช้ที่กำหนด |
abstract boolean | switchUser (int 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 จากอุปกรณ์สำหรับผู้ใช้ที่กำหนด |
วิธีการสาธารณะ
สามารถสลับเป็น HeadlessSystemUser
public abstract boolean canSwitchToHeadlessSystemUser ()
ส่งคืนว่าอนุญาตให้เปลี่ยนเป็นผู้ใช้ SYSTEM ที่ไม่มีหัวหรือไม่
ตรวจสอบการเชื่อมต่อ
public abstract boolean checkConnectivity ()
ตรวจสอบว่าอุปกรณ์มีการเชื่อมต่อเครือข่าย
ส่งคืน |
---|
boolean | true หากอุปกรณ์มีการเชื่อมต่อเครือข่ายที่ใช้งานได้ false |
clearErrorDialogs
public abstract boolean clearErrorDialogs ()
พยายามปิดกล่องโต้ตอบแสดงข้อผิดพลาดที่แสดงอยู่บน UI ของอุปกรณ์ในปัจจุบัน
ส่งคืน |
---|
boolean | true ถ้าไม่มีไดอะล็อกหรือไดอะล็อกถูกล้างสำเร็จ false อย่างอื่น |
clearLastConnectedWifiNetwork
public abstract void clearLastConnectedWifiNetwork ()
ล้างเครือข่าย wifi ที่เชื่อมต่อล่าสุด ควรเรียกสิ่งนี้เมื่อเริ่มการร้องขอใหม่เพื่อหลีกเลี่ยงการเชื่อมต่อกับเครือข่าย wifi ที่ใช้ในการทดสอบครั้งก่อนหลังจากรีบูตอุปกรณ์
connectToWifiเครือข่าย
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk,
boolean scanSsid)
เชื่อมต่อกับเครือข่าย wifi
เปิด wifi และบล็อกจนกว่าจะทำการเชื่อมต่อสำเร็จกับหนึ่งในเครือข่าย wifi ที่กำหนดในแผนที่ wifiSsidToPsk เมื่อสร้างการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามกู้คืนการเชื่อมต่อหลังจากรีบูตทุกครั้งจนกว่าจะมีการเรียก ITestDevice#disconnectFromWifi()
หรือ ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ |
---|
wifiSsidToPsk | : แผนที่ของ wifi SSIDs กับรหัสผ่าน |
scanSsid | boolean : จะสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่ |
ส่งคืน |
---|
boolean | true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false อย่างอื่น |
connectToWifiเครือข่าย
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)
เชื่อมต่อกับเครือข่าย wifi
เปิด wifi และบล็อกจนกว่าจะทำการเชื่อมต่อสำเร็จกับหนึ่งในเครือข่าย wifi ที่กำหนดในแผนที่ wifiSsidToPsk เมื่อสร้างการเชื่อมต่อแล้ว อินสแตนซ์จะพยายามกู้คืนการเชื่อมต่อหลังจากรีบูตทุกครั้งจนกว่าจะมีการเรียก ITestDevice#disconnectFromWifi()
หรือ ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ |
---|
wifiSsidToPsk | : แผนที่ของ wifi SSIDs กับรหัสผ่าน |
ส่งคืน |
---|
boolean | true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false อย่างอื่น |
connectToWifiเครือข่าย
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 อย่างอื่น |
connectToWifiเครือข่าย
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 อย่างอื่น |
connectToWifiNetworkถ้าจำเป็น
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)
ตัวแปรของ connectToWifiNetwork(String, String)
ที่เชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ไม่มีการเชื่อมต่อเครือข่ายในปัจจุบัน
พารามิเตอร์ |
---|
scanSsid | boolean : จะสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่ |
ส่งคืน |
---|
boolean | true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false อย่างอื่น |
connectToWifiNetworkถ้าจำเป็น
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)
ตัวแปรของ connectToWifiNetwork(String, String)
ที่เชื่อมต่อเฉพาะในกรณีที่อุปกรณ์ไม่มีการเชื่อมต่อเครือข่ายในปัจจุบัน
ส่งคืน |
---|
boolean | true หากเชื่อมต่อกับเครือข่าย wifi สำเร็จ false อย่างอื่น |
สร้างผู้ใช้
public abstract int createUser (String name)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0
พารามิเตอร์ |
---|
name | String : ของผู้ใช้ที่จะสร้างบนอุปกรณ์ |
ส่งคืน |
---|
int | จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้น |
สร้างผู้ใช้
public abstract int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ให้มา
พารามิเตอร์ |
---|
name | String : ของผู้ใช้ที่จะสร้างบนอุปกรณ์ |
guest | boolean : เปิดใช้งานแฟล็กผู้ใช้ --guest ระหว่างการสร้าง |
ephemeral | boolean : เปิดใช้งานแฟล็กผู้ใช้ -- ชั่วคราวระหว่างการสร้าง |
forTesting | boolean : เปิดใช้งานแฟล็กทดสอบ --for-testing ระหว่างการสร้าง |
ส่งคืน |
---|
int | รหัสของผู้ใช้ที่สร้างขึ้น |
สร้างผู้ใช้
public abstract int createUser (String name,
boolean guest,
boolean ephemeral)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ให้มา
พารามิเตอร์ |
---|
name | String : ของผู้ใช้ที่จะสร้างบนอุปกรณ์ |
guest | boolean : เปิดใช้งานแฟล็กผู้ใช้ --guest ระหว่างการสร้าง |
ephemeral | boolean : เปิดใช้งานแฟล็กผู้ใช้ -- ชั่วคราวระหว่างการสร้าง |
ส่งคืน |
---|
int | รหัสของผู้ใช้ที่สร้างขึ้น |
สร้าง UserNoThrow
public abstract int createUserNoThrow (String name)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0
พารามิเตอร์ |
---|
name | String : ของผู้ใช้ที่จะสร้างบนอุปกรณ์ |
ส่งคืน |
---|
int | จำนวนเต็มสำหรับ ID ผู้ใช้ที่สร้างขึ้นหรือ -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 หากการตัดการเชื่อมต่อล้มเหลว |
มีไฟล์อยู่
public abstract boolean doesFileExist (String deviceFilePath,
int userId)
วิธีการช่วยเหลือเพื่อตรวจสอบว่ามีไฟล์บนอุปกรณ์สำหรับผู้ใช้ที่กำหนดหรือไม่
พารามิเตอร์ |
---|
deviceFilePath | String : เส้นทางที่แน่นอนของไฟล์บนอุปกรณ์ที่จะตรวจสอบ |
userId | int : รหัสผู้ใช้ที่ใช้ตรวจสอบการมีอยู่ของไฟล์ |
ส่งคืน |
---|
boolean | true ถ้ามีไฟล์อยู่ มิฉะนั้นจะ false |
กองขยะ
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"} |
ส่งคืน |
---|
| แผนที่ของคู่ค่าคีย์ เป็นโมฆะหากไม่รองรับเนมสเปซ |
รับรหัส Android
public abstract String getAndroidId (int userId)
ค้นหาและส่งคืน android-id ที่เชื่อมโยงกับ userId หากไม่พบจะเป็น null
รับรหัส Android
public abstract getAndroidIds ()
สร้างแผนที่ของรหัส android พบรหัสผู้ใช้ที่ตรงกัน ไม่มีการประกันว่ารหัสผู้ใช้แต่ละรหัสจะพบรหัส Android ที่เชื่อมโยงในฟังก์ชันนี้ ดังนั้นรหัสผู้ใช้บางรายการอาจตรงกับค่าว่าง
ส่งคืน |
---|
| แผนที่ของรหัส android พบรหัสผู้ใช้ที่ตรงกัน |
getAppPackageInfo
public abstract PackageInfo getAppPackageInfo (String packageName)
ดึงข้อมูลเกี่ยวกับแพ็คเกจที่ติดตั้งบนอุปกรณ์
พารามิเตอร์ |
---|
packageName | String |
getAppPackageInfos
public abstract getAppPackageInfos ()
ดึงข้อมูลแพ็คเกจที่ติดตั้งบนอุปกรณ์
getBugreport
public abstract InputStreamSource getBugreport ()
ดึงรายงานข้อผิดพลาดจากอุปกรณ์
การดำเนินการนี้รับประกันว่าจะทำงานต่อไปบนอุปกรณ์ที่ไม่มี sdcard (หรือเมื่อยังไม่ได้ติดตั้ง sdcard)
getBugreportz
public abstract InputStreamSource getBugreportz ()
ดึงรายงานข้อผิดพลาดจากอุปกรณ์ รายงานข้อบกพร่องรูปแบบ Zip ประกอบด้วยรายงานข้อบกพร่องหลักและไฟล์บันทึกอื่นๆ ที่เป็นประโยชน์สำหรับการดีบัก
รองรับเฉพาะ 'adb version' > 1.0.36
getCurrentFoldableState
public abstract DeviceFoldableState getCurrentFoldableState ()
คืนค่าสถานะพับได้ปัจจุบันของอุปกรณ์หรือค่า null หากเกิดปัญหาบางอย่างขึ้น
รับผู้ใช้ปัจจุบัน
public abstract int getCurrentUser ()
ส่งคืน id ของผู้ใช้ที่กำลังทำงานอยู่ ในกรณีที่เกิดข้อผิดพลาด ให้ส่งคืน -10,000
getFoldableStates
public abstract getFoldableStates ()
ส่งกลับรายการสถานะการพับบนอุปกรณ์ สามารถรับได้ด้วย "cmd device_state print-state"
รับติดตั้งชื่อแพ็คเกจ
public abstract getInstalledPackageNames ()
ดึงชื่อแพ็คเกจแอปพลิเคชันที่มีอยู่ในอุปกรณ์
รับที่อยู่ IP
public abstract String getIpAddress ()
รับที่อยู่ IP ของอุปกรณ์
ส่งคืน |
---|
String | ที่อยู่ IP ของอุปกรณ์ หรือ null หากอุปกรณ์ไม่มีที่อยู่ IP |
รับ KeyguardState
public abstract KeyguardControllerState getKeyguardState ()
ส่งคืนวัตถุเพื่อรับสถานะปัจจุบันของคีย์การ์ดหรือค่าว่างหากไม่รองรับ
รับรหัสผู้ใช้หลัก
public abstract Integer getMainUserId ()
ส่งคืนรหัสผู้ใช้หลัก
ส่งคืน |
---|
Integer | userId ของผู้ใช้หลักถ้ามี และ null หากไม่มีผู้ใช้หลัก |
รับMainlineModuleInfo
public abstract getMainlineModuleInfo ()
รับข้อมูลเกี่ยวกับโมดูล mainline ที่ติดตั้งบนอุปกรณ์
public abstract int getMaxNumberOfRunningUsersSupported ()
รับจำนวนสูงสุดที่รองรับผู้ใช้ที่รันพร้อมกัน ค่าเริ่มต้นเป็น 0
ส่งคืน |
---|
int | จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่รันพร้อมกัน |
public abstract int getMaxNumberOfUsersSupported ()
รับจำนวนผู้ใช้ที่รองรับสูงสุด ค่าเริ่มต้นเป็น 0
ส่งคืน |
---|
int | จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่รองรับ |
รับตัวเลือก
public abstract TestDeviceOptions getOptions ()
เรียกตัวเลือกการทดสอบสำหรับอุปกรณ์
รับรหัสผู้ใช้หลัก
public abstract Integer getPrimaryUserId ()
ส่งคืนรหัสผู้ใช้หลัก
ส่งคืน |
---|
Integer | userId ของผู้ใช้หลักถ้ามี และ null หากไม่มีผู้ใช้หลัก |
รับสกรีนช็อต
public abstract InputStreamSource getScreenshot ()
จับภาพหน้าจอจากอุปกรณ์
รับสกรีนช็อต
public abstract InputStreamSource getScreenshot (String format,
boolean rescale)
จับภาพหน้าจอจากอุปกรณ์ แนะนำให้ใช้ getScreenshot(String)
แทนการเข้ารหัส JPEG สำหรับขนาดที่เล็กลง
พารามิเตอร์ |
---|
format | String : รองรับ PNG, JPEG |
rescale | boolean : ถ้าภาพหน้าจอควรปรับขนาดใหม่เพื่อลดขนาดของภาพที่ได้ |
รับสกรีนช็อต
public abstract InputStreamSource getScreenshot (String format)
จับภาพหน้าจอจากอุปกรณ์ แนะนำให้ใช้ getScreenshot(รูปแบบ) แทนการเข้ารหัส JPEG สำหรับขนาดที่เล็กลง
พารามิเตอร์ |
---|
format | String : รองรับ PNG, JPEG |
รับสกรีนช็อต
public abstract InputStreamSource getScreenshot (long displayId)
จับภาพหน้าจอจากอุปกรณ์ที่ระบุ ID ที่แสดง รูปแบบคือ PNG
สิ่งที่ต้องทำ: ขยายการใช้งานด้านบนเพื่อรองรับ 'รูปแบบ' และ 'ปรับขนาด'
พารามิเตอร์ |
---|
displayId | long : รหัสการแสดงผลของหน้าจอที่จะรับภาพหน้าจอ |
รับการตั้งค่า
public abstract String getSetting (String namespace,
String key)
ดู getSetting(int, String, String)
และดำเนินการกับผู้ใช้ระบบ
พารามิเตอร์ |
---|
namespace | String |
key | String |
รับการตั้งค่า
public abstract String getSetting (int userId,
String namespace,
String key)
ส่งกลับค่าของการตั้งค่าที่ร้องขอ เนมสเปซต้องเป็นหนึ่งใน: {"system", "secure", "global"}
พารามิเตอร์ |
---|
userId | int |
namespace | String |
key | String |
ส่งคืน |
---|
String | ค่าที่เกี่ยวข้องกับ namespace:key ของผู้ใช้ เป็นโมฆะหากไม่พบ |
getUninstallablePackageNames
public abstract getUninstallablePackageNames ()
เรียกค้นชื่อแพ็กเกจแอปพลิเคชันที่สามารถถอนการติดตั้งได้ ปัจจุบันนี้ถูกกำหนดเป็นแพ็คเกจที่ไม่ใช่ระบบและแพ็คเกจระบบที่อัปเดต
getUserFlags
public abstract int getUserFlags (int userId)
ค้นหาและส่งคืนแฟล็กของผู้ใช้ที่กำหนด ค่าสถานะถูกกำหนดในคลาส "android.content.pm.UserInfo" ใน Android Open Source Project
ส่งคืน |
---|
int | แฟล็กที่เกี่ยวข้องกับ userId ที่ระบุหากพบ -10,000 ในกรณีอื่นๆ |
รับข้อมูลผู้ใช้
public abstract getUserInfos ()
รับแผนที่ของ useId ไปยัง UserInfo
บนอุปกรณ์ จะโยน DeviceRuntimeException
หากเอาต์พุตจากอุปกรณ์ไม่เป็นไปตามที่คาดไว้
ส่งคืน |
---|
| รายการวัตถุ UserInfo |
พ่น |
---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException | |
รับ UserSerialNumber
public abstract int getUserSerialNumber (int userId)
ส่งคืนหมายเลขซีเรียลที่เกี่ยวข้องกับ userId หากพบ -10,000 ในกรณีอื่นๆ
มีคุณสมบัติ
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' สำหรับตัวเลือกที่มี |
ติดตั้งแพ็คเกจ
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' สำหรับตัวเลือกที่มี |
ติดตั้ง 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 : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง |
extraArgs | String : อาร์กิวเมนต์เพิ่มเติมที่จะส่งผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี |
ติดตั้ง PackageForUser
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' สำหรับตัวเลือกที่มี |
ติดตั้งแพ็คเกจ
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' สำหรับตัวเลือกที่มี |
ติดตั้งแพ็คเกจ
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' สำหรับตัวเลือกที่มี |
installPackagesForUser
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 : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง |
extraArgs | String : อาร์กิวเมนต์เพิ่มเติมที่จะส่งผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี |
installPackagesForUser
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 : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง |
extraArgs | String : อาร์กิวเมนต์เพิ่มเติมที่จะส่งผ่าน ดู 'adb shell pm -h' สำหรับตัวเลือกที่มี |
ติดตั้งแพ็คเกจระยะไกล
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' สำหรับตัวเลือกที่มี |
ติดตั้งแพ็คเกจระยะไกล
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' สำหรับตัวเลือกที่มี |
isHeadlessSystemUserMode
public abstract boolean isHeadlessSystemUserMode ()
ส่งคืนว่าอุปกรณ์ใช้โหมดผู้ใช้ระบบหัวขาดหรือไม่
isMainUserPermanentAdmin
public abstract boolean isMainUserPermanentAdmin ()
ส่งคืนว่าผู้ใช้หลักเป็นผู้ดูแลระบบถาวรและไม่สามารถลบหรือลดระดับเป็นสถานะที่ไม่ใช่ผู้ดูแลระบบ
รองรับ MultiUser
public abstract boolean isMultiUserSupported ()
กำหนดว่ารองรับผู้ใช้หลายคนหรือไม่
ส่งคืน |
---|
boolean | จริงหากรองรับผู้ใช้หลายคน มิฉะนั้นจะเป็นเท็จ |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName)
สอบถามอุปกรณ์สำหรับชื่อแพ็คเกจที่กำหนดเพื่อตรวจสอบว่าติดตั้งอยู่หรือไม่
พารามิเตอร์ |
---|
packageName | String |
ส่งคืน |
---|
boolean | จริงหากมีการรายงานแพ็คเกจว่าติดตั้งแล้ว เป็นอย่างอื่น |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName,
String userId)
ค้นหาอุปกรณ์สำหรับชื่อแพ็คเกจที่กำหนดและรหัสผู้ใช้ที่กำหนดเพื่อตรวจสอบว่าติดตั้งอยู่หรือไม่สำหรับผู้ใช้รายนั้น
พารามิเตอร์ |
---|
packageName | String : แพ็คเกจที่เรากำลังตรวจสอบว่ามีการติดตั้งหรือไม่ |
userId | 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 |
isWifiเปิดใช้งาน
public abstract boolean isWifiEnabled ()
ทดสอบว่าเปิดใช้งาน wifi หรือไม่
ตรวจสอบว่าเปิดใช้งาน wifi บนอุปกรณ์หรือไม่ มีประโยชน์สำหรับการยืนยันสถานะ wifi ก่อนการทดสอบที่ไม่ควรใช้กับ wifi เช่น การทดสอบข้อมูลมือถือ
ส่งคืน |
---|
boolean | true หากเปิดใช้งาน wifi false หากปิดใช้งาน |
รายการรหัสที่แสดง
public abstract listDisplayIds ()
รวบรวมรายชื่อ display id ที่มีอยู่บนอุปกรณ์ตามที่รายงานโดย "dumpsys SurfaceFlinger"
ส่งคืน |
---|
| รายการของจอแสดงผล ค่าเริ่มต้นจะคืนค่าการแสดงผลเริ่มต้นเป็น 0 เสมอ |
รายการผู้ใช้
public abstract listUsers ()
รับรายชื่อผู้ใช้บนอุปกรณ์ จะโยน DeviceRuntimeException
หากเอาต์พุตจากอุปกรณ์ไม่เป็นไปตามที่คาดไว้
พ่น |
---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException | |
logBugreport
public abstract boolean logBugreport (String dataName,
ITestLogger listener)
วิธีการช่วยเหลือในการรายงานข้อผิดพลาดและบันทึกไปยังนักข่าว
พารามิเตอร์ |
---|
dataName | String : ชื่อที่จะรายงานข้อบกพร่อง |
listener | ITestLogger : ITestLogger เพื่อบันทึกรายงานข้อบกพร่อง |
ส่งคืน |
---|
boolean | เป็นจริงหากการบันทึกสำเร็จ มิฉะนั้นจะเป็นเท็จ |
ลบผู้ดูแลระบบ
public abstract boolean removeAdmin (String componentName,
int userId)
ลบผู้ดูแลระบบอุปกรณ์ที่กำหนดในผู้ใช้ที่กำหนดและคืน true
หากสำเร็จ หากเป็น false
ฉะนั้น
พารามิเตอร์ |
---|
componentName | String : ของผู้ดูแลระบบอุปกรณ์ที่จะถูกลบ |
userId | int : ของผู้ใช้ที่ผู้ดูแลระบบอุปกรณ์อาศัยอยู่ |
ส่งคืน |
---|
boolean | เป็นจริงหากสำเร็จ มิฉะนั้นจะเป็นเท็จ |
ลบเจ้าของ
public abstract void removeOwners ()
ลบเจ้าของโปรไฟล์อุปกรณ์ที่มีอยู่ทั้งหมดด้วยความพยายามที่ดีที่สุด
ลบผู้ใช้
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)
เพิ่มการตั้งค่าให้กับเนมสเปซของผู้ใช้ที่กำหนด การตั้งค่าบางอย่างจะใช้ได้หลังจากรีบูตเท่านั้น เนมสเปซต้องเป็นหนึ่งใน: {"system", "secure", "global"}
พารามิเตอร์ |
---|
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,
boolean waitFlag,
boolean forceFlag)
หยุดผู้ใช้ที่กำหนด สามารถตั้งค่าสถานะเพิ่มเติมเพื่อรอให้การดำเนินการมีผล และบังคับยุติผู้ใช้ ไม่สามารถหยุดผู้ใช้ปัจจุบันและระบบ
พารามิเตอร์ |
---|
userId | int : ของผู้ใช้ที่จะหยุด |
waitFlag | boolean : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะหยุดทำงาน |
forceFlag | boolean : จะบังคับให้หยุดผู้ใช้ |
ส่งคืน |
---|
boolean | จริงถ้าหยุดผู้ใช้ได้สำเร็จ |
หยุดผู้ใช้
public abstract boolean stopUser (int userId)
หยุดผู้ใช้ที่กำหนด หากผู้ใช้หยุดทำงานแล้ว วิธีนี้ถือเป็น NOOP ไม่สามารถหยุดผู้ใช้ปัจจุบันและระบบ
พารามิเตอร์ |
---|
userId | int : ของผู้ใช้ที่จะหยุด |
ส่งคืน |
---|
boolean | จริงถ้าหยุดผู้ใช้ได้สำเร็จ |
เปลี่ยนผู้ใช้
public abstract boolean switchUser (int userId)
เปลี่ยนไปใช้รหัสผู้ใช้อื่นโดยหมดเวลาเริ่มต้น switchUser(int, long)
ส่งคืน |
---|
boolean | เป็นจริงหากรหัสผู้ใช้ใหม่ตรงกับผู้ให้บริการรหัสผู้ใช้ เป็นอย่างอื่น |
เปลี่ยนผู้ใช้
public abstract boolean switchUser (int userId,
long timeout)
เปลี่ยนไปใช้ userId อื่นโดยหมดเวลาที่กำหนดไว้ตามกำหนดเวลา พยายามปิดใช้งานคีย์การ์ดหลังจากเปลี่ยนผู้ใช้สำเร็จ
พารามิเตอร์ |
---|
userId | int |
timeout | long : เพื่อรอก่อนที่จะส่งคืนค่าเท็จสำหรับผู้ใช้สวิตช์ที่ล้มเหลว |
ส่งคืน |
---|
boolean | เป็นจริงหากรหัสผู้ใช้ใหม่ตรงกับผู้ให้บริการรหัสผู้ใช้ เป็นอย่างอื่น |
TakeBugreport
public abstract Bugreport takeBugreport ()
รับรายงานจุดบกพร่องและส่งคืนภายในวัตถุรายงานจุด Bugreport
เพื่อจัดการ คืนค่า null ในกรณีที่มีปัญหา ไฟล์ที่อ้างอิงในวัตถุ Bugreport จะต้องถูกล้างผ่าน Bugreport.close()
ถอนการติดตั้งแพ็คเกจ
public abstract String uninstallPackage (String packageName)
ถอนการติดตั้งแพ็คเกจ Android จากอุปกรณ์
พารามิเตอร์ |
---|
packageName | String : แพ็คเกจ Android ที่จะถอนการติดตั้ง |
ถอนการติดตั้ง PackageForUser
public abstract String uninstallPackageForUser (String packageName,
int userId)
ถอนการติดตั้งแพ็คเกจ Android จากอุปกรณ์สำหรับผู้ใช้ที่กำหนด
พารามิเตอร์ |
---|
packageName | String : แพ็คเกจ Android ที่จะถอนการติดตั้ง |
userId | int : รหัสผู้ใช้จำนวนเต็มที่จะถอนการติดตั้ง |
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2023-04-28 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":"อื่นๆ"
}]