Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

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 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 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 NativeDeviceStateMonitor sistem file terpasang dengan benar atau tidak.

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

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 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 dan layanan adb 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 juga mencoba untuk mematikan adb secara paksa.

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 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 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, 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 penelepon

Parameter
device ITestDevice : placeholder ITestDevice mewakili perangkat emulator yang dialokasikan

bootTimeout long : waktu dalam ms untuk menunggu emulator boot

emulatorArgs : argumen baris perintah untuk meluncurkan emulator

Melempar
DeviceNotAvailableException jika emulator gagal untuk boot atau online

daftarSemuaPerangkat

public abstract  listAllDevices ()

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.

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