IDevice
public
interface
IDevice
implements
IShellEnabledDevice
| com.android.ddmlib.IDevice |
อุปกรณ์ ซึ่งอาจเป็นอุปกรณ์จริงหรือโปรแกรมจำลองก็ได้
สรุป
เมธอดสาธารณะ | |
|---|---|
abstract
boolean
|
arePropertiesSet()
แสดง |
abstract
void
|
createForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)
สร้างการเปลี่ยนเส้นทางพอร์ระหว่างพอร์ต TCP ในเครื่องกับซ็อกเก็ตโดเมน Unix ระยะไกล |
abstract
void
|
createForward(int localPort, int remotePort)
สร้างการส่งต่อพอร์ระหว่างพอร์ตในเครื่องกับพอร์ตระยะไกล |
default
void
|
createReverse(int remotePort, int localPort)
สร้างการย้อนกลับพอร์ระหว่างพอร์ตระยะไกลกับพอร์ตภายใน |
default
void
|
executeBinderCommand(String[] parameters, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)
เรียกใช้คำสั่ง Binder ในอุปกรณ์ และส่งผลลัพธ์ไปยัง receiver ซึ่งจะใช้การเรียก exec:cmd |
default
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)
คำสั่ง executeShell เวอร์ชันที่รับสตรีมอินพุตเพื่อส่งผ่าน stdin ได้ |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
เรียกใช้คำสั่งเชลล์ในอุปกรณ์ และส่งผลลัพธ์ไปยัง receiver ซึ่งคล้ายกับการเรียกใช้ |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)
เลิกใช้เมธอดนี้แล้ว
ใช้ |
default
void
|
forceStop(String applicationName)
บังคับให้แอปพลิเคชันหยุดทำงานตามชื่อแอปพลิเคชัน |
abstract
|
getAbis()
แสดง ABI ที่อุปกรณ์นี้รองรับ |
default
ListenableFuture<AvdData>
|
getAvdData()
แสดงข้อมูลเกี่ยวกับ AVD ที่โปรแกรมจำลองกำลังเรียกใช้ |
abstract
String
|
getAvdName()
แสดงผลชื่อของ AVD ที่โปรแกรมจำลองกำลังทำงานอยู่ |
abstract
String
|
getAvdPath()
แสดงผลเส้นทางสัมบูรณ์ไปยังอุปกรณ์เสมือนในระบบไฟล์ |
abstract
|
getBattery(long freshnessTime, TimeUnit timeUnit)
แสดงระดับแบตเตอรี่ของอุปกรณ์ตั้งแต่ 0 ถึง 100 เปอร์เซ็นต์ |
abstract
|
getBattery()
แสดงระดับแบตเตอรี่ของอุปกรณ์ตั้งแต่ 0 ถึง 100 เปอร์เซ็นต์ |
abstract
Integer
|
getBatteryLevel(long freshnessMs)
เลิกใช้เมธอดนี้แล้ว
ใช้ |
abstract
Integer
|
getBatteryLevel()
เลิกใช้เมธอดนี้แล้ว
ใช้ |
abstract
Client
|
getClient(String applicationName)
แสดง |
abstract
String
|
getClientName(int pid)
แสดงผลชื่อไคลเอ็นต์ตาม pid หรือ |
abstract
Client[]
|
getClients()
แสดงผลอาร์เรย์ของไคลเอ็นต์ |
abstract
int
|
getDensity()
แสดงผลที่เก็บความหนาแน่นของหน้าจออุปกรณ์โดยอ่านค่าสำหรับพร็อพเพอร์ตี้ของระบบ
|
abstract
FileListingService
|
getFileListingService()
แสดง |
default
|
getHardwareCharacteristics()
แสดงฟีเจอร์ที่ได้จากการอ่านพร็อพเพอร์ตี้ลักษณะการสร้าง |
abstract
String
|
getLanguage()
แสดงผลภาษาของผู้ใช้ |
default
InstallMetrics
|
getLastInstallMetrics()
รับข้อมูลเกี่ยวกับการติดตั้งล่าสุดในอุปกรณ์นี้ |
abstract
String
|
getMountPoint(String name)
แสดงผลจุดต่อเชื่อม |
default
ProfileableClient[]
|
getProfileableClients()
แสดงผลอาร์เรย์ของไคลเอ็นต์ที่สร้างโปรไฟล์ได้ |
abstract
|
getProperties()
เลิกใช้เมธอดนี้แล้ว
ใช้ |
abstract
String
|
getProperty(String name)
เมธอดอำนวยความสะดวกที่พยายามดึงข้อมูลพร็อพเพอร์ตี้ผ่าน |
abstract
String
|
getPropertyCacheOrSync(String name)
เลิกใช้เมธอดนี้แล้ว
ใช้ |
abstract
int
|
getPropertyCount()
เลิกใช้เมธอดนี้แล้ว รายละเอียดการใช้งาน |
abstract
String
|
getPropertySync(String name)
เลิกใช้เมธอดนี้แล้ว
ใช้ |
abstract
String
|
getRegion()
แสดงผลภูมิภาคของผู้ใช้ |
abstract
RawImage
|
getScreenshot()
ถ่ายภาพหน้าจอของอุปกรณ์และส่งกลับเป็น |
abstract
RawImage
|
getScreenshot(long timeout, TimeUnit unit)
|
abstract
String
|
getSerialNumber()
แสดงหมายเลขซีเรียลของอุปกรณ์ |
abstract
IDevice.DeviceState
|
getState()
แสดงสถานะของอุปกรณ์ |
abstract
SyncService
|
getSyncService()
แสดงออบเจ็กต์ |
abstract
boolean
|
hasClients()
|
abstract
void
|
installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ในอุปกรณ์ |
abstract
void
|
installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ในอุปกรณ์ |
abstract
void
|
installPackage(String packageFilePath, boolean reinstall, String... extraArgs)
ติดตั้งแอปพลิเคชัน Android ในอุปกรณ์ |
default
void
|
installPackages(
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (ไฟล์หลัก 1 ไฟล์และแพ็กเกจแยก 0..n รายการ) โดยมีระยะหมดเวลาเริ่มต้น |
abstract
void
|
installPackages(
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลัก 1 รายการและแพ็กเกจแยก 0..n รายการ) |
abstract
void
|
installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)
ติดตั้งแพ็กเกจแอปพลิเคชันที่พุชไปยังตำแหน่งชั่วคราวในอุปกรณ์ |
abstract
void
|
installRemotePackage(String remoteFilePath, boolean reinstall, String... extraArgs)
ติดตั้งแพ็กเกจแอปพลิเคชันที่พุชไปยังตำแหน่งชั่วคราวในอุปกรณ์ |
abstract
void
|
installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)
ติดตั้งแพ็กเกจแอปพลิเคชันที่พุชไปยังตำแหน่งชั่วคราวในอุปกรณ์ |
default
void
|
installRemotePackages(
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ซึ่งอยู่ในอุปกรณ์โดยมี การหมดเวลาเริ่มต้น |
default
void
|
installRemotePackages(
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ซึ่งอยู่ในอุปกรณ์ |
abstract
boolean
|
isBootLoader()
แสดงว่าอุปกรณ์อยู่ในโหมด Bootloader หรือไม่ |
abstract
boolean
|
isEmulator()
แสดง |
abstract
boolean
|
isOffline()
แสดงว่าอุปกรณ์ออฟไลน์หรือไม่ |
abstract
boolean
|
isOnline()
แสดงว่าอุปกรณ์พร้อมหรือไม่ |
abstract
boolean
|
isRoot()
ค้นหาสถานะรูทปัจจุบันของอุปกรณ์ |
default
void
|
kill(String applicationName)
ปิดแอปพลิเคชันตามชื่อแอปพลิเคชัน |
abstract
void
|
pullFile(String remote, String local)
ดึงไฟล์เดียว |
default
void
|
push(String[] local, String remote)
ส่งไฟล์หรือไดเรกทอรีหลายรายการ |
abstract
void
|
pushFile(String local, String remote)
ส่งไฟล์เดียว |
default
SocketChannel
|
rawBinder(String service, String[] parameters)
เรียกใช้บริการ Android Binder Bridge ในอุปกรณ์ระยะไกล |
default
SocketChannel
|
rawExec(String executable, String[] parameters)
เรียกใช้บริการ host:exec ในอุปกรณ์ระยะไกล |
abstract
void
|
reboot(String into)
รีบูตอุปกรณ์ |
default
void
|
removeForward(int localPort)
นำการส่งต่อพอร์ตระหว่างพอร์ตในเครื่องและพอร์ตระยะไกลออก |
default
void
|
removeForward(int localPort, int remotePort)
เลิกใช้เมธอดนี้แล้ว
ใช้ |
default
void
|
removeForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)
เลิกใช้เมธอดนี้แล้ว
ใช้ |
abstract
void
|
removeRemotePackage(String remoteFilePath)
นำไฟล์ออกจากอุปกรณ์ |
default
void
|
removeReverse(int remotePort)
นำการสลับพอร์ตระหว่างพอร์ตระยะไกลและพอร์ตภายในออก |
abstract
boolean
|
root()
ขอให้ daemon ของ adb กลายเป็นรูทในอุปกรณ์ |
abstract
void
|
startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)
เริ่มการบันทึกหน้าจอบนอุปกรณ์หากอุปกรณ์รองรับ |
abstract
boolean
|
supportsFeature(IDevice.HardwareFeature feature)
แสดงว่าอุปกรณ์นี้รองรับฟีเจอร์ฮาร์ดแวร์ที่ระบุหรือไม่ |
abstract
boolean
|
supportsFeature(IDevice.Feature feature)
แสดงว่าอุปกรณ์นี้รองรับฟีเจอร์ซอฟต์แวร์ที่ระบุหรือไม่ |
abstract
String
|
syncPackageToDevice(String localFilePath)
ส่งไฟล์ไปยังอุปกรณ์ |
abstract
String
|
uninstallApp(String applicationID, String... extraArgs)
ถอนการติดตั้งแอปจากอุปกรณ์ |
abstract
String
|
uninstallPackage(String packageName)
ถอนการติดตั้งแพ็กเกจจากอุปกรณ์ |
ค่าคงที่
CHANGE_BUILD_INFO
public static final int CHANGE_BUILD_INFO
มาสก์บิตการเปลี่ยนแปลงอุปกรณ์: การเปลี่ยนแปลงข้อมูลเวอร์ชัน
ค่าคงที่ 4 (0x00000004)
CHANGE_CLIENT_LIST
public static final int CHANGE_CLIENT_LIST
มาสก์บิตการเปลี่ยนแปลงอุปกรณ์: Client การเปลี่ยนแปลงรายการ
ค่าคงที่ 2 (0x00000002)
CHANGE_PROFILEABLE_CLIENT_LIST
public static final int CHANGE_PROFILEABLE_CLIENT_LIST
มาสก์บิตการเปลี่ยนแปลงอุปกรณ์: ProfileableClient การเปลี่ยนแปลงรายการ
ค่าคงที่ 8 (0x00000008)
CHANGE_STATE
public static final int CHANGE_STATE
บิตมาสก์การเปลี่ยนแปลงอุปกรณ์: DeviceState change
ค่าคงที่ 1 (0x00000001)
FIRST_EMULATOR_SN
public static final String FIRST_EMULATOR_SN
หมายเลขซีเรียลของโปรแกรมจำลองที่เชื่อมต่อเครื่องแรก
ค่าคงที่: "emulator-5554"
MNT_DATA
public static final String MNT_DATA
ค่าคงที่: "ANDROID_DATA"
MNT_EXTERNAL_STORAGE
public static final String MNT_EXTERNAL_STORAGE
ค่าคงที่: "EXTERNAL_STORAGE"
MNT_ROOT
public static final String MNT_ROOT
ค่าคงที่ "ANDROID_ROOT"
PROP_BUILD_API_LEVEL
public static final String PROP_BUILD_API_LEVEL
ค่าคงที่: "ro.build.version.sdk"
PROP_BUILD_CHARACTERISTICS
public static final String PROP_BUILD_CHARACTERISTICS
ค่าคงที่: "ro.build.characteristics"
PROP_BUILD_CODENAME
public static final String PROP_BUILD_CODENAME
ค่าคงที่ "ro.build.version.codename"
PROP_BUILD_TAGS
public static final String PROP_BUILD_TAGS
ค่าคงที่ "ro.build.tags"
PROP_BUILD_TYPE
public static final String PROP_BUILD_TYPE
ค่าคงที่: "ro.build.type"
PROP_BUILD_VERSION
public static final String PROP_BUILD_VERSION
ค่าคงที่: "ro.build.version.release"
PROP_BUILD_VERSION_NUMBER
public static final String PROP_BUILD_VERSION_NUMBER
ค่าคงที่นี้เลิกใช้งานแล้ว
ใช้ PROP_BUILD_API_LEVEL
ค่าคงที่: "ro.build.version.sdk"
PROP_DEBUGGABLE
public static final String PROP_DEBUGGABLE
ค่าคงที่: "ro.debuggable"
PROP_DEVICE_CPU_ABI
public static final String PROP_DEVICE_CPU_ABI
ค่าคงที่ "ro.product.cpu.abi"
PROP_DEVICE_CPU_ABI2
public static final String PROP_DEVICE_CPU_ABI2
ค่าคงที่: "ro.product.cpu.abi2"
PROP_DEVICE_CPU_ABI_LIST
public static final String PROP_DEVICE_CPU_ABI_LIST
ค่าคงที่: "ro.product.cpu.abilist"
PROP_DEVICE_DENSITY
public static final String PROP_DEVICE_DENSITY
ค่าคงที่: "ro.sf.lcd_density"
PROP_DEVICE_EMULATOR_DENSITY
public static final String PROP_DEVICE_EMULATOR_DENSITY
ค่าคงที่: "qemu.sf.lcd_density"
PROP_DEVICE_LANGUAGE
public static final String PROP_DEVICE_LANGUAGE
ค่าคงที่: "persist.sys.language"
PROP_DEVICE_MANUFACTURER
public static final String PROP_DEVICE_MANUFACTURER
ค่าคงที่: "ro.product.manufacturer"
PROP_DEVICE_MODEL
public static final String PROP_DEVICE_MODEL
ค่าคงที่ "ro.product.model"
PROP_DEVICE_REGION
public static final String PROP_DEVICE_REGION
ค่าคงที่: "persist.sys.country"
RE_EMULATOR_SN
public static final String RE_EMULATOR_SN
นิพจน์ทั่วไปของหมายเลขซีเรียลของโปรแกรมจำลอง
ค่าคงที่ "จำลอง-(\d+)"
UNKNOWN_PACKAGE
public static final String UNKNOWN_PACKAGE
ค่าคงที่: ""
เมธอดสาธารณะ
arePropertiesSet
public abstract boolean arePropertiesSet ()
แสดง true หากมีการแคชพร็อพเพอร์ตี้
| คิกรีเทิร์น | |
|---|---|
boolean |
|
createForward
public abstract void createForward (int localPort,
String remoteSocketName,
IDevice.DeviceUnixSocketNamespace namespace)สร้างการเปลี่ยนเส้นทางพอร์ระหว่างพอร์ต TCP ในเครื่องกับซ็อกเก็ตโดเมน Unix ระยะไกล
| พารามิเตอร์ | |
|---|---|
localPort |
int: พอร์ตในเครื่องที่จะส่งต่อ |
remoteSocketName |
String: ชื่อของ Unix Domain Socket ที่สร้างในอุปกรณ์ |
namespace |
IDevice.DeviceUnixSocketNamespace: เนมสเปซที่สร้าง Unix Domain Socket |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
|
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ |
createForward
public abstract void createForward (int localPort,
int remotePort)สร้างการส่งต่อพอร์ระหว่างพอร์ตในเครื่องกับพอร์ตระยะไกล
| พารามิเตอร์ | |
|---|---|
localPort |
int: พอร์ตในเครื่องที่จะส่งต่อ |
remotePort |
int: พอร์ตระยะไกล |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
|
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ |
createReverse
public void createReverse (int remotePort,
int localPort)สร้างการย้อนกลับพอร์ระหว่างพอร์ตระยะไกลกับพอร์ตภายใน
| พารามิเตอร์ | |
|---|---|
remotePort |
int: พอร์ตระยะไกลที่จะย้อนกลับ |
localPort |
int: พอร์ตในเครื่อง |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
|
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ |
executeBinderCommand
public void executeBinderCommand (String[] parameters,
IShellOutputReceiver receiver,
long maxTimeToOutputResponse,
TimeUnit maxTimeUnits,
InputStream is)เรียกใช้คำสั่ง Binder ในอุปกรณ์ และส่งผลลัพธ์ไปยัง receiver
ซึ่งจะใช้การเรียก exec:cmd
| พารามิเตอร์ | |
|---|---|
parameters |
String: คำสั่ง Binder ที่จะดำเนินการ |
receiver |
IShellOutputReceiver: IShellOutputReceiver ที่จะรับเอาต์พุตของคำสั่ง Binder
|
maxTimeToOutputResponse |
long |
maxTimeUnits |
TimeUnit |
is |
InputStream: สตรีมอินพุตที่ไม่บังคับเพื่อส่งผ่าน stdin |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
ShellCommandUnresponsiveException |
ในกรณีที่คำสั่ง Binder ไม่ส่งเอาต์พุตเป็นระยะเวลาหนึ่ง |
|
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ |
ดูเพิ่มเติม:
executeShellCommand
public void executeShellCommand (String command,
IShellOutputReceiver receiver,
long maxTimeToOutputResponse,
TimeUnit maxTimeUnits,
InputStream is)คำสั่ง executeShell เวอร์ชันที่รับสตรีมอินพุตเพื่อส่งผ่าน stdin ได้
| พารามิเตอร์ | |
|---|---|
command |
String |
receiver |
IShellOutputReceiver |
maxTimeToOutputResponse |
long |
maxTimeUnits |
TimeUnit |
is |
InputStream |
| การขว้าง | |
|---|---|
AdbCommandRejectedException |
|
ShellCommandUnresponsiveException |
|
TimeoutException |
|
executeShellCommand
public abstract void executeShellCommand (String command,
IShellOutputReceiver receiver)เรียกใช้คำสั่งเชลล์ในอุปกรณ์ และส่งผลลัพธ์ไปยัง receiver
ซึ่งคล้ายกับการเรียกใช้
executeShellCommand(command, receiver, DdmPreferences.getTimeOut())
| พารามิเตอร์ | |
|---|---|
command |
String: คำสั่งเชลล์ที่จะดำเนินการ |
receiver |
IShellOutputReceiver: IShellOutputReceiver ที่จะรับเอาต์พุตของคำสั่งเชลล์
|
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
ShellCommandUnresponsiveException |
ในกรณีที่คำสั่งเชลล์ไม่ส่งเอาต์พุตเป็นระยะเวลาหนึ่ง |
|
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ |
executeShellCommand
public abstract void executeShellCommand (String command,
IShellOutputReceiver receiver,
int maxTimeToOutputResponse)
เลิกใช้เมธอดนี้แล้ว
ใช้ IShellEnabledDevice.executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)
| พารามิเตอร์ | |
|---|---|
command |
String |
receiver |
IShellOutputReceiver |
maxTimeToOutputResponse |
int |
| การขว้าง | |
|---|---|
AdbCommandRejectedException |
|
ShellCommandUnresponsiveException |
|
TimeoutException |
|
forceStop
public void forceStop (String applicationName)
บังคับให้แอปพลิเคชันหยุดทำงานตามชื่อแอปพลิเคชัน การดำเนินการนี้จะนำการปลุกที่รอดำเนินการและการคำนวณที่อยู่ในคิวออกทั้งหมด
| พารามิเตอร์ | |
|---|---|
applicationName |
String: ชื่อแอปพลิเคชัน |
getAbis
public abstractgetAbis ()
แสดง ABI ที่อุปกรณ์นี้รองรับ ระบบจะจัดเรียง ABI ตามลำดับที่ต้องการ โดย ABI แรกจะเป็น ABI ที่ต้องการมากที่สุด
| คิกรีเทิร์น | |
|---|---|
|
รายการ ABI |
getAvdData
public ListenableFuture<AvdData> getAvdData ()
แสดงข้อมูลเกี่ยวกับ AVD ที่โปรแกรมจำลองกำลังเรียกใช้
AvdData.getName คือชื่อของ AVD หรือ null หากไม่มี
AvdData.getPath คือเส้นทาง AVD หรือ null หากเป็นอุปกรณ์จริง, คำสั่งย่อยของคอนโซลโปรแกรมจำลอง
ล้มเหลว หรือโปรแกรมจำลองมีเวอร์ชันเก่ากว่า 30.0.18
| คิกรีเทิร์น | |
|---|---|
ListenableFuture<AvdData> |
AvdData ของอุปกรณ์ |
getAvdName
public abstract String getAvdName ()
แสดงผลชื่อของ AVD ที่โปรแกรมจำลองกำลังทำงานอยู่
ค่านี้จะใช้ได้ก็ต่อเมื่อ isEmulator() แสดงผลเป็น "จริง"
หากโปรแกรมจำลองไม่ได้เรียกใช้ AVD ใดๆ (เช่น เรียกใช้จากบิลด์ของโครงสร้างแหล่งที่มาของ Android
) เมธอดนี้จะแสดงผล "<build>"
หมายเหตุ: ขอแนะนำให้ใช้ getAvdData() หากต้องการควบคุมการหมดเวลา
| คิกรีเทิร์น | |
|---|---|
String |
ชื่อของ AVD หรือ null หากไม่มี |
getAvdPath
public abstract String getAvdPath ()
แสดงผลเส้นทางสัมบูรณ์ไปยังอุปกรณ์เสมือนในระบบไฟล์ เส้นทางจะขึ้นอยู่กับระบบปฏิบัติการ โดยจะมีตัวคั่นชื่อเป็น / ใน Linux และตัวคั่นเป็น \ ใน Windows
หมายเหตุ: ขอแนะนำให้ใช้ getAvdData() หากต้องการควบคุมการหมดเวลา
| คิกรีเทิร์น | |
|---|---|
String |
เส้นทาง AVD หรือ null หากเป็นอุปกรณ์จริง, คำสั่งย่อยของคอนโซลโปรแกรมจำลอง ล้มเหลว หรือโปรแกรมจำลองมีเวอร์ชันเก่ากว่า 30.0.18 |
getBattery
public abstractgetBattery (long freshnessTime, TimeUnit timeUnit)
แสดงระดับแบตเตอรี่ของอุปกรณ์ตั้งแต่ 0 ถึง 100 เปอร์เซ็นต์
ระบบอาจแคชระดับแบตเตอรี่ไว้ จะค้นหาระดับแบตเตอรี่ของอุปกรณ์ก็ต่อเมื่อ
freshnessTime หมดอายุแล้วนับตั้งแต่การค้นหาที่สำเร็จครั้งล่าสุด
| พารามิเตอร์ | |
|---|---|
freshnessTime |
long: ความใหม่ของระดับแบตเตอรี่ที่ต้องการ |
timeUnit |
TimeUnit: ERROR(/TimeUnit) ของเวลาความใหม่ |
| คิกรีเทิร์น | |
|---|---|
|
ERROR(/Future) ที่ใช้เพื่อค้นหาระดับแบตเตอรี่ได้ Future จะแสดงผล ERROR(/ExecutionException) หากดึงข้อมูลระดับแบตเตอรี่ไม่ได้ |
getBattery
public abstractgetBattery ()
แสดงระดับแบตเตอรี่ของอุปกรณ์ตั้งแต่ 0 ถึง 100 เปอร์เซ็นต์
ระบบอาจแคชระดับแบตเตอรี่ไว้ จะค้นหาระดับแบตเตอรี่ของอุปกรณ์ก็ต่อเมื่อผ่านไป 5 นาทีนับตั้งแต่การค้นหาที่สำเร็จครั้งล่าสุด
| คิกรีเทิร์น | |
|---|---|
|
ERROR(/Future) ที่ใช้เพื่อค้นหาระดับแบตเตอรี่ได้ Future จะแสดงผล ERROR(/ExecutionException) หากดึงข้อมูลระดับแบตเตอรี่ไม่ได้ |
getBatteryLevel
public abstract Integer getBatteryLevel (long freshnessMs)
เลิกใช้เมธอดนี้แล้ว
ใช้ getBattery(long, TimeUnit)
แสดงระดับแบตเตอรี่ของอุปกรณ์ตั้งแต่ 0 ถึง 100 เปอร์เซ็นต์
ระบบอาจแคชระดับแบตเตอรี่ไว้ จะค้นหาระดับแบตเตอรี่ของอุปกรณ์ก็ต่อเมื่อ
freshnessMs มิลลิวินาทีผ่านไปนับตั้งแต่การค้นหาที่สำเร็จครั้งล่าสุด
| คิกรีเทิร์น | |
|---|---|
Integer |
ระดับแบตเตอรี่หรือ null หากดึงข้อมูลไม่ได้ |
| การขว้าง | |
|---|---|
|
com.android.ddmlib.ShellCommandUnresponsiveException |
AdbCommandRejectedException |
|
ShellCommandUnresponsiveException |
|
TimeoutException |
|
getBatteryLevel
public abstract Integer getBatteryLevel ()
เลิกใช้เมธอดนี้แล้ว
ใช้ getBattery()
แสดงระดับแบตเตอรี่ของอุปกรณ์ตั้งแต่ 0 ถึง 100 เปอร์เซ็นต์
ระบบอาจแคชระดับแบตเตอรี่ไว้ จะค้นหาระดับแบตเตอรี่ของอุปกรณ์ก็ต่อเมื่อผ่านไป 5 นาทีนับตั้งแต่การค้นหาที่สำเร็จครั้งล่าสุด
| คิกรีเทิร์น | |
|---|---|
Integer |
ระดับแบตเตอรี่หรือ null หากดึงข้อมูลไม่ได้ |
| การขว้าง | |
|---|---|
AdbCommandRejectedException |
|
ShellCommandUnresponsiveException |
|
TimeoutException |
|
getClient
public abstract Client getClient (String applicationName)
แสดง Client ตามชื่อแอปพลิเคชัน
| พารามิเตอร์ | |
|---|---|
applicationName |
String: ชื่อแอปพลิเคชัน |
| คิกรีเทิร์น | |
|---|---|
Client |
ออบเจ็กต์ Client หรือ null หากไม่พบรายการที่ตรงกัน |
getClientName
public abstract String getClientName (int pid)
แสดงผลชื่อไคลเอ็นต์ตาม pid หรือ null หากไม่ทราบ pid
| พารามิเตอร์ | |
|---|---|
pid |
int: pid ของไคลเอ็นต์ |
| คิกรีเทิร์น | |
|---|---|
String |
|
getDensity
public abstract int getDensity ()
แสดงผลที่เก็บความหนาแน่นของหน้าจออุปกรณ์โดยอ่านค่าสำหรับพร็อพเพอร์ตี้ของระบบ
PROP_DEVICE_DENSITY
| คิกรีเทิร์น | |
|---|---|
int |
ความหนาแน่น หรือ -1 หากระบุไม่ได้ |
getFileListingService
public abstract FileListingService getFileListingService ()
แสดง FileListingService สำหรับอุปกรณ์นี้
| คิกรีเทิร์น | |
|---|---|
FileListingService |
|
getHardwareCharacteristics
publicgetHardwareCharacteristics ()
แสดงฟีเจอร์ที่ได้จากการอ่านพร็อพเพอร์ตี้ลักษณะการสร้าง
| คิกรีเทิร์น | |
|---|---|
|
|
getLanguage
public abstract String getLanguage ()
แสดงผลภาษาของผู้ใช้
| คิกรีเทิร์น | |
|---|---|
String |
ภาษาของผู้ใช้ หรือ null หากไม่ทราบ |
getLastInstallMetrics
public InstallMetrics getLastInstallMetrics ()
รับข้อมูลเกี่ยวกับการติดตั้งล่าสุดในอุปกรณ์นี้
| คิกรีเทิร์น | |
|---|---|
InstallMetrics |
InstallMetrics เมตริกที่อธิบายการติดตั้ง |
getMountPoint
public abstract String getMountPoint (String name)
แสดงผลจุดต่อเชื่อม
| พารามิเตอร์ | |
|---|---|
name |
String: ชื่อของจุดต่อเชื่อมที่จะแสดง |
| คิกรีเทิร์น | |
|---|---|
String |
|
ดูเพิ่มเติม:
getProfileableClients
public ProfileableClient[] getProfileableClients ()
แสดงผลอาร์เรย์ของไคลเอ็นต์ที่สร้างโปรไฟล์ได้
| คิกรีเทิร์น | |
|---|---|
ProfileableClient[] |
|
getProperties
public abstractgetProperties ()
เลิกใช้เมธอดนี้แล้ว
ใช้ IShellEnabledDevice.getSystemProperty(String) แทน
แสดงพร็อพเพอร์ตี้ของอุปกรณ์ที่แคชไว้ ซึ่งมีเอาต์พุตทั้งหมดของ "getprop"
| คิกรีเทิร์น | |
|---|---|
|
|
getProperty
public abstract String getProperty (String name)
เมธอดอำนวยความสะดวกที่พยายามดึงข้อมูลพร็อพเพอร์ตี้ผ่าน IShellEnabledDevice.getSystemProperty(String) โดยมีเวลารอที่สั้นมาก และไม่สนใจข้อยกเว้น
หมายเหตุ: เราขอแนะนำให้ใช้ IShellEnabledDevice.getSystemProperty(String) หากต้องการควบคุม
การหมดเวลา
| พารามิเตอร์ | |
|---|---|
name |
String: ชื่อของค่าที่จะแสดง |
| คิกรีเทิร์น | |
|---|---|
String |
ค่าหรือ null หากค่าพร็อพเพอร์ตี้ไม่พร้อมใช้งานในทันที |
getPropertyCacheOrSync
public abstract String getPropertyCacheOrSync (String name)
เลิกใช้เมธอดนี้แล้ว
ใช้ IShellEnabledDevice.getSystemProperty(String) แทน
ชุดค่าผสมของ getProperty(String) และ getPropertySync(String) ที่จะ
พยายามดึงข้อมูลพร็อพเพอร์ตี้จากแคช หากไม่พบ จะพยายาม
ค้นหาอุปกรณ์โดยตรงพร้อมกันและสร้างแคชใหม่หากสำเร็จ
| พารามิเตอร์ | |
|---|---|
name |
String: ชื่อของค่าที่จะแสดง |
| คิกรีเทิร์น | |
|---|---|
String |
ค่าหรือ null หากไม่มีพร็อพเพอร์ตี้ |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
ShellCommandUnresponsiveException |
ในกรณีที่คำสั่งเชลล์ไม่ส่งเอาต์พุตเป็นระยะเวลาหนึ่ง |
|
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ |
getPropertyCount
public abstract int getPropertyCount ()
เลิกใช้เมธอดนี้แล้ว
รายละเอียดการใช้งาน
แสดงผลจำนวนพร็อพเพอร์ตี้สำหรับอุปกรณ์นี้
| คิกรีเทิร์น | |
|---|---|
int |
|
getPropertySync
public abstract String getPropertySync (String name)
เลิกใช้เมธอดนี้แล้ว
ใช้ IShellEnabledDevice.getSystemProperty(String)
รูปแบบของ getProperty(String) ที่จะพยายามดึงข้อมูลพร็อพเพอร์ตี้ที่ระบุ
จากอุปกรณ์โดยตรงโดยไม่ใช้แคช ควรใช้วิธีนี้ (เท่านั้น) กับพร็อพเพอร์ตี้ที่มีความผันผวน
| พารามิเตอร์ | |
|---|---|
name |
String: ชื่อของค่าที่จะแสดง |
| คิกรีเทิร์น | |
|---|---|
String |
ค่าหรือ null หากไม่มีพร็อพเพอร์ตี้ |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
ShellCommandUnresponsiveException |
ในกรณีที่คำสั่งเชลล์ไม่ส่งเอาต์พุตเป็นระยะเวลาหนึ่ง |
|
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ |
getRegion
public abstract String getRegion ()
แสดงผลภูมิภาคของผู้ใช้
| คิกรีเทิร์น | |
|---|---|
String |
ภูมิภาคของผู้ใช้ หรือ null หากไม่ทราบ |
getScreenshot
public abstract RawImage getScreenshot ()
ถ่ายภาพหน้าจอของอุปกรณ์และส่งกลับเป็น RawImage
| คิกรีเทิร์น | |
|---|---|
RawImage |
ภาพหน้าจอเป็น RawImage หรือ null หากเกิดข้อผิดพลาด
ขึ้น |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
|
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ |
getScreenshot
public abstract RawImage getScreenshot (long timeout, TimeUnit unit)
| พารามิเตอร์ | |
|---|---|
timeout |
long |
unit |
TimeUnit |
| คิกรีเทิร์น | |
|---|---|
RawImage |
|
| การขว้าง | |
|---|---|
AdbCommandRejectedException |
|
TimeoutException |
|
getSerialNumber
public abstract String getSerialNumber ()
แสดงหมายเลขซีเรียลของอุปกรณ์
| คิกรีเทิร์น | |
|---|---|
String |
|
getState
public abstract IDevice.DeviceState getState ()
แสดงสถานะของอุปกรณ์
| คิกรีเทิร์น | |
|---|---|
IDevice.DeviceState |
|
getSyncService
public abstract SyncService getSyncService ()
แสดงออบเจ็กต์ SyncService เพื่อพุช / ดึงไฟล์ไปยังและจากอุปกรณ์
| คิกรีเทิร์น | |
|---|---|
SyncService |
null หากสร้าง SyncService ไม่ได้ กรณีนี้อาจเกิดขึ้นหาก adb
ปฏิเสธที่จะเปิดการเชื่อมต่อเนื่องจาก IDevice ไม่ถูกต้อง (หรือถูก
ยกเลิกการเชื่อมต่อ) |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
|
หากเชื่อมต่อกับ adb ไม่สำเร็จ |
hasClients
public abstract boolean hasClients ()
แสดงผลว่า IDevice มี Client หรือไม่
| คิกรีเทิร์น | |
|---|---|
boolean |
|
installPackage
public abstract void installPackage (String packageFilePath,
boolean reinstall,
InstallReceiver receiver,
long maxTimeout,
long maxTimeToOutputResponse,
TimeUnit maxTimeUnits,
String... extraArgs)ติดตั้งแอปพลิเคชัน Android ในอุปกรณ์ นี่คือเมธอดตัวช่วยที่รวมขั้นตอน syncPackageToDevice, installRemotePackage และ removePackage
| พารามิเตอร์ | |
|---|---|
packageFilePath |
String: เส้นทางระบบไฟล์สัมบูรณ์ไปยังไฟล์ในโฮสต์ภายในที่จะติดตั้ง |
reinstall |
boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง |
receiver |
InstallReceiver: InstallReceiverที่จะใช้ตรวจสอบการติดตั้งและรับสถานะสุดท้าย
|
maxTimeout |
long: ระยะหมดเวลาสูงสุดสำหรับคำสั่งที่จะส่งคืน ค่า 0 หมายความว่าจะไม่มีการใช้การหมดเวลาสูงสุด |
maxTimeToOutputResponse |
long: ระยะเวลาสูงสุดที่อนุญาตให้คำสั่งไม่ต้องแสดงเอาต์พุตใดๆ
ค่า 0 หมายความว่าเมธอดจะรอต่อไปเรื่อยๆ (จนกว่า receiver จะยกเลิกการดำเนินการ) สำหรับเอาต์พุตคำสั่งและจะไม่เกิดข้อผิดพลาด |
maxTimeUnits |
TimeUnit: หน่วยสำหรับค่าที่ไม่ใช่ 0 ของ maxTimeout และ maxTimeToOutputResponse
|
extraArgs |
String: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help" |
| การขว้าง | |
|---|---|
InstallException |
หากการติดตั้งไม่สำเร็จ |
installPackage
public abstract void installPackage (String packageFilePath,
boolean reinstall,
InstallReceiver receiver,
String... extraArgs)ติดตั้งแอปพลิเคชัน Android ในอุปกรณ์ นี่คือเมธอดตัวช่วยที่รวมขั้นตอน syncPackageToDevice, installRemotePackage และ removePackage
| พารามิเตอร์ | |
|---|---|
packageFilePath |
String: เส้นทางระบบไฟล์สัมบูรณ์ไปยังไฟล์ในโฮสต์ภายในที่จะติดตั้ง |
reinstall |
boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง |
receiver |
InstallReceiver: InstallReceiverที่จะใช้ตรวจสอบการติดตั้งและรับสถานะสุดท้าย
|
extraArgs |
String: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help" |
| การขว้าง | |
|---|---|
InstallException |
หากการติดตั้งไม่สำเร็จ |
installPackage
public abstract void installPackage (String packageFilePath,
boolean reinstall,
String... extraArgs)ติดตั้งแอปพลิเคชัน Android ในอุปกรณ์ นี่คือเมธอดตัวช่วยที่รวมขั้นตอน syncPackageToDevice, installRemotePackage และ removePackage
| พารามิเตอร์ | |
|---|---|
packageFilePath |
String: เส้นทางระบบไฟล์สัมบูรณ์ไปยังไฟล์ในโฮสต์ภายในที่จะติดตั้ง |
reinstall |
boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง |
extraArgs |
String: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help" |
| การขว้าง | |
|---|---|
InstallException |
หากการติดตั้งไม่สำเร็จ |
installPackages
public void installPackages (apks, boolean reinstall, installOptions)
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (ไฟล์หลัก 1 ไฟล์และแพ็กเกจแยก 0..n รายการ) โดยมีระยะหมดเวลาเริ่มต้น
| พารามิเตอร์ | |
|---|---|
apks |
: รายการ APK ที่จะติดตั้ง (APK หลัก 1 รายการ + APK แยก 0..n รายการ) |
reinstall |
boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง |
installOptions |
: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help" |
| การขว้าง | |
|---|---|
InstallException |
หากการติดตั้งไม่สำเร็จ |
installPackages
public abstract void installPackages (apks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ (แพ็กเกจหลัก 1 รายการและแพ็กเกจแยก 0..n รายการ)
| พารามิเตอร์ | |
|---|---|
apks |
: รายการ APK ที่จะติดตั้ง (APK หลัก 1 รายการ + APK แยก 0..n รายการ) |
reinstall |
boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง |
installOptions |
: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help" |
timeout |
long: หมดเวลาการติดตั้ง |
timeoutUnit |
TimeUnit: ERROR(/TimeUnit) ที่สอดคล้องกับพารามิเตอร์การหมดเวลา |
| การขว้าง | |
|---|---|
InstallException |
หากการติดตั้งไม่สำเร็จ |
installRemotePackage
public abstract void installRemotePackage (String remoteFilePath,
boolean reinstall,
InstallReceiver receiver,
String... extraArgs)ติดตั้งแพ็กเกจแอปพลิเคชันที่พุชไปยังตำแหน่งชั่วคราวในอุปกรณ์
| พารามิเตอร์ | |
|---|---|
remoteFilePath |
String: เส้นทางไฟล์แบบสัมบูรณ์ไปยังไฟล์แพ็กเกจในอุปกรณ์ |
reinstall |
boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง |
receiver |
InstallReceiver: InstallReceiverที่จะใช้ตรวจสอบการติดตั้งและรับสถานะสุดท้าย
|
extraArgs |
String: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help" |
| การขว้าง | |
|---|---|
InstallException |
หากการติดตั้งไม่สำเร็จ |
installRemotePackage
public abstract void installRemotePackage (String remoteFilePath,
boolean reinstall,
String... extraArgs)ติดตั้งแพ็กเกจแอปพลิเคชันที่พุชไปยังตำแหน่งชั่วคราวในอุปกรณ์
| พารามิเตอร์ | |
|---|---|
remoteFilePath |
String: เส้นทางไฟล์แบบสัมบูรณ์ไปยังไฟล์แพ็กเกจในอุปกรณ์ |
reinstall |
boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง |
extraArgs |
String: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help" |
| การขว้าง | |
|---|---|
InstallException |
หากการติดตั้งไม่สำเร็จ |
installRemotePackage
public abstract void installRemotePackage (String remoteFilePath,
boolean reinstall,
InstallReceiver receiver,
long maxTimeout,
long maxTimeToOutputResponse,
TimeUnit maxTimeUnits,
String... extraArgs)ติดตั้งแพ็กเกจแอปพลิเคชันที่พุชไปยังตำแหน่งชั่วคราวในอุปกรณ์
| พารามิเตอร์ | |
|---|---|
remoteFilePath |
String: เส้นทางไฟล์แบบสัมบูรณ์ไปยังไฟล์แพ็กเกจในอุปกรณ์ |
reinstall |
boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง |
receiver |
InstallReceiver: InstallReceiverที่จะใช้ตรวจสอบการติดตั้งและรับสถานะสุดท้าย
|
maxTimeout |
long: ระยะหมดเวลาสูงสุดสำหรับคำสั่งที่จะส่งคืน ค่า 0 หมายความว่าจะไม่มีการใช้การหมดเวลาสูงสุด |
maxTimeToOutputResponse |
long: ระยะเวลาสูงสุดที่อนุญาตให้คำสั่งไม่ต้องแสดงเอาต์พุตใดๆ
ค่า 0 หมายความว่าเมธอดจะรอต่อไปเรื่อยๆ (จนกว่า receiver จะยกเลิกการดำเนินการ) สำหรับเอาต์พุตคำสั่งและจะไม่เกิดข้อผิดพลาด |
maxTimeUnits |
TimeUnit: หน่วยสำหรับค่าที่ไม่ใช่ 0 ของ maxTimeout และ maxTimeToOutputResponse
|
extraArgs |
String: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help" |
| การขว้าง | |
|---|---|
InstallException |
หากการติดตั้งไม่สำเร็จ |
installRemotePackages
public void installRemotePackages (remoteApks, boolean reinstall, installOptions)
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ซึ่งอยู่ในอุปกรณ์โดยมี การหมดเวลาเริ่มต้น
| พารามิเตอร์ | |
|---|---|
remoteApks |
: รายการเส้นทางไฟล์ APK ในอุปกรณ์ที่จะติดตั้ง |
reinstall |
boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง |
installOptions |
: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help" |
| การขว้าง | |
|---|---|
InstallException |
หากการติดตั้งไม่สำเร็จ |
installRemotePackages
public void installRemotePackages (remoteApks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)
ติดตั้งแอปพลิเคชัน Android ที่สร้างจากไฟล์ APK หลายไฟล์ซึ่งอยู่ในอุปกรณ์
| พารามิเตอร์ | |
|---|---|
remoteApks |
: รายการเส้นทางไฟล์ APK ที่อยู่ในอุปกรณ์เพื่อติดตั้ง |
reinstall |
boolean: ตั้งค่าเป็น true หากควรติดตั้งแอปอีกครั้ง |
installOptions |
: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help" |
timeout |
long: หมดเวลาการติดตั้ง |
timeoutUnit |
TimeUnit: ERROR(/TimeUnit) ที่สอดคล้องกับพารามิเตอร์การหมดเวลา |
| การขว้าง | |
|---|---|
InstallException |
หากการติดตั้งไม่สำเร็จ |
isBootLoader
public abstract boolean isBootLoader ()
แสดงว่าอุปกรณ์อยู่ในโหมด Bootloader หรือไม่
| คิกรีเทิร์น | |
|---|---|
boolean |
true หาก getState() แสดงผล DeviceState.BOOTLOADER |
isEmulator
public abstract boolean isEmulator ()
แสดง true หากอุปกรณ์เป็นโปรแกรมจำลอง
| คิกรีเทิร์น | |
|---|---|
boolean |
|
isOffline
public abstract boolean isOffline ()
แสดงว่าอุปกรณ์ออฟไลน์หรือไม่
| คิกรีเทิร์น | |
|---|---|
boolean |
true หาก getState() แสดงผล DeviceState.OFFLINE |
isOnline
public abstract boolean isOnline ()
แสดงว่าอุปกรณ์พร้อมหรือไม่
| คิกรีเทิร์น | |
|---|---|
boolean |
true หาก getState() แสดงผล DeviceState.ONLINE |
isRoot
public abstract boolean isRoot ()
ค้นหาสถานะรูทปัจจุบันของอุปกรณ์ ดูข้อมูลเพิ่มเติมได้ที่ "adb root"
| คิกรีเทิร์น | |
|---|---|
boolean |
เป็นจริงหาก daemon ของ adb ทำงานในฐานะรูท มิเช่นนั้นจะเป็นเท็จ |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
ShellCommandUnresponsiveException |
|
ปิด
public void kill (String applicationName)
ปิดแอปพลิเคชันตามชื่อแอปพลิเคชัน ซึ่งจะทำลายเฉพาะกิจกรรมเท่านั้น โดยปล่อยให้สถานะของกิจกรรม อยู่ในระบบ Android เพียงอย่างเดียว
| พารามิเตอร์ | |
|---|---|
applicationName |
String: ชื่อแอปพลิเคชัน |
pullFile
public abstract void pullFile (String remote,
String local)ดึงไฟล์เดียว
| พารามิเตอร์ | |
|---|---|
remote |
String: เส้นทางแบบเต็มไปยังไฟล์ระยะไกล |
local |
String: ปลายทางในพื้นที่ |
| การขว้าง | |
|---|---|
|
ในกรณีที่เกิดข้อยกเว้น IO |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
TimeoutException |
ในกรณีที่อ่านการตอบกลับจากอุปกรณ์ไม่ทัน |
SyncException |
ในกรณีที่เกิดข้อยกเว้นในการซิงค์ |
กด
public void push (String[] local,
String remote)ส่งไฟล์หรือไดเรกทอรีหลายรายการ
| พารามิเตอร์ | |
|---|---|
local |
String: ไฟล์ในเครื่องที่จะพุช |
remote |
String: เส้นทางระยะไกลที่แสดงถึงไดเรกทอรี |
| การขว้าง | |
|---|---|
|
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
TimeoutException |
ในกรณีที่อ่านการตอบกลับจากอุปกรณ์ไม่สำเร็จเนื่องจากหมดเวลา |
SyncException |
หากพุชบางไฟล์ไม่ได้ |
pushFile
public abstract void pushFile (String local,
String remote)ส่งไฟล์เดียว
| พารามิเตอร์ | |
|---|---|
local |
String: เส้นทางไฟล์ในเครื่อง |
remote |
String: เส้นทางไฟล์ระยะไกล |
| การขว้าง | |
|---|---|
|
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
TimeoutException |
ในกรณีที่อ่านการตอบกลับจากอุปกรณ์ไม่สำเร็จเนื่องจากหมดเวลา |
SyncException |
หากพุชไฟล์ไม่ได้ |
rawBinder
public SocketChannel rawBinder (String service,
String[] parameters)เรียกใช้บริการ Android Binder Bridge ในอุปกรณ์ระยะไกล แสดงช่องซ็อกเก็ตที่เชื่อมต่อกับคำสั่งตัวเชื่อมอุปกรณ์
การเป็นเจ้าของ SocketChannel จะส่งต่อให้ผู้เรียกใช้ และต้องปิดอย่างชัดแจ้ง หลังจากใช้งาน
| พารามิเตอร์ | |
|---|---|
service |
String: ชื่อของบริการ Android ที่จะเชื่อมต่อ |
parameters |
String: พารามิเตอร์ของคำสั่ง Binder |
| คิกรีเทิร์น | |
|---|---|
SocketChannel |
SocketChannel ที่เชื่อมต่อกับกระบวนการที่ดำเนินการในอุปกรณ์หลังจากใช้งาน |
| การขว้าง | |
|---|---|
AdbCommandRejectedException |
|
TimeoutException |
|
rawExec
public SocketChannel rawExec (String executable,
String[] parameters)เรียกใช้บริการ host:exec ในอุปกรณ์ระยะไกล แสดงผลแชแนลซ็อกเก็ตที่เชื่อมต่อกับ กระบวนการที่กำลังดำเนินการ โปรดทราบว่าบริการ exec ไม่ได้แยกความแตกต่างระหว่าง stdout และ stderr ดังนั้น สิ่งที่อ่านจากซ็อกเก็ตอาจมาจากเอาต์พุตใดก็ได้และอาจมีการสลับกัน
การเป็นเจ้าของ SocketChannel จะส่งต่อให้ผู้เรียกใช้ และต้องปิดอย่างชัดแจ้ง หลังจากใช้งาน
| พารามิเตอร์ | |
|---|---|
executable |
String |
parameters |
String |
| คิกรีเทิร์น | |
|---|---|
SocketChannel |
SocketChannel ที่เชื่อมต่อกับกระบวนการที่ดำเนินการในอุปกรณ์หลังจากใช้งาน |
| การขว้าง | |
|---|---|
AdbCommandRejectedException |
|
TimeoutException |
|
รีบูต
public abstract void reboot (String into)
รีบูตอุปกรณ์
| พารามิเตอร์ | |
|---|---|
into |
String: ชื่อ Bootloader ที่จะรีบูต หรือ null เพื่อรีบูตอุปกรณ์ |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
|
IOException |
removeForward
public void removeForward (int localPort)
นำการส่งต่อพอร์ตระหว่างพอร์ตในเครื่องและพอร์ตระยะไกลออก
| พารามิเตอร์ | |
|---|---|
localPort |
int: พอร์ตในเครื่องที่จะส่งต่อ |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
|
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ |
removeForward
public void removeForward (int localPort,
int remotePort)
เลิกใช้เมธอดนี้แล้ว
ใช้ removeForward(int)
| พารามิเตอร์ | |
|---|---|
localPort |
int |
remotePort |
int |
| การขว้าง | |
|---|---|
AdbCommandRejectedException |
|
TimeoutException |
|
removeForward
public void removeForward (int localPort,
String remoteSocketName,
IDevice.DeviceUnixSocketNamespace namespace)
เลิกใช้เมธอดนี้แล้ว
ใช้ removeForward(int)
| พารามิเตอร์ | |
|---|---|
localPort |
int |
remoteSocketName |
String |
namespace |
IDevice.DeviceUnixSocketNamespace |
| การขว้าง | |
|---|---|
AdbCommandRejectedException |
|
TimeoutException |
|
removeRemotePackage
public abstract void removeRemotePackage (String remoteFilePath)
นำไฟล์ออกจากอุปกรณ์
| พารามิเตอร์ | |
|---|---|
remoteFilePath |
String: เส้นทางในอุปกรณ์ของไฟล์ที่จะนำออก |
| การขว้าง | |
|---|---|
InstallException |
หากการติดตั้งไม่สำเร็จ |
removeReverse
public void removeReverse (int remotePort)
นำการสลับพอร์ตระหว่างพอร์ตระยะไกลและพอร์ตภายในออก
| พารามิเตอร์ | |
|---|---|
remotePort |
int: พอร์ตระยะไกล |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
|
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ |
รูท
public abstract boolean root ()
ขอให้ daemon ของ adb กลายเป็นรูทในอุปกรณ์ การดำเนินการนี้อาจล้มเหลวโดยไม่มีการแจ้งเตือน และจะสำเร็จได้ ในบิลด์สำหรับนักพัฒนาแอปเท่านั้น ดูข้อมูลเพิ่มเติมได้ที่ "adb root"
| คิกรีเทิร์น | |
|---|---|
boolean |
เป็นจริงหาก daemon ของ adb ทำงานในฐานะรูท มิเช่นนั้นจะเป็นเท็จ |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
ShellCommandUnresponsiveException |
หากค้นหาสถานะรูทไม่ได้ |
|
IOException |
startScreenRecorder
public abstract void startScreenRecorder (String remoteFilePath,
ScreenRecorderOptions options,
IShellOutputReceiver receiver)เริ่มการบันทึกหน้าจอบนอุปกรณ์หากอุปกรณ์รองรับ IDevice.Feature.SCREEN_RECORD
| พารามิเตอร์ | |
|---|---|
remoteFilePath |
String |
options |
ScreenRecorderOptions |
receiver |
IShellOutputReceiver |
| การขว้าง | |
|---|---|
AdbCommandRejectedException |
|
ShellCommandUnresponsiveException |
|
TimeoutException |
|
supportsFeature
public abstract boolean supportsFeature (IDevice.HardwareFeature feature)
แสดงว่าอุปกรณ์นี้รองรับฟีเจอร์ฮาร์ดแวร์ที่ระบุหรือไม่
| พารามิเตอร์ | |
|---|---|
feature |
IDevice.HardwareFeature |
| คิกรีเทิร์น | |
|---|---|
boolean |
|
supportsFeature
public abstract boolean supportsFeature (IDevice.Feature feature)
แสดงว่าอุปกรณ์นี้รองรับฟีเจอร์ซอฟต์แวร์ที่ระบุหรือไม่
| พารามิเตอร์ | |
|---|---|
feature |
IDevice.Feature |
| คิกรีเทิร์น | |
|---|---|
boolean |
|
syncPackageToDevice
public abstract String syncPackageToDevice (String localFilePath)
ส่งไฟล์ไปยังอุปกรณ์
| พารามิเตอร์ | |
|---|---|
localFilePath |
String: เส้นทางแบบเต็มไปยังไฟล์ในโฮสต์ภายใน |
| คิกรีเทิร์น | |
|---|---|
String |
String เส้นทางปลายทางในอุปกรณ์สำหรับไฟล์ |
| การขว้าง | |
|---|---|
TimeoutException |
ในกรณีที่การเชื่อมต่อหมดเวลา |
AdbCommandRejectedException |
หาก adb ปฏิเสธคำสั่ง |
|
ในกรณีที่เกิดข้อผิดพลาด I/O ในการเชื่อมต่อ |
SyncException |
หากเกิดข้อผิดพลาดระหว่างการพุชแพ็กเกจในอุปกรณ์ |
uninstallApp
public abstract String uninstallApp (String applicationID,
String... extraArgs)ถอนการติดตั้งแอปจากอุปกรณ์
| พารามิเตอร์ | |
|---|---|
applicationID |
String: รหัสแอปพลิเคชัน Android ที่จะถอนการติดตั้ง |
extraArgs |
String: อาร์กิวเมนต์เพิ่มเติมที่ไม่บังคับที่จะส่ง ดูตัวเลือกที่มีได้ที่ "adb shell pm install --help" |
| คิกรีเทิร์น | |
|---|---|
String |
String พร้อมรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
| การขว้าง | |
|---|---|
InstallException |
หากถอนการติดตั้งไม่สำเร็จ |
uninstallPackage
public abstract String uninstallPackage (String packageName)
ถอนการติดตั้งแพ็กเกจจากอุปกรณ์
| พารามิเตอร์ | |
|---|---|
packageName |
String: รหัสแอปพลิเคชัน Android ที่จะถอนการติดตั้ง |
| คิกรีเทิร์น | |
|---|---|
String |
String พร้อมรหัสข้อผิดพลาด หรือ null หากสำเร็จ |
| การขว้าง | |
|---|---|
InstallException |
หากถอนการติดตั้งไม่สำเร็จ |