IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Antarmuka untuk mengelola kumpulan perangkat yang tersedia untuk pengujian.

Ringkasan

Class bertingkat

interface IDeviceManager.IFastbootListener

Pemroses untuk perubahan status fastboot. 

Metode publik

abstract void addDeviceMonitor(IDeviceMonitor mon)

Menambahkan IDeviceMonitor

abstract void addFastbootListener(IDeviceManager.IFastbootListener listener)

Memberi tahu pengelola bahwa pemroses tertarik dengan perubahan status fastboot.

abstract void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

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

Meminta perangkat fisik untuk pengujian

abstract ITestDevice connectToTcpDevice(String ipAndPort)

Menghubungkan 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 ditampilkan akan online, tetapi mungkin tidak responsif.

abstract boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

Memutuskan koneksi dari perangkat yang terhubung adb-over-tcp.

abstract void displayDevicesInfo(PrintWriter printWriter, boolean includeStub)

Menampilkan deskripsi yang mudah digunakan yang berisi daftar perangkat yang diketahui, statusnya, dan nilai untuk opsi IDeviceSelection yang umum digunakan.

abstract CommandResult executeCmdOnAvailableDevice(String serial, String command, long timeout, TimeUnit timeUnit)

Metode bantuan untuk menjalankan perintah shell di perangkat yang tersedia.

abstract ITestDevice forceAllocateDevice(String serial)

Mengalokasikan perangkat secara kasar, meskipun saat ini tidak tersedia.

abstract void freeDevice(ITestDevice device, FreeDeviceState state)

Mengembalikan perangkat ke kumpulan

Upaya untuk menampilkan perangkat yang belum dialokasikan sebelumnya akan diabaikan.

abstract String getAdbPath()

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

Menampilkan DeviceDescriptor dengan serial yang diberikan.

abstract String getFastbootPath()

Menampilkan jalur ke biner fastboot yang akan digunakan.

abstract void init(IDeviceSelection globalDeviceFilter, deviceMonitors)

Lakukan inisialisasi pengelola perangkat dengan filter perangkat.

abstract void init()

Lakukan inisialisasi pengelola perangkat.

abstract boolean isEmulator(String serial)

Menentukan apakah serial yang diberikan mewakili emulator

default boolean isFileSystemMountCheckEnabled()

Menampilkan apakah kita harus memeriksa di NativeDeviceStateMonitor apakah sistem file terpasang dengan benar atau tidak.

abstract boolean isNullDevice(String serial)

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

Metode bantuan untuk meluncurkan emulator.

abstract listAllDevices(boolean shortDescriptor)

Menampilkan daftar DeviceDescriptors untuk semua perangkat yang diketahui

abstract listAllDevices()

Menampilkan daftar DeviceDescriptors untuk semua perangkat yang diketahui

abstract ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

Metode bantuan yang mengalihkan perangkat USB yang diberikan ke mode adb-over-tcp, lalu menghubungkan ke perangkat tersebut melalui connectToTcpDevice(String).

abstract void removeDeviceMonitor(IDeviceMonitor mon)

Menghapus IDeviceMonitor yang sebelumnya ditambahkan.

abstract void removeFastbootListener(IDeviceManager.IFastbootListener listener)

Memberi tahu pengelola bahwa pemroses 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()

Menghentikan jembatan adb dan layanan bergantung pada koneksi adb.

abstract void terminate()

Menghentikan layanan pemantauan perangkat, dan menghentikan library ddm.

abstract void terminateDeviceMonitor()

Hentikan Monitor Perangkat.

abstract void terminateDeviceRecovery()

Menghentikan thread pemulihan perangkat.

default void terminateHard(String reason)

Seperti terminateHard().

abstract void terminateHard()

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

abstract boolean waitForFirstDeviceAdded(long timeout)

Tunggu hingga perangkat fisik pertama terhubung.

Metode publik

addDeviceMonitor

public abstract void addDeviceMonitor (IDeviceMonitor mon)

Menambahkan IDeviceMonitor

Parameter
mon IDeviceMonitor

addFastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

Memberi tahu pengelola bahwa pemroses tertarik dengan perubahan status fastboot.

Saat ini, IDeviceManager hanya akan memantau perangkat dalam fastboot jika ada satu atau beberapa pemroses yang aktif.

TODO: ini adalah sedikit hack - temukan solusi yang lebih baik

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

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

allocateDevice

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.
Hasil
ITestDevice ITestDevice untuk pengujian, atau null jika tidak tersedia

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options)

Meminta perangkat untuk pengujian yang memenuhi kriteria tertentu.

Parameter
options IDeviceSelection: IDeviceSelection yang harus dipenuhi perangkat.
Hasil
ITestDevice ITestDevice untuk pengujian, atau null jika tidak tersedia

allocateDevice

public abstract ITestDevice allocateDevice ()

Meminta perangkat fisik untuk pengujian

Hasil
ITestDevice ITestDevice untuk pengujian, atau null jika tidak tersedia

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Menghubungkan 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 ditampilkan akan online, tetapi mungkin tidak responsif.

Perhatikan bahwa melakukan tindakan seperti memulai ulang pada perangkat yang terhubung ke tcp akan memutuskan koneksi tcp ke perangkat, dan menghasilkan DeviceNotAvailableException

Parameter
ipAndPort String: alamat IP dan port asli perangkat yang akan dihubungkan
Hasil
ITestDevice ITestDevice atau null jika koneksi TCP tidak dapat dibuat

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Memutuskan koneksi 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)
Hasil
boolean true jika beralih ke mode USB berhasil

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Menampilkan deskripsi yang mudah digunakan yang berisi daftar perangkat yang diketahui, statusnya, dan nilai untuk opsi IDeviceSelection yang umum digunakan.

