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 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)

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

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 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 perpustakaan ddm.

abstract void terminateDeviceMonitor ()

Hentikan Monitor Perangkat.

abstract void terminateDeviceRecovery ()

Menghentikan thread pemulihan perangkat.

default void terminateHard (String reason)

Suka terminateHard() .

abstract void terminateHard ()

Suka terminate() , tetapi mencoba mematikan adb secara paksa juga.

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 ini IDeviceManager 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 melalui disconnectFromTcpDevice(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 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 melakukan booting atau online

daftarSemuaPerangkat

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

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.

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