อุปกรณ์ทดสอบ
public
interface
ITestDevice
implements
INativeDevice
com.android.tradefed.device.ITestDevice
|
มี API ระดับที่เชื่อถือได้และสูงกว่าเล็กน้อยสำหรับ ddmlib IDevice
ลองส่งคำสั่งของอุปกรณ์อีกครั้งในจำนวนที่กำหนดค่าได้ และให้กู้คืนอุปกรณ์
สำหรับอุปกรณ์ที่ไม่ตอบสนอง
สรุป
วิธีการสาธารณะ |
abstract
boolean
|
canSwitchToHeadlessSystemUser()
แสดงผลว่าจะอนุญาตให้เปลี่ยนไปใช้ผู้ใช้ SYSTEM แบบไม่มีส่วนหัวหรือไม่
|
abstract
boolean
|
checkConnectivity()
ตรวจสอบว่าอุปกรณ์มีการเชื่อมต่อเครือข่าย
|
abstract
boolean
|
clearErrorDialogs()
พยายามปิดกล่องโต้ตอบข้อผิดพลาดใดๆ ที่แสดงอยู่ใน UI ของอุปกรณ์
|
abstract
void
|
clearLastConnectedWifiNetwork()
ล้างเครือข่าย Wi-Fi ที่เชื่อมต่อล่าสุด
|
abstract
boolean
|
connectToWifiNetwork( wifiSsidToPsk)
เชื่อมต่อกับเครือข่าย Wi-Fi
|
abstract
boolean
|
connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)
เชื่อมต่อกับเครือข่าย Wi-Fi
|
abstract
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
เชื่อมต่อกับเครือข่าย Wi-Fi
|
abstract
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
เชื่อมต่อกับเครือข่าย Wi-Fi
|
abstract
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
ตัวแปรของ connectToWifiNetwork(String, String) ที่จะเชื่อมต่อเมื่ออุปกรณ์เท่านั้น
ตอนนี้ไม่ได้เชื่อมต่อเครือข่าย
|
abstract
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
ตัวแปรของ connectToWifiNetwork(String, String) ที่จะเชื่อมต่อเมื่ออุปกรณ์เท่านั้น
ตอนนี้ไม่ได้เชื่อมต่อเครือข่าย
|
abstract
int
|
createUser(String name)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 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()
ยกเลิกการเชื่อมต่อกับเครือข่าย Wi-Fi
|
abstract
boolean
|
doesFileExist(String deviceFilePath, int userId)
เมธอดของตัวช่วยในการระบุว่าผู้ใช้หนึ่งๆ มีไฟล์อยู่ในอุปกรณ์หรือไม่
|
abstract
File
|
dumpHeap(String process, String devicePath)
พยายามดัมพ์ฮีปจาก system_server
|
abstract
boolean
|
enableNetworkMonitor()
เปิดใช้การตรวจสอบเครือข่ายในอุปกรณ์
|
abstract
|
getActiveApexes()
ดึงข้อมูลเกี่ยวกับ APEX ที่เปิดใช้งานในอุปกรณ์
|
abstract
|
getAllSettings(String namespace)
แสดงผลคู่คีย์-ค่าของเนมสเปซที่ขอ
|
abstract
String
|
getAndroidId(int userId)
ค้นหาและแสดงผล android-id ที่เชื่อมโยงกับ userId หากไม่พบ
|
abstract
|
getAndroidIds()
สร้างแผนที่รหัส Android ที่พบรหัสผู้ใช้ที่ตรงกัน
|
abstract
PackageInfo
|
getAppPackageInfo(String packageName)
ดึงข้อมูลเกี่ยวกับแพ็กเกจที่ติดตั้งในอุปกรณ์
|
abstract
|
getAppPackageInfos()
ดึงข้อมูลของแพ็กเกจที่ติดตั้งในอุปกรณ์
|
abstract
InputStreamSource
|
getBugreport()
เรียกรายงานข้อบกพร่องจากอุปกรณ์
|
abstract
InputStreamSource
|
getBugreportz()
ดึง Bugreportz จากอุปกรณ์
|
abstract
DeviceFoldableState
|
getCurrentFoldableState()
แสดงผลสถานะปัจจุบันของอุปกรณ์หรือค่า Null หากเกิดปัญหาขึ้น
|
abstract
int
|
getCurrentUser()
แสดงผล ID ของผู้ใช้ปัจจุบันที่กำลังทำงานอยู่
|
abstract
|
getFoldableStates()
แสดงรายการสถานะพับได้ในอุปกรณ์
|
abstract
|
getInstalledPackageNames()
ดึงข้อมูลชื่อแพ็กเกจของแอปพลิเคชันที่มีอยู่ในอุปกรณ์
|
abstract
String
|
getIpAddress()
รับที่อยู่ IP ของอุปกรณ์
|
abstract
KeyguardControllerState
|
getKeyguardState()
แสดงผลออบเจ็กต์เพื่อรับสถานะปัจจุบันของคีย์การ์ดหรือ Null หากไม่รองรับ
|
abstract
Integer
|
getMainUserId()
แสดงผล User-ID หลัก
|
abstract
|
getMainlineModuleInfo()
ดูข้อมูลเกี่ยวกับโมดูลเมนไลน์ที่ติดตั้งในอุปกรณ์
|
abstract
int
|
getMaxNumberOfRunningUsersSupported()
รับจำนวนผู้ใช้งานพร้อมกันที่รองรับสูงสุด
|
abstract
int
|
getMaxNumberOfUsersSupported()
รับจํานวนผู้ใช้ที่รองรับสูงสุด
|
abstract
TestDeviceOptions
|
getOptions()
ดึงข้อมูลตัวเลือกการทดสอบสำหรับอุปกรณ์
|
abstract
Integer
|
getPrimaryUserId()
แสดงผล User-ID หลัก
|
abstract
InputStreamSource
|
getScreenshot(String format, boolean rescale)
ดึงภาพหน้าจอจากอุปกรณ์
|
abstract
InputStreamSource
|
getScreenshot(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)
แสดงผลหมายเลขซีเรียลที่เชื่อมโยงกับ userId หากพบ ซึ่งก็คือ -10000 ในกรณีอื่นๆ
|
abstract
boolean
|
hasFeature(String feature)
ตรวจสอบว่าฟีเจอร์พร้อมใช้งานในอุปกรณ์หรือไม่
|
abstract
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์
|
abstract
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์
|
abstract
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์สำหรับผู้ใช้ที่กำหนด
|
abstract
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์สำหรับผู้ใช้ที่กำหนด
|
default
String
|
installPackages( packageFiles, boolean reinstall, String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างขึ้นจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลักและแพ็กเกจแยกเพิ่มเติม 1 แพ็กเกจ)
|
default
String
|
installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างขึ้นจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลักและแพ็กเกจแยกเพิ่มเติม 1 แพ็กเกจ)
ที่อยู่ในอุปกรณ์ Android
|
default
String
|
installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างขึ้นจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลักและแพ็กเกจแยกเพิ่มเติม 1 แพ็กเกจ)
สำหรับผู้ใช้หนึ่งๆ
|
default
String
|
installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างขึ้นจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลักและแพ็กเกจแยกเพิ่มเติม 1 แพ็กเกจ)
สำหรับผู้ใช้หนึ่งๆ
|
default
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างขึ้นจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลักและแพ็กเกจแยกเพิ่มเติม 1 แพ็กเกจ)
ที่อยู่ในอุปกรณ์ Android
|
default
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างขึ้นจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลักและแพ็กเกจแยกเพิ่มเติม 1 แพ็กเกจ)
ที่อยู่ในอุปกรณ์ Android
|
abstract
boolean
|
isHeadlessSystemUserMode()
แสดงผลว่าอุปกรณ์ใช้โหมดผู้ใช้ระบบแบบไม่มีส่วนหัวหรือไม่
|
abstract
boolean
|
isMainUserPermanentAdmin()
แสดงผลว่าผู้ใช้หลักเป็นผู้ดูแลระบบแบบถาวร และไม่สามารถลบหรือดาวน์เกรดเป็น
สถานะที่ไม่ใช่ผู้ดูแลระบบ
|
abstract
boolean
|
isMultiUserSupported()
กำหนดว่ารองรับผู้ใช้หลายคนหรือไม่
|
abstract
boolean
|
isPackageInstalled(String packageName, String userId)
ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจที่ระบุและรหัสผู้ใช้ที่ระบุเพื่อตรวจสอบว่าอุปกรณ์ดังกล่าวใช้อยู่ในปัจจุบัน
ติดตั้งหรือไม่สำหรับผู้ใช้นั้น
|
abstract
boolean
|
isPackageInstalled(String packageName)
ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจที่ระบุเพื่อตรวจสอบว่าอุปกรณ์ติดตั้งอยู่หรือไม่
|
abstract
boolean
|
isUserRunning(int userId)
ตรวจสอบว่าผู้ใช้ที่กำหนดกำลังทำงานอยู่หรือไม่
|
abstract
boolean
|
isUserSecondary(int userId)
แสดงผลว่าผู้ใช้ที่ระบุเป็นผู้ใช้รองตามการแจ้งว่าไม่เหมาะสมหรือไม่
|
abstract
boolean
|
isUserVisible(int userId)
ตรวจสอบว่าผู้ใช้ที่ระบุมองเห็นได้หรือไม่
|
abstract
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
ตรวจสอบว่าผู้ใช้ที่ระบุปรากฏในจอแสดงผลหรือไม่
|
abstract
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
แสดงผลว่าอุปกรณ์อนุญาตให้ผู้ใช้เริ่มแสดงการทำงานในเบื้องหลังหรือไม่ใน ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
|
abstract
boolean
|
isVisibleBackgroundUsersSupported()
แสดงผลว่าอุปกรณ์อนุญาตให้เริ่มแสดงผู้ใช้ในเบื้องหลังหรือไม่
|
abstract
boolean
|
isWifiEnabled()
ทดสอบว่าเปิดใช้ Wi-Fi อยู่หรือไม่
|
abstract
|
listDisplayIds()
รวบรวมรายการรหัสแสดงที่มีอยู่ในอุปกรณ์ตามที่รายงานโดย "dumpsys
SurfaceFlinger"
|
abstract
|
listDisplayIdsForStartingVisibleBackgroundUsers()
รับรายการจอแสดงผลที่ใช้เพื่อstart a user visible in the background ได้
|
abstract
|
listUsers()
รับรายชื่อผู้ใช้ในอุปกรณ์
|
abstract
boolean
|
logBugreport(String dataName, ITestLogger listener)
วิธีการของตัวช่วยในการรับรายงานข้อบกพร่องและบันทึกรายงานให้กับผู้รายงาน
|
default
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
แจ้งอุปกรณ์ให้รอการถ่ายรูปเสร็จสมบูรณ์
|
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)
เปลี่ยนไปใช้รหัสผู้ใช้อื่นโดยกำหนดระยะหมดเวลาที่กำหนดไว้เป็นกำหนดเวลา
|
abstract
Bugreport
|
takeBugreport()
รับรายงานข้อบกพร่องและส่งคืนภายในออบเจ็กต์ Bugreport เพื่อจัดการ
|
abstract
String
|
uninstallPackage(String packageName)
ถอนการติดตั้งแพ็กเกจ Android จากอุปกรณ์
|
abstract
String
|
uninstallPackageForUser(String packageName, int userId)
ถอนการติดตั้งแพ็กเกจ Android จากผู้ใช้รายหนึ่งๆ ออกจากอุปกรณ์
|
default
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
หากคาดไว้ โปรดรอให้ Snapuserd ดำเนินการเสร็จสมบูรณ์
|
วิธีการสาธารณะ
ผู้ใช้ระบบเปลี่ยนส่วนหัวได้
public abstract boolean canSwitchToHeadlessSystemUser ()
แสดงผลว่าจะอนุญาตให้เปลี่ยนไปใช้ผู้ใช้ SYSTEM แบบไม่มีส่วนหัวหรือไม่
ตรวจสอบการเชื่อมต่อ
public abstract boolean checkConnectivity ()
ตรวจสอบว่าอุปกรณ์มีการเชื่อมต่อเครือข่าย
คิกรีเทิร์น |
boolean |
true หากอุปกรณ์มีการเชื่อมต่อเครือข่ายที่ใช้งานได้
false มากเกินไป |
clearErrorDialogs
public abstract boolean clearErrorDialogs ()
พยายามปิดกล่องโต้ตอบข้อผิดพลาดใดๆ ที่แสดงอยู่ใน UI ของอุปกรณ์
คิกรีเทิร์น |
boolean |
true หากไม่มีกล่องโต้ตอบอยู่หรือล้างกล่องโต้ตอบได้สำเร็จ
จ่าย false |
ล้างเครือข่าย Wi-Fi ที่เชื่อมต่อล่าสุด
public abstract void clearLastConnectedWifiNetwork ()
ล้างเครือข่าย Wi-Fi ที่เชื่อมต่อล่าสุด ควรเรียกใช้การตั้งค่านี้เมื่อเริ่มการเรียกใช้ใหม่
เพื่อหลีกเลี่ยงการเชื่อมต่อเครือข่าย Wi-Fi ที่ใช้ในการทดสอบก่อนหน้านี้หลังจากอุปกรณ์รีบูต
เชื่อมต่อกับเครือข่าย Wi-Fi
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)
เชื่อมต่อกับเครือข่าย Wi-Fi
เปิด Wi-Fi และบล็อกจนกว่าจะเชื่อมต่อกับ Wi-Fi เครื่องใดเครื่องหนึ่งได้สำเร็จ
เครือข่ายที่ระบุในแผนที่ wifiSsidToPsk เมื่อทำการเชื่อมต่อแล้ว อินสแตนซ์จะพยายาม
คืนค่าการเชื่อมต่อหลังจากรีบูตทุกครั้งจนถึง ITestDevice#disconnectFromWifi()
หรือ
ระบบเรียก ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ |
wifiSsidToPsk |
: แมป SSID ของ Wi-Fi กับรหัสผ่าน |
คิกรีเทิร์น |
boolean |
true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ false
หรือไม่เช่นนั้น |
เชื่อมต่อกับเครือข่าย Wi-Fi
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk,
boolean scanSsid)
เชื่อมต่อกับเครือข่าย Wi-Fi
เปิด Wi-Fi และบล็อกจนกว่าจะเชื่อมต่อกับ Wi-Fi เครื่องใดเครื่องหนึ่งได้สำเร็จ
เครือข่ายที่ระบุในแผนที่ wifiSsidToPsk เมื่อทำการเชื่อมต่อแล้ว อินสแตนซ์จะพยายาม
คืนค่าการเชื่อมต่อหลังจากรีบูตทุกครั้งจนถึง ITestDevice#disconnectFromWifi()
หรือ
ระบบเรียก ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ |
wifiSsidToPsk |
: แมป SSID ของ Wi-Fi กับรหัสผ่าน |
scanSsid |
boolean : ต้องการสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่ |
คิกรีเทิร์น |
boolean |
true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ false
หรือไม่เช่นนั้น |
เชื่อมต่อกับเครือข่าย Wi-Fi
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk)
เชื่อมต่อกับเครือข่าย Wi-Fi
เปิด Wi-Fi และบล็อกจนกว่าจะเชื่อมต่อกับเครือข่าย Wi-Fi ที่ระบุสำเร็จ
เมื่อเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากการรีบูตทุกครั้ง
จนถึง ITestDevice#disconnectFromWifi()
หรือ
ระบบเรียก ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ |
wifiSsid |
String : SSD ของ Wi-Fi ที่จะเชื่อมต่อ |
wifiPsk |
String : รหัสผ่าน PSK หรือค่าว่างหากไม่มีการเข้ารหัส |
คิกรีเทิร์น |
boolean |
true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ false
หรือไม่เช่นนั้น |
เชื่อมต่อกับเครือข่าย Wi-Fi
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk,
boolean scanSsid)
เชื่อมต่อกับเครือข่าย Wi-Fi
เปิด Wi-Fi และบล็อกจนกว่าจะเชื่อมต่อกับเครือข่าย Wi-Fi ที่ระบุสำเร็จ
เมื่อเชื่อมต่อแล้ว อินสแตนซ์จะพยายามคืนค่าการเชื่อมต่อหลังจากการรีบูตทุกครั้ง
จนถึง ITestDevice#disconnectFromWifi()
หรือ
ระบบเรียก ITestDevice#clearLastConnectedWifiNetwork()
พารามิเตอร์ |
wifiSsid |
String : SSD ของ Wi-Fi ที่จะเชื่อมต่อ |
wifiPsk |
String : รหัสผ่าน PSK หรือค่าว่างหากไม่มีการเข้ารหัส |
scanSsid |
boolean : ต้องการสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่ |
คิกรีเทิร์น |
boolean |
true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ false
หรือไม่เช่นนั้น |
เชื่อมต่อกับเครือข่าย Wi-Fi หากต้องการ
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)
ตัวแปรของ connectToWifiNetwork(String, String)
ที่จะเชื่อมต่อเมื่ออุปกรณ์เท่านั้น
ตอนนี้ไม่ได้เชื่อมต่อเครือข่าย
พารามิเตอร์ |
scanSsid |
boolean : ต้องการสแกนหา SSID ที่ซ่อนอยู่สำหรับเครือข่ายนี้หรือไม่ |
คิกรีเทิร์น |
boolean |
true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ false
หรือไม่เช่นนั้น |
เชื่อมต่อกับเครือข่าย Wi-Fi หากต้องการ
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)
ตัวแปรของ connectToWifiNetwork(String, String)
ที่จะเชื่อมต่อเมื่ออุปกรณ์เท่านั้น
ตอนนี้ไม่ได้เชื่อมต่อเครือข่าย
คิกรีเทิร์น |
boolean |
true หากเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ false
หรือไม่เช่นนั้น |
สร้างผู้ใช้
public abstract int createUser (String name)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0
พารามิเตอร์ |
name |
String : ของผู้ใช้ที่จะสร้างในอุปกรณ์ |
คิกรีเทิร์น |
int |
จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้น |
สร้างผู้ใช้
public abstract int createUser (String name,
boolean guest,
boolean ephemeral)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ระบุ
พารามิเตอร์ |
name |
String : ของผู้ใช้ที่จะสร้างในอุปกรณ์ |
guest |
boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --ผู้ใช้ชั่วคราวระหว่างการสร้าง |
ephemeral |
boolean : เปิดใช้การตั้งค่าสถานะผู้ใช้ -- ชั่วคราวระหว่างการสร้าง |
คิกรีเทิร์น |
int |
รหัสของผู้ใช้ที่สร้าง |
สร้างผู้ใช้
public abstract int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กที่ระบุ
พารามิเตอร์ |
name |
String : ของผู้ใช้ที่จะสร้างในอุปกรณ์ |
guest |
boolean : เปิดใช้งานการตั้งค่าสถานะผู้ใช้ --ผู้ใช้ชั่วคราวระหว่างการสร้าง |
ephemeral |
boolean : เปิดใช้การตั้งค่าสถานะผู้ใช้ -- ชั่วคราวระหว่างการสร้าง |
forTesting |
boolean : เปิดใช้ Test Flag --สำหรับการทดสอบระหว่างการสร้าง |
คิกรีเทิร์น |
int |
รหัสของผู้ใช้ที่สร้าง |
createUserNoThrow
public abstract int createUserNoThrow (String name)
สร้างผู้ใช้ด้วยชื่อที่กำหนดและแฟล็กเริ่มต้น 0
พารามิเตอร์ |
name |
String : ของผู้ใช้ที่จะสร้างในอุปกรณ์ |
คิกรีเทิร์น |
int |
จำนวนเต็มสำหรับรหัสผู้ใช้ที่สร้างขึ้นหรือ -1 สำหรับข้อผิดพลาด |
disabledKeyguard
public abstract void disableKeyguard ()
ความพยายามปิดใช้งานการล็อกปุ่ม
ก่อนอื่น ให้รอการจัดส่งอินพุตให้พร้อม ซึ่งจะเกิดขึ้นในช่วงเวลาเดียวกับเมื่อ
อุปกรณ์รายงาน BOOT_COMPLETE ซึ่งดูเหมือนจะไม่พร้อมกัน เนื่องจากเฟรมเวิร์กปัจจุบัน
การใช้งานมีเงื่อนไขในการแข่งขันเป็นครั้งคราว จากนั้นระบบจะส่งคำสั่งเพื่อปิดการล็อกปุ่มกด (ทำงาน
เฉพาะรายการที่ไม่ปลอดภัย)
ปิดใช้การตรวจสอบเครือข่าย
public abstract boolean disableNetworkMonitor ()
ปิดใช้การตรวจสอบเครือข่ายในอุปกรณ์
คิกรีเทิร์น |
boolean |
true หากปิดใช้การตรวจสอบสำเร็จ false
หากล้มเหลว |
ยกเลิกการเชื่อมต่อจาก Wi-Fi
public abstract boolean disconnectFromWifi ()
ยกเลิกการเชื่อมต่อกับเครือข่าย Wi-Fi
นำเครือข่ายทั้งหมดออกจากรายการเครือข่ายที่รู้จักและปิดใช้ Wi-Fi
คิกรีเทิร์น |
boolean |
true หากยกเลิกการเชื่อมต่อกับเครือข่าย Wi-Fi สำเร็จ false
หากยกเลิกการเชื่อมต่อไม่สำเร็จ |
doFileExist
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) ที่มีรายงานนั้นอยู่ เป็นค่าว่าง หากล้มเหลว |
เปิดใช้การตรวจสอบเครือข่าย
public abstract boolean enableNetworkMonitor ()
เปิดใช้การตรวจสอบเครือข่ายในอุปกรณ์
คิกรีเทิร์น |
boolean |
true หากเปิดใช้การตรวจสอบเรียบร้อยแล้ว false
หากล้มเหลว |
getActiveApexes
public abstract getActiveApexes ()
ดึงข้อมูลเกี่ยวกับ APEX ที่เปิดใช้งานในอุปกรณ์
getAllSettings
public abstract getAllSettings (String namespace)
แสดงผลคู่คีย์-ค่าของเนมสเปซที่ขอ
พารามิเตอร์ |
namespace |
String : ต้องเป็น {"system", "secure", "global"} |
คิกรีเทิร์น |
|
แผนที่ของคู่คีย์-ค่า มีค่าว่างหากไม่รองรับเนมสเปซ |
รับรหัส Android
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 ()
ดึงข้อมูลของแพ็กเกจที่ติดตั้งในอุปกรณ์
getBugreport
public abstract InputStreamSource getBugreport ()
เรียกรายงานข้อบกพร่องจากอุปกรณ์
เรารับประกันว่าวิธีการนี้จะทำงานบนอุปกรณ์ที่ไม่มีการ์ด SD ได้ต่อไป
(หรือที่ที่ยังไม่ได้ต่อเชื่อมการ์ด SD)
getBugreportz
public abstract InputStreamSource getBugreportz ()
ดึง Bugreportz จากอุปกรณ์ รายงานข้อบกพร่องของรูปแบบ ZIP ซึ่งมีรายงานข้อบกพร่องหลักและ
ไฟล์บันทึกอื่นๆ ที่มีประโยชน์ในการแก้ไขข้อบกพร่อง
รองรับเฉพาะ "เวอร์ชัน adb" 1.0.36
getCurrentFoldableState
public abstract DeviceFoldableState getCurrentFoldableState ()
แสดงผลสถานะปัจจุบันของอุปกรณ์หรือค่า Null หากเกิดปัญหาขึ้น
getCurrentUser
public abstract int getCurrentUser ()
แสดงผล ID ของผู้ใช้ปัจจุบันที่กำลังทำงานอยู่ ในกรณีที่มีข้อผิดพลาด ให้แสดงผล -10000
getFoldableStates
public abstract getFoldableStates ()
แสดงรายการสถานะพับได้ในอุปกรณ์ รับได้ด้วย "cmd device_state
"สถานะการพิมพ์"
getInstalledPackageNames
public abstract getInstalledPackageNames ()
ดึงข้อมูลชื่อแพ็กเกจของแอปพลิเคชันที่มีอยู่ในอุปกรณ์
getIPAddress
public abstract String getIpAddress ()
รับที่อยู่ IP ของอุปกรณ์
คิกรีเทิร์น |
String |
ที่อยู่ IP ของอุปกรณ์ หรือ null หากอุปกรณ์ไม่มีที่อยู่ IP |
getKeyguardState
public abstract KeyguardControllerState getKeyguardState ()
แสดงผลออบเจ็กต์เพื่อรับสถานะปัจจุบันของคีย์การ์ดหรือ Null หากไม่รองรับ
รับรหัสผู้ใช้หลัก
public abstract Integer getMainUserId ()
แสดงผล User-ID หลัก
คิกรีเทิร์น |
Integer |
userId ของผู้ใช้หลักหากมี และแสดงค่าว่างหากไม่มีผู้ใช้หลัก |
getMainlineModuleInfo
public abstract getMainlineModuleInfo ()
ดูข้อมูลเกี่ยวกับโมดูลเมนไลน์ที่ติดตั้งในอุปกรณ์
public abstract int getMaxNumberOfRunningUsersSupported ()
รับจำนวนผู้ใช้งานพร้อมกันที่รองรับสูงสุด ค่าเริ่มต้นคือ 0
คิกรีเทิร์น |
int |
จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่ทำงานพร้อมกัน |
public abstract int getMaxNumberOfUsersSupported ()
รับจํานวนผู้ใช้ที่รองรับสูงสุด ค่าเริ่มต้นคือ 0
คิกรีเทิร์น |
int |
จำนวนเต็มที่ระบุจำนวนผู้ใช้ที่รองรับ |
getOptions
public abstract TestDeviceOptions getOptions ()
ดึงข้อมูลตัวเลือกการทดสอบสำหรับอุปกรณ์
getPrimaryUserId
public abstract Integer getPrimaryUserId ()
แสดงผล User-ID หลัก
คิกรีเทิร์น |
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 ()
ดึงภาพหน้าจอจากอุปกรณ์
GetSetting
public abstract String getSetting (int userId,
String namespace,
String key)
แสดงผลค่าของการตั้งค่าที่ขอ
Namespace ต้องเป็น {"system", "secure", "global"}
พารามิเตอร์ |
userId |
int |
namespace |
String |
key |
String |
คิกรีเทิร์น |
String |
ค่าที่เชื่อมโยงกับเนมสเปซ:คีย์ของผู้ใช้ มีค่า Null หากไม่พบ |
GetSetting
public abstract String getSetting (String namespace,
String key)
ดู getSetting(int, String, String)
และดำเนินการกับผู้ใช้ระบบ
พารามิเตอร์ |
namespace |
String |
key |
String |
getถอนการติดตั้งPackageNames
public abstract getUninstallablePackageNames ()
เรียกชื่อแพ็กเกจแอปพลิเคชันที่สามารถถอนการติดตั้งได้ ซึ่งปัจจุบันมีการกำหนดไว้ว่า
แพ็กเกจที่ไม่ใช่ระบบ และแพ็กเกจระบบที่อัปเดต
คิกรีเทิร์น |
|
ERROR(/Set) ของชื่อแพ็กเกจ String ที่สามารถถอนการติดตั้งได้ซึ่งติดตั้งอยู่ใน
อุปกรณ์ |
getUserFlags
public abstract int getUserFlags (int userId)
ค้นหาและแสดงธงของผู้ใช้ที่ต้องการ
การติดธงจะกำหนดไว้ใน "android.content.pm.UserInfo" ในโครงการโอเพนซอร์ส Android
คิกรีเทิร์น |
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)
แสดงผลหมายเลขซีเรียลที่เชื่อมโยงกับ userId หากพบ ซึ่งก็คือ -10000 ในกรณีอื่นๆ
มีฟีเจอร์
public abstract boolean hasFeature (String feature)
ตรวจสอบว่าฟีเจอร์พร้อมใช้งานในอุปกรณ์หรือไม่
พารามิเตอร์ |
feature |
String : รูปแบบใดควรเป็น "ฟีเจอร์:" หรือ "" โดยตรง |
คิกรีเทิร์น |
boolean |
จริงหากพบฟีเจอร์ เป็นเท็จ |
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 หากสำเร็จ |
installPackage
public abstract String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์
หมายเหตุ: เฉพาะ Use Case ที่ต้องควบคุมการให้สิทธิ์รันไทม์อย่างชัดแจ้งที่
เวลาติดตั้งควรเรียกใช้ฟังก์ชันนี้
พารามิเตอร์ |
packageFile |
File : ไฟล์ apk ที่จะติดตั้ง |
reinstall |
boolean : true หากควรทำการติดตั้งอีกครั้ง |
grantPermissions |
boolean : ควรให้สิทธิ์รันไทม์ทั้งหมดหรือไม่ ณ เวลาที่ติดตั้ง |
extraArgs |
String : อาร์กิวเมนต์เสริมที่ไม่บังคับที่จะส่ง โปรดดู 'adb shell pm -h' สำหรับความพร้อมให้บริการ
ตัวเลือก |
คิกรีเทิร์น |
String |
String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
การขว้าง |
DeviceNotAvailableException |
หากการเชื่อมต่อกับอุปกรณ์หายไปและไม่สามารถ
กู้คืน |
UnsupportedOperationException |
หากแพลตฟอร์มไม่รองรับสิทธิ์รันไทม์
บนอุปกรณ์ |
ติดตั้งแพ็กเกจสำหรับผู้ใช้
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 หากสำเร็จ |
ติดตั้งแพ็กเกจสำหรับผู้ใช้
public abstract String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
ติดตั้งแพ็กเกจ Android ในอุปกรณ์สำหรับผู้ใช้ที่กำหนด
หมายเหตุ: เฉพาะ Use Case ที่ต้องควบคุมการให้สิทธิ์รันไทม์อย่างชัดแจ้งที่
เวลาติดตั้งควรเรียกใช้ฟังก์ชันนี้
พารามิเตอร์ |
packageFile |
File : ไฟล์ apk ที่จะติดตั้ง |
reinstall |
boolean : true หากควรทำการติดตั้งอีกครั้ง |
grantPermissions |
boolean : ควรให้สิทธิ์รันไทม์ทั้งหมดหรือไม่ ณ เวลาที่ติดตั้ง |
userId |
int : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง |
extraArgs |
String : อาร์กิวเมนต์เสริมที่ไม่บังคับที่จะส่ง โปรดดู 'adb shell pm -h' สำหรับความพร้อมให้บริการ
ตัวเลือก |
คิกรีเทิร์น |
String |
String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
การขว้าง |
DeviceNotAvailableException |
หากการเชื่อมต่อกับอุปกรณ์หายไปและไม่สามารถ
กู้คืน |
UnsupportedOperationException |
หากแพลตฟอร์มไม่รองรับสิทธิ์รันไทม์
บนอุปกรณ์ |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างขึ้นจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลักและแพ็กเกจแยกเพิ่มเติม 1 แพ็กเกจ)
โปรดดู "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 |
หากแพลตฟอร์มไม่รองรับสิทธิ์รันไทม์
บนอุปกรณ์ |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างขึ้นจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลักและแพ็กเกจแยกเพิ่มเติม 1 แพ็กเกจ)
ที่อยู่ในอุปกรณ์ Android โปรดดู
"https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีแยก apk ไปยัง
หลายไฟล์
หมายเหตุ: เฉพาะ Use Case ที่ต้องควบคุมการให้สิทธิ์รันไทม์อย่างชัดแจ้งที่
เวลาติดตั้งควรเรียกใช้ฟังก์ชันนี้
พารามิเตอร์ |
packageFiles |
: เส้นทางไฟล์ APK ระยะไกลที่จะติดตั้ง |
reinstall |
boolean : true หากควรทำการติดตั้งอีกครั้ง |
grantPermissions |
boolean : ควรให้สิทธิ์รันไทม์ทั้งหมดหรือไม่ ณ เวลาที่ติดตั้ง |
extraArgs |
String : อาร์กิวเมนต์เสริมที่ไม่บังคับที่จะส่ง โปรดดู 'adb shell pm -h' สำหรับความพร้อมให้บริการ
ตัวเลือก |
คิกรีเทิร์น |
String |
String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
การขว้าง |
DeviceNotAvailableException |
หากการเชื่อมต่อกับอุปกรณ์หายไปและไม่สามารถ
กู้คืน |
UnsupportedOperationException |
หากแพลตฟอร์มไม่รองรับสิทธิ์รันไทม์
บนอุปกรณ์ |
ติดตั้งแพ็กเกจสำหรับผู้ใช้
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างขึ้นจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลักและแพ็กเกจแยกเพิ่มเติม 1 แพ็กเกจ)
สำหรับผู้ใช้หนึ่งๆ โปรดดู "https://developer.android.com/studio/build/configure-apk-splits" ในวันที่
วิธีแยก apk เป็นหลายๆ ไฟล์
พารามิเตอร์ |
packageFiles |
: ไฟล์ apk ในเครื่อง |
reinstall |
boolean : true หากควรทำการติดตั้งอีกครั้ง |
userId |
int : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง |
extraArgs |
String : อาร์กิวเมนต์เสริมที่ไม่บังคับที่จะส่ง โปรดดู 'adb shell pm -h' สำหรับความพร้อมให้บริการ
ตัวเลือก |
คิกรีเทิร์น |
String |
String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
การขว้าง |
DeviceNotAvailableException |
หากการเชื่อมต่อกับอุปกรณ์หายไปและไม่สามารถ
กู้คืน |
UnsupportedOperationException |
หากแพลตฟอร์มไม่รองรับสิทธิ์รันไทม์
บนอุปกรณ์ |
ติดตั้งแพ็กเกจสำหรับผู้ใช้
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างขึ้นจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลักและแพ็กเกจแยกเพิ่มเติม 1 แพ็กเกจ)
สำหรับผู้ใช้หนึ่งๆ โปรดดู "https://developer.android.com/studio/build/configure-apk-splits" ในวันที่
วิธีแยก apk เป็นหลายๆ ไฟล์
หมายเหตุ: เฉพาะ Use Case ที่ต้องควบคุมการให้สิทธิ์รันไทม์อย่างชัดแจ้งที่
เวลาติดตั้งควรเรียกใช้ฟังก์ชันนี้
พารามิเตอร์ |
packageFiles |
: ไฟล์ apk ในเครื่อง |
reinstall |
boolean : true หากควรทำการติดตั้งอีกครั้ง |
grantPermissions |
boolean : ควรให้สิทธิ์รันไทม์ทั้งหมดหรือไม่ ณ เวลาที่ติดตั้ง |
userId |
int : รหัสผู้ใช้จำนวนเต็มที่จะติดตั้ง |
extraArgs |
String : อาร์กิวเมนต์เสริมที่ไม่บังคับที่จะส่ง โปรดดู 'adb shell pm -h' สำหรับความพร้อมให้บริการ
ตัวเลือก |
คิกรีเทิร์น |
String |
String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
การขว้าง |
DeviceNotAvailableException |
หากการเชื่อมต่อกับอุปกรณ์หายไปและไม่สามารถ
กู้คืน |
UnsupportedOperationException |
หากแพลตฟอร์มไม่รองรับสิทธิ์รันไทม์
บนอุปกรณ์ |
ติดตั้ง RemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ที่สร้างขึ้นจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลักและแพ็กเกจแยกเพิ่มเติม 1 แพ็กเกจ)
ที่อยู่ในอุปกรณ์ Android โปรดดู
"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 หลายไฟล์ (แพ็กเกจหลักและแพ็กเกจแยกเพิ่มเติม 1 แพ็กเกจ)
ที่อยู่ในอุปกรณ์ Android โปรดดู
"https://developer.android.com/studio/build/configure-apk-splits" เกี่ยวกับวิธีแยก apk ไปยัง
หลายไฟล์
หมายเหตุ: เฉพาะ Use Case ที่ต้องควบคุมการให้สิทธิ์รันไทม์อย่างชัดแจ้งที่
เวลาติดตั้งควรเรียกใช้ฟังก์ชันนี้
พารามิเตอร์ |
remoteApkPaths |
: เส้นทางไฟล์ apk ระยะไกล |
reinstall |
boolean : true หากควรทำการติดตั้งอีกครั้ง |
grantPermissions |
boolean : ควรให้สิทธิ์รันไทม์ทั้งหมดหรือไม่ ณ เวลาที่ติดตั้ง |
extraArgs |
String : อาร์กิวเมนต์เสริมที่ไม่บังคับที่จะส่ง โปรดดู 'adb shell pm -h' สำหรับความพร้อมให้บริการ
ตัวเลือก |
คิกรีเทิร์น |
String |
String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
การขว้าง |
DeviceNotAvailableException |
หากการเชื่อมต่อกับอุปกรณ์หายไปและไม่สามารถ
กู้คืน |
UnsupportedOperationException |
หากแพลตฟอร์มไม่รองรับสิทธิ์รันไทม์
บนอุปกรณ์ |
โหมดผู้ใช้ระบบไม่มีส่วนหัว
public abstract boolean isHeadlessSystemUserMode ()
แสดงผลว่าอุปกรณ์ใช้โหมดผู้ใช้ระบบแบบไม่มีส่วนหัวหรือไม่
isMainUserPermanentAdmin
public abstract boolean isMainUserPermanentAdmin ()
แสดงผลว่าผู้ใช้หลักเป็นผู้ดูแลระบบแบบถาวร และไม่สามารถลบหรือดาวน์เกรดเป็น
สถานะที่ไม่ใช่ผู้ดูแลระบบ
รองรับผู้ใช้หลายคน
public abstract boolean isMultiUserSupported ()
กำหนดว่ารองรับผู้ใช้หลายคนหรือไม่
คิกรีเทิร์น |
boolean |
จริง หากมีการสนับสนุนผู้ใช้หลายคน เป็นเท็จ |
ติดตั้งแพ็กเกจแล้ว
public abstract boolean isPackageInstalled (String packageName,
String userId)
ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจที่ระบุและรหัสผู้ใช้ที่ระบุเพื่อตรวจสอบว่าอุปกรณ์ดังกล่าวใช้อยู่ในปัจจุบัน
ติดตั้งหรือไม่สำหรับผู้ใช้นั้น
พารามิเตอร์ |
packageName |
String : แพ็กเกจที่เรากำลังตรวจสอบว่ามีการติดตั้งแล้วหรือยัง |
userId |
String : รหัสผู้ใช้ที่เรากำลังตรวจสอบแพ็กเกจได้รับการติดตั้งแล้ว หากค่าว่างเปล่า ให้ผู้ใช้หลัก
จะนำมาใช้เป็นศูนย์ |
คิกรีเทิร์น |
boolean |
เป็นจริงหากมีการรายงานว่าแพ็กเกจติดตั้งแล้ว เป็นเท็จ |
ติดตั้งแพ็กเกจแล้ว
public abstract boolean isPackageInstalled (String packageName)
ค้นหาอุปกรณ์สำหรับชื่อแพ็กเกจที่ระบุเพื่อตรวจสอบว่าอุปกรณ์ติดตั้งอยู่หรือไม่
พารามิเตอร์ |
packageName |
String |
คิกรีเทิร์น |
boolean |
เป็นจริงหากมีการรายงานว่าแพ็กเกจติดตั้งแล้ว เป็นเท็จ |
ผู้ใช้กำลังทำงาน
public abstract boolean isUserRunning (int userId)
ตรวจสอบว่าผู้ใช้ที่กำหนดทำงานอยู่หรือไม่
คิกรีเทิร์น |
boolean |
จริงหากผู้ใช้ทำงานอยู่ ค่าเป็นเท็จในกรณีอื่นๆ ทั้งหมด |
เป็นผู้ใช้รอง
public abstract boolean isUserSecondary (int userId)
แสดงผลว่าผู้ใช้ที่ระบุเป็นผู้ใช้รองตามการแจ้งว่าไม่เหมาะสมหรือไม่
คิกรีเทิร์น |
boolean |
"จริง" หากผู้ใช้เป็นข้อมูลรอง หรือเป็นเท็จ |
มองเห็นได้
public abstract boolean isUserVisible (int userId)
ตรวจสอบว่าผู้ใช้ที่ระบุมองเห็นได้หรือไม่
"มองเห็นได้" ผู้ใช้ คือผู้ใช้ที่มีการโต้ตอบกับ "มนุษย์" ผู้ใช้และจึงสามารถ
เปิดกิจกรรมการเปิดตัว (โดยทั่วไปจะอยู่ในจอแสดงผลเริ่มต้น)
เป็นUserVisibleOnDisplay
public abstract boolean isUserVisibleOnDisplay (int userId,
int displayId)
ตรวจสอบว่าผู้ใช้ที่ระบุปรากฏในจอแสดงผลหรือไม่
"มองเห็นได้" ผู้ใช้ คือผู้ใช้ที่มีการโต้ตอบกับ "มนุษย์" ผู้ใช้และจึงสามารถ
เปิดกิจกรรมการเปิดในจอแสดงผลนั้น
พารามิเตอร์ |
userId |
int |
displayId |
int |
เปิดใช้
public abstract boolean isWifiEnabled ()
ทดสอบว่าเปิดใช้ Wi-Fi อยู่หรือไม่
ตรวจสอบว่าอุปกรณ์เปิดใช้ Wi-Fi หรือไม่ มีประโยชน์ในการยืนยันสถานะ Wi-Fi ก่อนการทดสอบ
ไม่ควรทำงานกับ Wi-Fi เช่น การทดสอบอินเทอร์เน็ตมือถือ
คิกรีเทิร์น |
boolean |
true หากเปิดใช้ Wi-Fi อยู่ false หากปิดใช้ |
รายการรหัส Display
public abstract listDisplayIds ()
รวบรวมรายการรหัสแสดงที่มีอยู่ในอุปกรณ์ตามที่รายงานโดย "dumpsys
SurfaceFlinger"
คิกรีเทิร์น |
|
รายการจอแสดงผล ค่าเริ่มต้นจะแสดงการแสดงผลเริ่มต้นเป็น 0 เสมอ |
แสดงรายการรหัสดิสเพลย์สำหรับเริ่มต้นผู้ใช้พื้นหลังที่มองเห็นได้
public abstract listDisplayIdsForStartingVisibleBackgroundUsers ()
รับรายการจอแสดงผลที่ใช้เพื่อstart a user visible in the background
ได้
แสดงรายการผู้ใช้
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 |
จริง หากการบันทึกสำเร็จ หรือเป็นเท็จ |
AlertSnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
แจ้งอุปกรณ์ให้รอการถ่ายรูปเสร็จสมบูรณ์
พารามิเตอร์ |
waitPhase |
SnapuserdWaitPhase |
นำผู้ดูแลระบบออก
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 |
true หากเรานำผู้ใช้ออกจากระบบสำเร็จ มิฉะนั้นจะเป็นเท็จ |
ตั้งค่าอุปกรณ์เจ้าของ
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)
เพิ่มค่าการตั้งค่าไปยังเนมสเปซของผู้ใช้ที่กำหนด การตั้งค่าบางอย่างจะใช้ได้
หลังจากรีบูต
Namespace ต้องเป็น {"system", "secure", "global"}
พารามิเตอร์ |
userId |
int |
namespace |
String |
key |
String |
value |
String |
ผู้ใช้เริ่มต้น
public abstract boolean startUser (int userId)
เริ่มต้นผู้ใช้หนึ่งๆ ในพื้นหลังหากหยุดทำงานอยู่ หากผู้ใช้อยู่ใน
ทำงานในพื้นหลัง วิธีนี้เป็น NOOP
พารามิเตอร์ |
userId |
int : ของผู้ใช้ที่จะเริ่มต้นทำงานในเบื้องหลัง |
คิกรีเทิร์น |
boolean |
true ถ้าเริ่มต้นผู้ใช้ในเบื้องหลังสำเร็จ |
ผู้ใช้เริ่มต้น
public abstract boolean startUser (int userId,
boolean waitFlag)
เริ่มต้นผู้ใช้หนึ่งๆ ในพื้นหลังหากหยุดทำงานอยู่ หากผู้ใช้อยู่ใน
ทำงานในพื้นหลัง วิธีนี้เป็น NOOP สามารถระบุการแจ้งเพิ่มเติมเพื่อรอ
การดำเนินการเพื่อให้มีผล
พารามิเตอร์ |
userId |
int : ของผู้ใช้ที่จะเริ่มต้นทำงานในเบื้องหลัง |
waitFlag |
boolean : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะเริ่มและปลดล็อก |
คิกรีเทิร์น |
boolean |
true ถ้าเริ่มต้นผู้ใช้ในเบื้องหลังสำเร็จ |
ผู้ใช้พื้นหลังที่ปรากฏ
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)
หยุดผู้ใช้ที่กำหนด หากผู้ใช้หยุดอยู่แล้ว วิธีนี้ก็จะไม่มีการดำเนินการ
ไม่สามารถหยุดผู้ใช้ปัจจุบันและผู้ใช้ระบบ
พารามิเตอร์ |
userId |
int : ของผู้ใช้เพื่อหยุด |
คิกรีเทิร์น |
boolean |
true ถ้าหยุดผู้ใช้สำเร็จ |
ผู้ใช้
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
หยุดผู้ใช้ที่กำหนด สามารถใส่แฟล็กเพิ่มเติมเพื่อรอให้การดำเนินการมีผล
และบังคับให้ผู้ใช้สิ้นสุดการใช้งาน หยุดผู้ใช้ปัจจุบันและผู้ใช้ระบบไม่ได้
พารามิเตอร์ |
userId |
int : ของผู้ใช้เพื่อหยุด |
waitFlag |
boolean : จะทำให้คำสั่งรอจนกว่าผู้ใช้จะหยุด |
forceFlag |
boolean : จะบังคับให้ผู้ใช้หยุด |
คิกรีเทิร์น |
boolean |
true ถ้าหยุดผู้ใช้สำเร็จ |
เปลี่ยนผู้ใช้
public abstract boolean switchUser (int userId)
เปลี่ยนเป็น userId อื่นที่มีระยะหมดเวลาเริ่มต้น switchUser(int, long)
คิกรีเทิร์น |
boolean |
เป็นจริงหากรหัสผู้ใช้ใหม่ตรงกับผู้ให้บริการรหัสผู้ใช้ เป็นเท็จ |
เปลี่ยนผู้ใช้
public abstract boolean switchUser (int userId,
long timeout)
เปลี่ยนไปใช้รหัสผู้ใช้อื่นโดยกำหนดระยะหมดเวลาที่กำหนดไว้เป็นกำหนดเวลา
พยายามปิดใช้งานการล็อกปุ่มหลังจากที่เปลี่ยนผู้ใช้สำเร็จแล้ว
พารามิเตอร์ |
userId |
int |
timeout |
long : เพื่อรอก่อนที่จะแสดงผล false สำหรับผู้ใช้สวิตช์ไม่สำเร็จ |
คิกรีเทิร์น |
boolean |
เป็นจริงหากรหัสผู้ใช้ใหม่ตรงกับผู้ให้บริการรหัสผู้ใช้ เป็นเท็จ |
TakeBugreport
public abstract Bugreport takeBugreport ()
รับรายงานข้อบกพร่องและส่งคืนภายในออบเจ็กต์ 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 : รหัสผู้ใช้จำนวนเต็มที่จะถอนการติดตั้ง |
คิกรีเทิร์น |
String |
String ที่มีรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
รอสำหรับSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
หากคาดไว้ โปรดรอให้ Snapuserd ดำเนินการเสร็จสมบูรณ์
พารามิเตอร์ |
currentPhase |
SnapuserdWaitPhase |