Manajer Perangkat I
public interface IDeviceManager
com.Android.tradefed.device.IDeviceManager |
Antarmuka untuk mengelola kumpulan perangkat yang tersedia untuk pengujian.
Ringkasan
Kelas bersarang | |
---|---|
interface | IDeviceManager.IFastbootListener Pendengar 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) Meminta perangkat untuk pengujian yang memenuhi kriteria tertentu. |
abstract ITestDevice | allocateDevice ( IDeviceSelection options) Meminta perangkat untuk pengujian yang memenuhi kriteria tertentu. |
abstract ITestDevice | allocateDevice () Minta perangkat fisik untuk pengujian |
abstract ITestDevice | connectToTcpDevice (String ipAndPort) Hubungkan ke perangkat dengan adb-over-tcp Metode ini mengalokasikan perangkat baru, yang pada akhirnya harus 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 adb-over-tcp. |
abstract void | displayDevicesInfo (PrintWriter printWriter, boolean includeStub) Keluarkan deskripsi ramah pengguna yang berisi daftar perangkat yang dikenal, statusnya, dan nilai 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 secara kasar, meskipun saat ini perangkat tersebut 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 yang akan 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 yang akan 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 null |
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 pembantu yang mengalihkan perangkat usb tertentu ke mode adb-over-tcp, lalu menyambungkannya 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 perpustakaan ddm. |
abstract void | terminateDeviceMonitor () Hentikan Monitor Perangkat. |
abstract void | terminateDeviceRecovery () Menghentikan thread pemulihan perangkat. |
default void | terminateHard (String reason) Suka |
abstract void | terminateHard () Suka |
abstract boolean | waitForFirstDeviceAdded (long timeout) Tunggu hingga perangkat fisik pertama terhubung. |
Metode publik
tambahkanDeviceMonitor
public abstract void addDeviceMonitor (IDeviceMonitor mon)
Menambahkan IDeviceMonitor
Parameter | |
---|---|
mon | IDeviceMonitor |
tambahkanFastbootListener
public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)
Memberi tahu manajer bahwa pendengar tertarik dengan perubahan status fastboot.
Saat iniIDeviceManager
hanya akan memonitor perangkat di fastboot jika ada satu atau lebih pendengar 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. |
mengalokasikanDevice
public abstract ITestDevice allocateDevice (IDeviceSelection options, boolean isTemporary)
Meminta perangkat untuk pengujian yang memenuhi kriteria tertentu.
Parameter | |
---|---|
options | IDeviceSelection : IDeviceSelection yang harus dipenuhi perangkat. |
isTemporary | boolean : apakah NullDevice sementara harus dibuat atau tidak. |
Kembali | |
---|---|
ITestDevice | a ITestDevice untuk pengujian, atau null jika tidak tersedia |
mengalokasikanDevice
public abstract ITestDevice allocateDevice (IDeviceSelection options)
Meminta perangkat untuk pengujian yang memenuhi kriteria tertentu.
Parameter | |
---|---|
options | IDeviceSelection : IDeviceSelection yang harus dipenuhi perangkat. |
Kembali | |
---|---|
ITestDevice | a ITestDevice untuk pengujian, atau null jika tidak tersedia |
mengalokasikanDevice
public abstract ITestDevice allocateDevice ()
Minta perangkat fisik untuk pengujian
Kembali | |
---|---|
ITestDevice | a ITestDevice untuk pengujian, atau null jika tidak tersedia |
sambungkanToTcpDevice
public abstract ITestDevice connectToTcpDevice (String ipAndPort)
Hubungkan ke perangkat dengan adb-over-tcp
Metode ini mengalokasikan perangkat baru, yang pada akhirnya harus dibebaskan melaluidisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)
ITestDevice
yang dikembalikan akan online, tetapi mungkin tidak responsif. Perhatikan bahwa melakukan tindakan seperti reboot pada perangkat yang terhubung dengan tcp, akan memutuskan koneksi tcp ke perangkat tersebut, dan menghasilkan DeviceNotAvailableException
Parameter | |
---|---|
ipAndPort | String : alamat ip asli dan port perangkat yang akan dihubungkan |
Kembali | |
---|---|
ITestDevice | ITestDevice atau null jika koneksi tcp tidak dapat dibuat |
putuskan sambunganDariTcpDevice
public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)
Putuskan sambungan dari perangkat yang terhubung adb-over-tcp.
Mengalihkan perangkat kembali ke mode usb, dan membebaskannya.Parameter | |
---|---|
tcpDevice | ITestDevice : perangkat yang saat ini dalam mode tcp, sebelumnya dialokasikan melalui connectToTcpDevice(String) |
Kembali | |
---|---|
boolean | true jika peralihan ke mode usb berhasil |
tampilanDevicesInfo
public abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)
Keluarkan deskripsi ramah pengguna yang berisi daftar perangkat yang dikenal, statusnya, dan nilai untuk opsi IDeviceSelection
yang umum digunakan.
Parameter | |
---|---|
printWriter | PrintWriter : ERROR(/PrintWriter) untuk menampilkan deskripsi |
includeStub | boolean : Apakah akan menampilkan perangkat stub 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 : Satuan untuk batas waktu. |
Kembali | |
---|---|
CommandResult | CommandResult . |
forceAllocationDevice
public abstract ITestDevice forceAllocateDevice (String serial)
Alokasikan perangkat secara kasar, meskipun saat ini perangkat tersebut tidak tersedia.
Tidak akan berpengaruh jika perangkat sudah dialokasikan.Parameter | |
---|---|
serial | String : serial perangkat yang akan dialokasikan |
Kembali | |
---|---|
ITestDevice | ITestDevice , atau null jika tidak dapat dialokasikan |
Perangkat gratis
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. |
dapatkanAdbPath
public abstract String getAdbPath ()
Mengembalikan jalur ke biner adb yang akan digunakan.
Kembali | |
---|---|
String |
dapatkanAdbVersion
public abstract String getAdbVersion ()
Dapatkan versi adb yang saat ini digunakan oleh pengelola perangkat.
Kembali | |
---|---|
String |
dapatkanDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (String serial)
Mengembalikan DeviceDescriptor dengan serial yang diberikan.
Parameter | |
---|---|
serial | String : nomor seri yang akan diperoleh perangkat |
Kembali | |
---|---|
DeviceDescriptor | DeviceDescriptor untuk perangkat yang dipilih, atau null jika serialnya tidak cocok dengan perangkat yang dikenal. |
dapatkanFastbootPath
public abstract String getFastbootPath ()
Mengembalikan jalur ke biner fastboot yang akan digunakan.
Kembali | |
---|---|
String |
inisiasi
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 |
inisiasi
public abstract void init ()
Inisialisasi pengelola perangkat. Ini harus dipanggil sekali dan hanya sekali sebelum metode lain dipanggil.
adalahEmulator
public abstract boolean isEmulator (String serial)
Tentukan apakah serial yang diberikan mewakili emulator
Parameter | |
---|---|
serial | String |
Kembali | |
---|---|
boolean |
isFileSystemMountCheckEnabled
public boolean isFileSystemMountCheckEnabled ()
Mengembalikan apakah kita harus memeriksa di NativeDeviceStateMonitor
apakah sistem file sudah terpasang dengan benar.
Kembali | |
---|---|
boolean |
adalahNullDevice
public abstract boolean isNullDevice (String serial)
Tentukan apakah serial yang diberikan mewakili perangkat null
Parameter | |
---|---|
serial | String |
Kembali | |
---|---|
boolean |
killEmulator
public abstract void killEmulator (ITestDevice device)
Matikan emulator yang diberikan.
Blokir hingga emulator menghilang dari adb. Tidak akan berpengaruh jika emulator belum tersedia.Parameter | |
---|---|
device | ITestDevice : ITestDevice yang mewakili emulator untuk dimatikan |
Melempar | |
---|---|
DeviceNotAvailableException | jika emulator gagal dimatikan |
peluncuranEmulator
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 melakukan booting atau online |
daftarSemuaPerangkat
public abstractlistAllDevices (boolean shortDescriptor)
Mengembalikan daftar DeviceDescriptors untuk semua perangkat yang dikenal
Parameter | |
---|---|
shortDescriptor | boolean : apakah akan membatasi deskriptor ke info minimum |
Kembali | |
---|---|
daftar DeviceDescriptor untuk semua perangkat yang dikenal |
daftarSemuaPerangkat
public abstractlistAllDevices ()
Mengembalikan daftar DeviceDescriptors untuk semua perangkat yang dikenal
Kembali | |
---|---|
daftar DeviceDescriptor untuk semua perangkat yang dikenal |
sambungkan kembaliDeviceToTcp
public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)
Metode pembantu yang mengalihkan perangkat usb tertentu ke mode adb-over-tcp, lalu menyambungkannya melalui connectToTcpDevice(String)
.
Parameter | |
---|---|
usbDevice | ITestDevice : perangkat yang sedang dalam mode usb |
Kembali | |
---|---|
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 |
hapusDeviceMonitor
public abstract void removeDeviceMonitor (IDeviceMonitor mon)
Menghapus IDeviceMonitor
yang ditambahkan sebelumnya. Tidak berpengaruh jika mon belum ditambahkan.
Parameter | |
---|---|
mon | IDeviceMonitor |
hapusFastbootListener
public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)
Memberi tahu manajer bahwa pendengar tidak lagi tertarik dengan perubahan status fastboot.
mulai ulangAdbBridge
public abstract void restartAdbBridge ()
Mulai ulang (jika stopAdbBridge()
dipanggil) jembatan adb dan layanan bergantung pada koneksi adb.
hentikanAdbBridge
public abstract void stopAdbBridge ()
Hentikan jembatan adb dan layanan bergantung pada koneksi adb.
mengakhiri
public abstract void terminate ()
Menghentikan layanan pemantauan perangkat, dan menghentikan perpustakaan ddm.
Ini harus dilakukan setelah penghentian aplikasi.Lihat juga:
mengakhiriDeviceMonitor
public abstract void terminateDeviceMonitor ()
Hentikan Monitor Perangkat.
mengakhiriDeviceRecovery
public abstract void terminateDeviceRecovery ()
Menghentikan thread pemulihan perangkat.
mengakhiri Keras
public void terminateHard (String reason)
Suka terminateHard()
.
Parameter | |
---|---|
reason | String : alasan opsional yang diberikan untuk penghentian. |
mengakhiri Keras
public abstract void terminateHard ()
Suka terminate()
, tetapi mencoba mematikan adb secara paksa juga.
tungguUntukPerangkatPertamaDitambahkan
public abstract boolean waitForFirstDeviceAdded (long timeout)
Tunggu hingga perangkat fisik pertama terhubung. Jika perangkat telah terhubung sebelumnya, perangkat akan langsung mengembalikan True. Jika tidak ada perangkat yang ditambahkan, ia mengembalikan false setelah waktu habis.
Parameter | |
---|---|
timeout | long : waktu menunggu dalam milidetik sebelum mengembalikan false. |
Kembali | |
---|---|
boolean |
Konten dan contoh kode di halaman ini tunduk kepada 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-12-01 UTC.