IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Subclass tidak langsung yang umum DeviceManager DeviceManager

---

Antarmuka untuk mengelola rangkaian 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) 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() 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 koneksi dari perangkat yang terhubung melalui adb-over-tcp.
abstract void	displayDevicesInfo(PrintWriter printWriter, boolean includeStub) Menampilkan deskripsi yang mudah digunakan 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 helper untuk menjalankan perintah shell di perangkat yang tersedia.
abstract ITestDevice	forceAllocateDevice(String serial) Mengalokasikan perangkat dengan tidak sopan, meskipun saat ini tidak tersedia.
abstract void	freeDevice(ITestDevice device, FreeDeviceState state) Mengembalikan perangkat ke kumpulan Upaya untuk mengembalikan perangkat yang belum dialokasikan sebelumnya akan diabaikan.
abstract String	getAdbPath() Menampilkan jalur ke biner adb yang akan digunakan.
abstract String	getAdbVersion() Mendapatkan 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() Menginisialisasi pengelola perangkat.
abstract boolean	isEmulator(String serial) Menentukan apakah serial tertentu merepresentasikan emulator
default boolean	isFileSystemMountCheckEnabled() Menampilkan apakah kita harus memeriksa apakah sistem file NativeDeviceStateMonitor dipasang dengan benar atau tidak.
abstract boolean	isNullDevice(String serial) Menentukan apakah serial tertentu merepresentasikan perangkat null
abstract void	killEmulator(ITestDevice device) Menonaktifkan emulator yang diberikan.
abstract void	launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) Metode helper untuk meluncurkan emulator.
abstract	listAllDevices(boolean shortDescriptor) Menampilkan daftar DeviceDescriptor untuk semua perangkat yang dikenal
abstract	listAllDevices() Menampilkan daftar DeviceDescriptor untuk semua perangkat yang dikenal
abstract ITestDevice	reconnectDeviceToTcp(ITestDevice usbDevice) Metode helper yang mengalihkan perangkat USB tertentu ke mode adb-over-tcp, lalu menghubungkannya 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.
default void	removeMonitoringTcpFastbootDevice(String serial)
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 Pemantau Perangkat.
abstract void	terminateDeviceRecovery() Menghentikan thread pemulihan perangkat.
default void	terminateHard(String reason) Seperti terminateHard().
abstract void	terminateHard() Seperti terminate(), tetapi juga mencoba menutup 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 di fastboot jika ada satu atau beberapa pemroses aktif.

TODO: ini agak rumit - 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.

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

Putuskan koneksi dari perangkat yang terhubung melalui adb-over-tcp.

Mengalihkan perangkat kembali ke mode USB, dan membebaskannya.

Parameter
tcpDevice	ITestDevice: perangkat saat ini dalam mode tcp, yang sebelumnya dialokasikan melalui connectToTcpDevice(String)

Hasil
boolean	true jika peralihan ke mode USB berhasil

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Menampilkan deskripsi yang mudah digunakan 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.

executeCmdOnAvailableDevice

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

Metode helper 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 dengan tidak sopan, 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 mengembalikan perangkat yang belum dialokasikan sebelumnya akan diabaikan.

Parameter
device	ITestDevice: ITestDevice yang akan dibebaskan
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 ()

Mendapatkan 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 perangkat yang akan didapatkan

Hasil
DeviceDescriptor	DeviceDescriptor untuk perangkat yang dipilih, atau null jika serial 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 menginstruksikan DeviceManager agar mengabaikan perangkat terhubung tertentu.

Parameter
globalDeviceFilter	IDeviceSelection: filter perangkat
deviceMonitors

init

public abstract void init ()

Menginisialisasi pengelola perangkat. Tindakan ini harus dipanggil sekali dan hanya sekali sebelum metode lainnya dipanggil.

isEmulator

public abstract boolean isEmulator (String serial)

Menentukan apakah serial tertentu merepresentasikan emulator

Parameter
serial	String

Hasil
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

Hasil
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Menentukan apakah serial tertentu merepresentasikan perangkat null

Parameter
serial	String

Hasil
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

Menonaktifkan emulator yang diberikan.

Memblokir hingga emulator hilang dari adb. Tidak akan berpengaruh jika emulator sudah tidak tersedia.

Parameter
device	ITestDevice: ITestDevice yang mewakili emulator yang akan dimatikan

Menampilkan
DeviceNotAvailableException	jika emulator gagal dinonaktifkan

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 merepresentasikan perangkat emulator yang dialokasikan
bootTimeout	long: waktu dalam ms untuk menunggu emulator melakukan booting
emulatorArgs	: argumen command line untuk meluncurkan emulator

Menampilkan
DeviceNotAvailableException	jika emulator gagal melakukan booting atau terhubung ke internet

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

Menampilkan daftar DeviceDescriptor untuk semua perangkat yang dikenal

Parameter
shortDescriptor	boolean: apakah akan membatasi deskriptor ke info minimum

Hasil
	daftar DeviceDescriptor untuk semua perangkat yang diketahui

listAllDevices

public abstract  listAllDevices ()

Menampilkan daftar DeviceDescriptor untuk semua perangkat yang dikenal

Hasil
	daftar DeviceDescriptor untuk semua perangkat yang diketahui

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Metode helper yang mengalihkan perangkat USB tertentu ke mode adb-over-tcp, lalu menghubungkannya 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.

removeMonitoringTcpFastbootDevice

public void removeMonitoringTcpFastbootDevice (String serial)

Parameter
serial	String

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.

Fungsi ini harus dipanggil saat penghentian aplikasi.

Lihat juga:

• ERROR(/AndroidDebugBridge#terminate())

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

Hentikan Pemantau 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 menutup adb secara paksa.

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Tunggu hingga perangkat fisik pertama terhubung. Jika perangkat pernah terhubung sebelumnya, perangkat akan langsung menampilkan nilai Benar (True). Jika tidak ada perangkat yang ditambahkan, fungsi ini akan menampilkan nilai salah (false) setelah waktu tunggu habis.

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

Hasil
boolean