IDeviceManager
public interface IDeviceManager
com.android.tradefed.device.IDeviceManager |
Antarmuka untuk mengelola kumpulan perangkat yang tersedia untuk pengujian.
Ringkasan
Kelas bersarang | |
---|---|
interface | IDeviceManager.IFastbootListener Listener 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) 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 tidak tersedia. |
abstract void | freeDevice ( ITestDevice device, FreeDeviceState state) Kembalikan perangkat ke kolam Upaya untuk mengembalikan perangkat yang sebelumnya tidak dialokasikan 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 pembantu yang mengalihkan perangkat usb yang diberikan ke mode adb-over-tcp, dan kemudian 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 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 memantau perangkat di fastboot jika ada satu atau lebih pendengar yang aktif. TODO: ini sedikit peretasan - temukan solusi yang lebih baik tambahkanMonitoringTcpFastbootDevice
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. |
mengalokasikanPerangkat
public abstract ITestDevice allocateDevice (IDeviceSelection options, boolean isTemporary)
Meminta perangkat untuk pengujian yang memenuhi kriteria tertentu.
Parameter | |
---|---|
options | IDeviceSelection : IDeviceSelection yang harus dipenuhi oleh perangkat. |
isTemporary | boolean : apakah NullDevice sementara harus dibuat atau tidak. |
Kembali | |
---|---|
ITestDevice | ITestDevice untuk pengujian, atau null jika tidak tersedia |
mengalokasikanPerangkat
public abstract ITestDevice allocateDevice (IDeviceSelection options)
Meminta perangkat untuk pengujian yang memenuhi kriteria tertentu.
Parameter | |
---|---|
options | IDeviceSelection : IDeviceSelection yang harus dipenuhi oleh perangkat. |
Kembali | |
---|---|
ITestDevice | ITestDevice untuk pengujian, atau null jika tidak tersedia |
mengalokasikanPerangkat
public abstract ITestDevice allocateDevice ()
Minta perangkat fisik untuk pengujian
Kembali | |
---|---|
ITestDevice | ITestDevice untuk pengujian, atau null jika tidak tersedia |
connectToTcpDevice
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, dan menghasilkan DeviceNotAvailableException
Parameter | |
---|---|
ipAndPort | String : alamat ip asli dan port perangkat yang akan disambungkan |
Kembali | |
---|---|
ITestDevice | ITestDevice atau null jika koneksi tcp tidak dapat dibentuk |
putuskanDariTcpDevice
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 saat ini dalam mode tcp, sebelumnya dialokasikan melalui connectToTcpDevice(String) |
Kembali | |
---|---|
boolean | true jika beralih 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 ke |
includeStub | boolean : Apakah perangkat rintisan juga akan ditampilkan atau tidak. |
eksekusiCmdOnAvailableDevice
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 | Hasil CommandResult . |
forceAlocateDevice
public abstract ITestDevice forceAllocateDevice (String serial)
Alokasikan perangkat secara kasar, meskipun saat ini 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 untuk mengembalikan perangkat yang sebelumnya tidak dialokasikan 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 untuk digunakan.
Kembali | |
---|---|
String |
getAdbVersion
public abstract String getAdbVersion ()
Dapatkan versi adb yang saat ini digunakan oleh pengelola perangkat.
Kembali | |
---|---|
String |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (String serial)
Mengembalikan DeviceDescriptor dengan serial yang diberikan.
Parameter | |
---|---|
serial | String : nomor seri untuk perangkat untuk mendapatkan |
Kembali | |
---|---|
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.
Kembali | |
---|---|
String |
init
public abstract void init (IDeviceSelection globalDeviceFilter,deviceMonitors)
Inisialisasi pengelola perangkat dengan filter perangkat. Filter ini dapat digunakan untuk menginstruksikan DeviceManager agar 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.
adalah Emulator
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
sistem file terpasang dengan benar atau tidak.
Kembali | |
---|---|
boolean |
adalahNullDevice
public abstract boolean isNullDevice (String serial)
Tentukan apakah serial yang diberikan mewakili perangkat nol
Parameter | |
---|---|
serial | String |
Kembali | |
---|---|
boolean |
bunuh Emulator
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 |
luncurkan Emulator
public abstract void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
Metode pembantu untuk meluncurkan emulator.
Akan meluncurkan emulator seperti yang ditentukan oleh peneleponParameter | |
---|---|
device | ITestDevice : placeholder ITestDevice mewakili perangkat emulator yang dialokasikan |
bootTimeout | long : waktu dalam ms untuk menunggu emulator boot |
emulatorArgs |
Melempar | |
---|---|
DeviceNotAvailableException | jika emulator gagal untuk boot 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 kembaliPerangkatKeTcp
public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)
Metode pembantu yang mengalihkan perangkat usb yang diberikan ke mode adb-over-tcp, dan kemudian menghubungkannya melalui connectToTcpDevice(String)
.
Parameter | |
---|---|
usbDevice | ITestDevice : perangkat saat ini dalam mode usb |
Kembali | |
---|---|
ITestDevice | ITestDevice yang baru dialokasikan dalam mode tcp atau null jika koneksi tcp tidak dapat dibentuk |
Melempar | |
---|---|
DeviceNotAvailableException | jika koneksi dengan usbDevice 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.
restartAdbBridge
public abstract void restartAdbBridge ()
Mulai ulang (jika stopAdbBridge()
dipanggil) jembatan dan layanan adb bergantung pada koneksi adb.
berhentiAdbBridge
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 pada saat penghentian aplikasi.Lihat juga:
mengakhiriDeviceMonitor
public abstract void terminateDeviceMonitor ()
Hentikan Monitor Perangkat.
mengakhiriPerangkatPemulihan
public abstract void terminateDeviceRecovery ()
Menghentikan utas pemulihan perangkat.
terminasi Keras
public void terminateHard (String reason)
Seperti terminateHard()
.
Parameter | |
---|---|
reason | String : alasan opsional yang diberikan untuk penghentian. |
terminasi Keras
public abstract void terminateHard ()
Seperti terminate()
, tetapi juga mencoba untuk mematikan adb secara paksa.
tungguPerangkatPertamaDitambahkan
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 untuk menunggu dalam milidetik sebelum mengembalikan false. |
Kembali | |
---|---|
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 2022-11-07 UTC.