IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Subclass tidak langsung yang umum DeviceManager DeviceManager

---

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.

Lihat juga:

• AndroidDebugBridge.terminate()

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