IDeviceManager
public interface IDeviceManager
com.android.tradefed.device.IDeviceManager |
Antarmuka untuk mengelola kumpulan perangkat yang tersedia untuk pengujian.
Ringkasan
Kelas bersarang | |
---|---|
interface | IDeviceManager.IFastbootListener Pendengar untuk perubahan status fastboot. |
Metode publik | |
---|---|
abstract void | addDeviceMonitor ( IDeviceMonitor mon) Menambahkan |
abstract void | addFastbootListener ( IDeviceManager.IFastbootListener listener) Memberi tahu manajer bahwa pendengar tertarik dengan perubahan status fastboot. |
abstract void | addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) Tambahkan perangkat ke monitor fastboot. |
abstract ITestDevice | allocateDevice ( IDeviceSelection options, boolean isTemporary) Minta perangkat untuk pengujian yang memenuhi kriteria tertentu. |
abstract ITestDevice | allocateDevice ( IDeviceSelection options) Minta perangkat untuk pengujian yang memenuhi kriteria tertentu. |
abstract ITestDevice | allocateDevice () Minta perangkat fisik untuk pengujian |
abstract ITestDevice | connectToTcpDevice (String ipAndPort) Sambungkan ke perangkat dengan adb-over-tcp Metode ini mengalokasikan perangkat baru, yang pada akhirnya akan dibebaskan melaluidisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) ITestDevice yang dikembalikan akan online, tetapi mungkin tidak responsif. |
abstract boolean | disconnectFromTcpDevice ( ITestDevice tcpDevice) Putuskan sambungan dari perangkat yang terhubung dengan adb-over-tcp. |
abstract void | displayDevicesInfo (PrintWriter printWriter, boolean includeStub) Keluarkan deskripsi ramah pengguna yang berisi daftar perangkat yang dikenal, statusnya, dan nilainya untuk opsi |
abstract CommandResult | executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit) Metode pembantu untuk menjalankan perintah shell pada perangkat yang tersedia. |
abstract ITestDevice | forceAllocateDevice (String serial) Alokasikan perangkat dengan kasar, meskipun saat ini tidak tersedia. |
abstract void | freeDevice ( ITestDevice device, FreeDeviceState state) Kembalikan perangkat ke kolam Upaya mengembalikan perangkat yang belum dialokasikan sebelumnya akan diabaikan. |
abstract String | getAdbPath () Mengembalikan jalur ke biner adb untuk digunakan. |
abstract String | getAdbVersion () Dapatkan versi adb yang saat ini digunakan oleh pengelola perangkat. |
abstract DeviceDescriptor | getDeviceDescriptor (String serial) Mengembalikan DeviceDescriptor dengan serial yang diberikan. |
abstract String | getFastbootPath () Mengembalikan jalur ke biner fastboot untuk digunakan. |
abstract void | init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors) Inisialisasi pengelola perangkat dengan filter perangkat. |
abstract void | init () Inisialisasi pengelola perangkat. |
abstract boolean | isEmulator (String serial) Tentukan apakah serial yang diberikan mewakili emulator |
default boolean | isFileSystemMountCheckEnabled () Mengembalikan apakah kita harus memeriksa di |
abstract boolean | isNullDevice (String serial) Tentukan apakah serial yang diberikan mewakili perangkat nol |
abstract void | killEmulator ( ITestDevice device) Matikan emulator yang diberikan. |
abstract void | launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) Metode pembantu untuk meluncurkan emulator. |
abstract | listAllDevices (boolean shortDescriptor) Mengembalikan daftar DeviceDescriptors untuk semua perangkat yang dikenal |
abstract | listAllDevices () Mengembalikan daftar DeviceDescriptors untuk semua perangkat yang dikenal |
abstract ITestDevice | reconnectDeviceToTcp ( ITestDevice usbDevice) Metode bantuan yang mengalihkan perangkat usb yang diberikan ke mode adb-over-tcp, lalu menghubungkannya melalui |
abstract void | removeDeviceMonitor ( IDeviceMonitor mon) Menghapus |
abstract void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) Memberi tahu manajer bahwa pendengar tidak lagi tertarik dengan perubahan status fastboot. |
abstract void | restartAdbBridge () Mulai ulang (jika |
abstract void | stopAdbBridge () Hentikan jembatan adb dan layanan bergantung pada koneksi adb. |
abstract void | terminate () Menghentikan layanan pemantauan perangkat, dan menghentikan pustaka ddm. |
abstract void | terminateDeviceMonitor () Hentikan Monitor Perangkat. |
abstract void | terminateDeviceRecovery () Menghentikan utas pemulihan perangkat. |
default void | terminateHard (String reason) Seperti |
abstract void | terminateHard () Seperti |
abstract boolean | waitForFirstDeviceAdded (long timeout) Tunggu hingga perangkat fisik pertama tersambung. |
Metode publik
addDeviceMonitor
public abstract void addDeviceMonitor (IDeviceMonitor mon)
Menambahkan IDeviceMonitor
Parameter | |
---|---|
mon | IDeviceMonitor |
addFastbootListener
public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)
Memberi tahu manajer bahwa pendengar tertarik dengan perubahan status fastboot.
Saat iniIDeviceManager
hanya akan memantau perangkat di fastboot jika ada satu atau lebih pendengar yang aktif. TODO: ini sedikit peretasan - temukan solusi yang lebih baik addMonitoringTcpFastbootDevice
public abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)
Tambahkan perangkat ke monitor fastboot. Monitor fastboot akan menggunakan 'fastboot_serial' untuk berkomunikasi dengan perangkat.
Parameter | |
---|---|
serial | String : nomor seri perangkat. |
fastboot_serial | String : nomor seri mode fastboot perangkat. |
alokasikan Perangkat
public abstract ITestDevice allocateDevice (IDeviceSelection options, boolean isTemporary)
Minta perangkat untuk pengujian yang memenuhi kriteria tertentu.
Parameter | |
---|---|
options | IDeviceSelection : IDeviceSelection yang harus dipenuhi perangkat. |
isTemporary | boolean : apakah NullDevice sementara harus dibuat atau tidak. |
Pengembalian | |
---|---|
ITestDevice | a ITestDevice untuk pengujian, atau null jika tidak tersedia |
alokasikan Perangkat
public abstract ITestDevice allocateDevice (IDeviceSelection options)
Minta perangkat untuk pengujian yang memenuhi kriteria tertentu.
Parameter | |
---|---|
options | IDeviceSelection : IDeviceSelection yang harus dipenuhi perangkat. |
Pengembalian | |
---|---|
ITestDevice | a ITestDevice untuk pengujian, atau null jika tidak tersedia |
alokasikan Perangkat
public abstract ITestDevice allocateDevice ()
Minta perangkat fisik untuk pengujian
Pengembalian | |
---|---|
ITestDevice | a ITestDevice untuk pengujian, atau null jika tidak tersedia |
connectToTcpDevice
public abstract ITestDevice connectToTcpDevice (String ipAndPort)
Sambungkan ke perangkat dengan adb-over-tcp
Metode ini mengalokasikan perangkat baru, yang pada akhirnya akan dibebaskan melaluidisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)
ITestDevice
yang dikembalikan akan online, tetapi mungkin tidak responsif. Perhatikan bahwa melakukan tindakan seperti me-reboot perangkat yang terhubung dengan tcp, akan memutuskan koneksi tcp ke perangkat, dan menghasilkan DeviceNotAvailableException
Parameter | |
---|---|
ipAndPort | String : alamat ip asli dan port perangkat yang akan dihubungkan |
Pengembalian | |
---|---|
ITestDevice | ITestDevice atau null jika koneksi tcp tidak dapat dibuat |
disconnectFromTcpDevice
public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)
Putuskan sambungan dari perangkat yang terhubung dengan adb-over-tcp.
Mengalihkan perangkat kembali ke mode usb, dan membebaskannya.Parameter | |
---|---|
tcpDevice | ITestDevice : perangkat saat ini dalam mode tcp, sebelumnya dialokasikan melalui connectToTcpDevice(String) |
Pengembalian | |
---|---|
boolean | true jika beralih ke mode usb berhasil |
displayDevicesInfo
public abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)
Keluarkan deskripsi ramah pengguna yang berisi daftar perangkat yang dikenal, statusnya, dan nilainya untuk opsi IDeviceSelection
yang umum digunakan.
Parameter | |
---|---|
printWriter | PrintWriter : ERROR(/PrintWriter) untuk menampilkan deskripsi |
includeStub | boolean : Apakah akan menampilkan perangkat rintisan juga atau tidak. |
jalankanCmdOnAvailableDevice
public abstract CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)
Metode pembantu untuk menjalankan perintah shell pada perangkat yang tersedia.
Parameter | |
---|---|
serial | String : Serial perangkat. |
command | String : Perintah shell. |
timeout | long : Jumlah waktu untuk menyelesaikan perintah. |
timeUnit | TimeUnit : Unit untuk batas waktu. |
Pengembalian | |
---|---|
CommandResult | Sebuah CommandResult . |
forceAllocateDevice
public abstract ITestDevice forceAllocateDevice (String serial)
Alokasikan perangkat dengan kasar, meskipun saat ini tidak tersedia.
Tidak akan berpengaruh jika perangkat sudah dialokasikan.Parameter | |
---|---|
serial | String : serial perangkat yang akan dialokasikan |
Pengembalian | |
---|---|
ITestDevice | ITestDevice , atau null jika tidak dapat dialokasikan |
freeDevice
public abstract void freeDevice (ITestDevice device, FreeDeviceState state)
Kembalikan perangkat ke kolam
Upaya mengembalikan perangkat yang belum dialokasikan sebelumnya akan diabaikan.Parameter | |
---|---|
device | ITestDevice : ITestDevice gratis |
state | FreeDeviceState : FreeDeviceState . Digunakan untuk mengontrol apakah perangkat dikembalikan ke kumpulan perangkat yang tersedia. |
getAdbPath
public abstract String getAdbPath ()
Mengembalikan jalur ke biner adb untuk digunakan.
Pengembalian | |
---|---|
String |
getAdbVersion
public abstract String getAdbVersion ()
Dapatkan versi adb yang saat ini digunakan oleh pengelola perangkat.
Pengembalian | |
---|---|
String |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (String serial)
Mengembalikan DeviceDescriptor dengan serial yang diberikan.
Parameter | |
---|---|
serial | String : nomor seri untuk mendapatkan perangkat |
Pengembalian | |
---|---|
DeviceDescriptor | DeviceDescriptor untuk perangkat yang dipilih, atau null jika serial tidak cocok dengan perangkat yang dikenal. |
getFastbootPath
public abstract String getFastbootPath ()
Mengembalikan jalur ke biner fastboot untuk digunakan.
Pengembalian | |
---|---|
String |
init
public abstract void init (IDeviceSelection globalDeviceFilter,deviceMonitors)
Inisialisasi pengelola perangkat dengan filter perangkat. Filter ini dapat digunakan untuk menginstruksikan DeviceManager untuk mengabaikan perangkat tertentu yang terhubung.
Parameter | |
---|---|
globalDeviceFilter | IDeviceSelection : filter perangkat |
deviceMonitors |
init
public abstract void init ()
Inisialisasi pengelola perangkat. Ini harus dipanggil sekali dan hanya sekali sebelum metode lain dipanggil.
isEmulator
public abstract boolean isEmulator (String serial)
Tentukan apakah serial yang diberikan mewakili emulator
Parameter | |
---|---|
serial | String |
Pengembalian | |
---|---|
boolean |
isFileSystemMountCheckEnabled
public boolean isFileSystemMountCheckEnabled ()
Mengembalikan apakah kita harus memeriksa di NativeDeviceStateMonitor
apakah sistem file sudah terpasang dengan benar.
Pengembalian | |
---|---|
boolean |
isNullDevice
public abstract boolean isNullDevice (String serial)
Tentukan apakah serial yang diberikan mewakili perangkat nol
Parameter | |
---|---|
serial | String |
Pengembalian | |
---|---|
boolean |
killEmulator
public abstract void killEmulator (ITestDevice device)
Matikan emulator yang diberikan.
Memblokir hingga emulator menghilang dari adb. Tidak akan berpengaruh jika emulator sudah tidak tersedia.Parameter | |
---|---|
device | ITestDevice : ITestDevice yang mewakili emulator untuk dimatikan |
Melempar | |
---|---|
DeviceNotAvailableException | jika emulator gagal dimatikan |
launchEmulator
public abstract void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
Metode pembantu untuk meluncurkan emulator.
Akan meluncurkan emulator seperti yang ditentukan oleh pemanggilParameter | |
---|---|
device | ITestDevice : placeholder ITestDevice yang mewakili perangkat emulator yang dialokasikan |
bootTimeout | long : waktu dalam ms untuk menunggu emulator melakukan booting |
emulatorArgs |
Melempar | |
---|---|
DeviceNotAvailableException | jika emulator gagal untuk boot atau online |
listAllDevices
public abstractlistAllDevices (boolean shortDescriptor)
Mengembalikan daftar DeviceDescriptors untuk semua perangkat yang dikenal
Parameter | |
---|---|
shortDescriptor | boolean : apakah akan membatasi deskriptor ke info minimum |
Pengembalian | |
---|---|
daftar DeviceDescriptor untuk semua perangkat yang dikenal |
listAllDevices
public abstractlistAllDevices ()
Mengembalikan daftar DeviceDescriptors untuk semua perangkat yang dikenal
Pengembalian | |
---|---|
daftar DeviceDescriptor untuk semua perangkat yang dikenal |
sambungkan kembaliDeviceToTcp
public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)
Metode bantuan yang mengalihkan perangkat usb yang diberikan ke mode adb-over-tcp, lalu menghubungkannya melalui connectToTcpDevice(String)
.
Parameter | |
---|---|
usbDevice | ITestDevice : perangkat saat ini dalam mode usb |
Pengembalian | |
---|---|
ITestDevice | ITestDevice yang baru dialokasikan dalam mode tcp atau null jika koneksi tcp tidak dapat dibuat |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan usbDevice terputus dan tidak dapat dipulihkan |
hapus DeviceMonitor
public abstract void removeDeviceMonitor (IDeviceMonitor mon)
Menghapus IDeviceMonitor
yang ditambahkan sebelumnya. Tidak berpengaruh jika mon belum ditambahkan.
Parameter | |
---|---|
mon | IDeviceMonitor |
hapus FastbootListener
public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)
Memberi tahu manajer bahwa pendengar tidak lagi tertarik dengan perubahan status fastboot.
restartAdbBridge
public abstract void restartAdbBridge ()
Mulai ulang (jika stopAdbBridge()
dipanggil) jembatan adb dan layanan bergantung pada koneksi adb.
stopAdbBridge
public abstract void stopAdbBridge ()
Hentikan jembatan adb dan layanan bergantung pada koneksi adb.
mengakhiri
public abstract void terminate ()
Menghentikan layanan pemantauan perangkat, dan menghentikan pustaka ddm.
Ini harus dipanggil setelah penghentian aplikasi.Lihat juga:
terminasiDeviceMonitor
public abstract void terminateDeviceMonitor ()
Hentikan Monitor Perangkat.
terminasiDeviceRecovery
public abstract void terminateDeviceRecovery ()
Menghentikan utas pemulihan perangkat.
menghentikanHard
public void terminateHard (String reason)
Seperti terminateHard()
.
Parameter | |
---|---|
reason | String : alasan opsional yang diberikan untuk penghentian. |
menghentikanHard
public abstract void terminateHard ()
Seperti terminate()
, tetapi mencoba untuk mematikan paksa adb juga.
waitForFirstDeviceAdded
public abstract boolean waitForFirstDeviceAdded (long timeout)
Tunggu hingga perangkat fisik pertama terhubung. Jika perangkat terhubung sebelumnya, itu langsung mengembalikan True. Jika tidak ada perangkat yang ditambahkan, itu mengembalikan salah setelah waktu habis.
Parameter | |
---|---|
timeout | long : waktu untuk menunggu dalam milidetik sebelum kembali salah. |
Pengembalian | |
---|---|
boolean |
Konten dan contoh kode di halaman ini tunduk pada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2023-03-30 UTC.