PengelolaPerangkat

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


Antarmuka untuk mengelola serangkaian 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)

Minta perangkat untuk pengujian yang memenuhi kriteria tertentu.

abstract ITestDevice allocateDevice(IDeviceSelection options)

Minta 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 harus dibebaskan melalui disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

ITestDevice yang ditampilkan akan online, tetapi mungkin tidak responsif.

abstract boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

Putuskan hubungan dari perangkat yang terhubung adb-over-tcp.

abstract void displayDevicesInfo(PrintWriter printWriter, boolean includeStub)

Menghasilkan deskripsi yang mudah digunakan yang berisi daftar perangkat yang diketahui, status, dan nilainya untuk opsi IDeviceSelection yang umum digunakan.

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

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

Mengembalikan perangkat ke kolam

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 seri 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 tertentu mewakili emulator atau tidak

default boolean isFileSystemMountCheckEnabled()

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

abstract boolean isNullDevice(String serial)

Menentukan apakah seri tertentu mewakili perangkat null

abstract void killEmulator(ITestDevice device)

Matikan emulator yang ditentukan.

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

Metode helper 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 tertentu ke mode adb-over-tcp, lalu terhubung ke melalui connectToTcpDevice(String).

abstract void removeDeviceMonitor(IDeviceMonitor mon)

Menghapus IDeviceMonitor yang ditambahkan sebelumnya.

abstract void removeFastbootListener(IDeviceManager.IFastbootListener listener)

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

abstract void restartAdbBridge()

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

abstract void stopAdbBridge()

Menghentikan jembatan dan layanan adb bergantung pada koneksi adb.

abstract void terminate()

Menghentikan layanan pemantauan perangkat, dan menghentikan library ddm.

abstract void terminateDeviceMonitor()

Hentikan Device Monitor.

abstract void terminateDeviceRecovery()

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

Menunggu 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 pemroses yang lebih aktif.

TODO: ini sedikit trik - 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' dapat berkomunikasi dengan perangkat.

Parameter
serial String: nomor seri perangkat.

fastboot_serial String: nomor seri mode fastboot (Fastboot mode) perangkat.

alokasikanPerangkat

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.

Hasil
ITestDevice ITestDevice untuk pengujian, atau null jika tidak tersedia

alokasikanPerangkat

public abstract ITestDevice allocateDevice (IDeviceSelection options)

Minta perangkat untuk pengujian yang memenuhi kriteria tertentu.

Parameter
options IDeviceSelection: IDeviceSelection yang harus dipenuhi perangkat.

Hasil
ITestDevice ITestDevice untuk pengujian, atau null jika ada tidak tersedia

alokasikanPerangkat

public abstract ITestDevice allocateDevice ()

Meminta perangkat fisik untuk pengujian

Hasil
ITestDevice ITestDevice untuk pengujian, atau null jika tidak tersedia

{i>connectToTcpDevice<i}

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

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

Perhatikan bahwa melakukan tindakan seperti menyalakan ulang pada perangkat yang terhubung 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

putuskanFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Putuskan hubungan 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, yang sebelumnya dialokasikan melalui connectToTcpDevice(String)

Hasil
boolean true jika beralih ke mode usb berhasil

InfoPerangkatDisplay

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Menghasilkan deskripsi yang mudah digunakan yang berisi daftar perangkat yang diketahui, status, dan nilainya untuk opsi IDeviceSelection yang umum digunakan.

Parameter
printWriter PrintWriter: ERROR(/PrintWriter) untuk menghasilkan deskripsi

includeStub boolean: Apakah akan menampilkan perangkat stub atau tidak juga.

jalankanCmdOnAvailableDevice

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

Metode bantuan untuk menjalankan perintah shell pada perangkat yang tersedia.

Parameter
serial String: Seri perangkat.

command String: Perintah shell.

timeout long: Lamanya waktu untuk menyelesaikan perintah.

timeUnit TimeUnit: Unit untuk waktu tunggu.

Hasil
CommandResult CommandResult.

pasukanAlokasiPerangkat

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: seri 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 kolam

Upaya untuk menampilkan perangkat yang belum dialokasikan sebelumnya akan diabaikan.

