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