Parameter
printWriter PrintWriter: ERROR(/PrintWriter) untuk menampilkan deskripsi
includeStub boolean: Apakah akan menampilkan perangkat stub atau tidak.

executeCmdOnAvailableDevice

public abstract CommandResult executeCmdOnAvailableDevice (String serial, 
                String command, 
                long timeout, 
                TimeUnit timeUnit)

Metode bantuan untuk menjalankan perintah shell di perangkat yang tersedia.

Parameter
serial String: Serial perangkat.
command String: Perintah shell.
timeout long: Jumlah waktu yang diperlukan untuk menyelesaikan perintah.
timeUnit TimeUnit: Unit untuk waktu tunggu.
Hasil
CommandResult CommandResult.

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Mengalokasikan perangkat secara kasar, meskipun saat ini tidak tersedia.

Tidak akan berpengaruh jika perangkat sudah dialokasikan.

Parameter
serial String: serial perangkat yang akan dialokasikan
Hasil
ITestDevice ITestDevice, atau null jika tidak dapat dialokasikan

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Mengembalikan perangkat ke kumpulan

Upaya untuk menampilkan perangkat yang belum dialokasikan sebelumnya akan diabaikan.

Parameter
device ITestDevice: ITestDevice untuk dikosongkan
state FreeDeviceState: FreeDeviceState. Digunakan untuk mengontrol apakah perangkat dikembalikan ke kumpulan perangkat yang tersedia.

getAdbPath

public abstract String getAdbPath ()

Menampilkan jalur ke biner adb yang akan digunakan.

Hasil
String

getAdbVersion

public abstract String getAdbVersion ()

Dapatkan versi adb yang saat ini digunakan oleh pengelola perangkat.

Hasil
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

Menampilkan DeviceDescriptor dengan serial yang diberikan.

Parameter
serial String: nomor seri untuk perangkat yang akan diperoleh
Hasil
DeviceDescriptor DeviceDescriptor untuk perangkat yang dipilih, atau null jika serial tidak cocok dengan perangkat yang diketahui.

getFastbootPath

public abstract String getFastbootPath ()

Menampilkan jalur ke biner fastboot yang akan digunakan.

Hasil
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Lakukan inisialisasi pengelola perangkat dengan filter perangkat. Filter ini dapat digunakan untuk menginstruksikan DeviceManager untuk mengabaikan perangkat terhubung tertentu.

Parameter
globalDeviceFilter IDeviceSelection: filter perangkat
deviceMonitors

init

public abstract void init ()

Lakukan inisialisasi pengelola perangkat. Metode ini harus dipanggil sekali dan hanya sekali sebelum metode lainnya dipanggil.

isEmulator

public abstract boolean isEmulator (String serial)

Menentukan apakah serial yang diberikan mewakili emulator

Parameter
serial String

Hasil
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Menampilkan apakah kita harus memeriksa di NativeDeviceStateMonitor apakah sistem file terpasang dengan benar atau tidak.

Hasil
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Menentukan apakah serial yang diberikan mewakili perangkat null

Parameter
serial String

Hasil
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
Menampilkan
DeviceNotAvailableException jika emulator gagal dinonaktifkan

launchEmulator

public abstract void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                 emulatorArgs)

Metode bantuan 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 md untuk menunggu emulator melakukan booting
emulatorArgs : argumen command line untuk meluncurkan emulator
Menampilkan
DeviceNotAvailableException jika emulator gagal melakukan booting atau online

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

Menampilkan daftar DeviceDescriptors untuk semua perangkat yang diketahui

Parameter
shortDescriptor boolean: apakah akan membatasi deskripsi ke info minimum
Hasil
daftar DeviceDescriptor untuk semua perangkat yang diketahui

listAllDevices

public abstract  listAllDevices ()

Menampilkan daftar DeviceDescriptors untuk semua perangkat yang diketahui

Hasil
daftar DeviceDescriptor untuk semua perangkat yang diketahui

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Metode bantuan yang mengalihkan perangkat USB yang diberikan ke mode adb-over-tcp, lalu menghubungkan ke perangkat tersebut melalui connectToTcpDevice(String).

Parameter
usbDevice ITestDevice: perangkat saat ini dalam mode USB
Hasil
ITestDevice ITestDevice yang baru dialokasikan dalam mode tcp atau null jika koneksi TCP tidak dapat dibuat
Menampilkan
DeviceNotAvailableException jika koneksi dengan usbDevice terputus dan tidak dapat dipulihkan

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Menghapus IDeviceMonitor yang sebelumnya ditambahkan. Tidak berpengaruh jika mon belum ditambahkan.

Parameter
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Memberi tahu pengelola bahwa pemroses 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 ()

Menghentikan jembatan adb dan layanan bergantung pada koneksi adb.

terminate

public abstract void terminate ()

Menghentikan layanan pemantauan perangkat, dan menghentikan library ddm.

Ini harus dipanggil setelah penghentian aplikasi.

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

Hentikan Monitor Perangkat.

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

Menghentikan thread pemulihan perangkat.

terminateHard

public void terminateHard (String reason)

Seperti terminateHard().

Parameter
reason String: alasan opsional yang diberikan untuk penghentian.

terminateHard

public abstract void terminateHard ()

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

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Tunggu hingga perangkat fisik pertama terhubung. Jika perangkat telah terhubung sebelumnya, perangkat akan langsung menampilkan True. Jika tidak ada perangkat yang ditambahkan, nilai yang ditampilkan adalah salah (false) setelah waktu tunggu habis.

Parameter
timeout long: waktu tunggu dalam milidetik sebelum menampilkan nilai salah.
Hasil
boolean