Parameter
device ITestDevice: ITestDevice yang akan dikosongkan

state FreeDeviceState: FreeDeviceState. Digunakan untuk mengontrol jika 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 seri yang diberikan.

Parameter
serial String: nomor seri perangkat yang akan didapatkan

Hasil
DeviceDescriptor DeviceDescriptor untuk perangkat yang dipilih, atau null jika seri tidak cocok dengan perangkat yang dikenal.

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 memerintahkan {i>DeviceManager<i} untuk mengabaikan perangkat terhubung tertentu.

Parameter
globalDeviceFilter IDeviceSelection: filter perangkat

deviceMonitors

init

public abstract void init ()

Lakukan inisialisasi pengelola perangkat. Ini hanya boleh dipanggil sekali dan hanya sekali sebelum metode lainnya metode dipanggil.

isEmulator

public abstract boolean isEmulator (String serial)

Menentukan apakah serial tertentu mewakili emulator atau tidak

Parameter
serial String

Hasil
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

Hasil
boolean

Perangkat Null

public abstract boolean isNullDevice (String serial)

Menentukan apakah seri tertentu mewakili perangkat null

Parameter
serial String

Hasil
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

Matikan emulator yang ditentukan.

Memblokir hingga emulator menghilang dari adb. Tidak akan berpengaruh jika emulator belum yang tersedia.

Parameter
device ITestDevice: ITestDevice yang mewakili emulator yang akan dimatikan

Menampilkan
DeviceNotAvailableException jika emulator gagal dimatikan

LaunchEmulator

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

Metode helper 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 selesai melakukan booting

emulatorArgs : argumen command line untuk meluncurkan emulator

Menampilkan
DeviceNotAvailableException jika emulator gagal melakukan booting atau terhubung ke internet

daftarSemuaPerangkat

public abstract  listAllDevices (boolean shortDescriptor)

Menampilkan daftar DeviceDescriptors untuk semua perangkat yang diketahui

Parameter
shortDescriptor boolean: apakah akan membatasi deskriptor hingga info minimum

Hasil
daftar DeviceDescriptor untuk semua perangkat yang dikenal

daftarSemuaPerangkat

public abstract  listAllDevices ()

Menampilkan daftar DeviceDescriptors untuk semua perangkat yang diketahui

Hasil
daftar DeviceDescriptor untuk semua perangkat yang dikenal

Hubungkan ulangPerangkatToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Metode bantuan yang mengalihkan perangkat usb tertentu ke mode adb-over-tcp, lalu terhubung ke melalui connectToTcpDevice(String).

Parameter
usbDevice ITestDevice: perangkat saat ini dalam mode usb

Hasil
ITestDevice ITestDevice yang baru dialokasikan dalam mode tcp atau null jika tcp koneksi tidak bisa dibuat

Menampilkan
DeviceNotAvailableException jika koneksi dengan usbDevice terputus dan tidak dapat dipulihkan

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

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

Parameter
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

mulai ulangAdbridge

public abstract void restartAdbBridge ()

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

stopAdbridge

public abstract void stopAdbBridge ()

Menghentikan jembatan dan layanan adb bergantung pada koneksi adb.

hentikan

public abstract void terminate ()

Menghentikan layanan pemantauan perangkat, dan menghentikan library ddm.

Pernyataan ini harus dipanggil setelah penghentian permohonan.

penghentianDeviceMonitor

public abstract void terminateDeviceMonitor ()

Hentikan Device Monitor.

penghentianDeviceRecovery

public abstract void terminateDeviceRecovery ()

Menghentikan thread pemulihan perangkat.

penghentianHard

public void terminateHard (String reason)

Seperti terminateHard().

Parameter
reason String: alasan opsional yang diberikan untuk penghentian.

penghentianHard

public abstract void terminateHard ()

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

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Menunggu hingga perangkat fisik pertama terhubung. Jika sebelumnya perangkat terhubung, maka akan langsung menampilkan Benar. Jika tidak ada perangkat yang ditambahkan, nilai akan dikembalikan setelah waktu tunggu.

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

Hasil
boolean