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 IDeviceMonitor

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 melalui disconnectFromTcpDevice(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 IDeviceSelection yang umum digunakan.

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 NativeDeviceStateMonitor apakah sistem file sudah terpasang dengan benar.

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 connectToTcpDevice(String) .

abstract void removeDeviceMonitor ( IDeviceMonitor mon)

Menghapus IDeviceMonitor yang ditambahkan sebelumnya.

abstract void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

Memberi tahu manajer bahwa pendengar tidak lagi tertarik dengan perubahan status fastboot.

abstract void restartAdbBridge ()

Mulai ulang (jika stopAdbBridge() dipanggil) jembatan adb dan layanan bergantung pada koneksi adb.

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 terminateHard() .

abstract void terminateHard ()

Seperti terminate() , tetapi mencoba untuk mematikan paksa adb juga.

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 ini IDeviceManager 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 melalui disconnectFromTcpDevice(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 pemanggil

Parameter
device ITestDevice : placeholder ITestDevice yang mewakili perangkat emulator yang dialokasikan

bootTimeout long : waktu dalam ms untuk menunggu emulator melakukan booting

emulatorArgs : argumen baris perintah untuk meluncurkan emulator

Melempar
DeviceNotAvailableException jika emulator gagal untuk boot atau online

listAllDevices

public abstract  listAllDevices (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 abstract  listAllDevices ()

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.

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