PengelolaPerangkat

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Object
   ↳ com.android.tradefed.device.DeviceManager

Ringkasan

Class bertingkat

class DeviceManager.FastbootDevice

Representasi perangkat dalam mode Fastboot. 

Konstanta

String UNKNOWN_DISPLAY_STRING

Menampilkan string untuk properti yang tidak diketahui

Kolom

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

Konstruktor publik

DeviceManager()

DeviceManager harus diambil dari GlobalConfiguration

Metode publik

void addAvailableDevice(IDevice stubDevice)
void addAvailableNativeDevice(IDevice stubDevice)
void addDeviceMonitor(IDeviceMonitor mon)

Menambahkan IDeviceMonitor

void addFastbootDevice(DeviceManager.FastbootDevice fastbootDevice)
void addFastbootListener(IDeviceManager.IFastbootListener listener)

Memberi tahu pengelola bahwa pemroses tertarik dengan perubahan status fastboot.

void addMonitoringTcpFastbootDevice(String serial, String fastbootSerial)

Tambahkan perangkat ke monitor fastboot.

ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

Meminta perangkat untuk pengujian yang memenuhi kriteria tertentu.

ITestDevice allocateDevice(IDeviceSelection options)

Meminta perangkat untuk pengujian yang memenuhi kriteria tertentu.

ITestDevice allocateDevice()

Meminta perangkat fisik untuk pengujian

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.

boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

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

void displayDevicesInfo(PrintWriter stream, boolean includeStub)

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

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

Metode helper untuk menjalankan perintah shell di perangkat yang tersedia.

String executeGlobalAdbCommand(String... cmdArgs)

Menjalankan perintah adb yang tidak ditargetkan ke perangkat tertentu, misalnya.

ITestDevice forceAllocateDevice(String serial)

Mengalokasikan perangkat dengan tidak sopan, meskipun saat ini tidak tersedia.

void freeDevice(ITestDevice device, FreeDeviceState deviceState)

Mengembalikan perangkat ke kumpulan

Upaya untuk mengembalikan perangkat yang belum dialokasikan sebelumnya akan diabaikan.

String getAdbPath()

Menampilkan jalur ke biner adb yang akan digunakan.

String getAdbVersion()

Mendapatkan versi adb yang saat ini digunakan oleh pengelola perangkat.

DeviceDescriptor getDeviceDescriptor(String serial)

Menampilkan DeviceDescriptor dengan serial yang diberikan.

String getFastbootPath()

Menampilkan jalur ke biner fastboot yang akan digunakan.

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

Menginisialisasi pengelola perangkat.

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

Menginisialisasi pengelola perangkat.

void init()

Menginisialisasi pengelola perangkat.

boolean isEmulator(String serial)

Menentukan apakah serial tertentu merepresentasikan emulator

boolean isFileSystemMountCheckEnabled()

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

boolean isNullDevice(String serial)

Menentukan apakah serial tertentu merepresentasikan perangkat null

void killEmulator(ITestDevice device)

Menonaktifkan emulator yang diberikan.

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

Metode helper untuk meluncurkan emulator.

listAllDevices(boolean shortDescriptor)

Menampilkan daftar DeviceDescriptor untuk semua perangkat yang dikenal

listAllDevices()

Menampilkan daftar DeviceDescriptor untuk semua perangkat yang dikenal

ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

Metode helper yang mengalihkan perangkat USB tertentu ke mode adb-over-tcp, lalu menghubungkannya melalui connectToTcpDevice(String).

void removeDeviceMonitor(IDeviceMonitor mon)

Menghapus IDeviceMonitor yang sebelumnya ditambahkan.

void removeFastbootListener(IDeviceManager.IFastbootListener listener)

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

void removeMonitoringTcpFastbootDevice(String serial)

void restartAdbBridge()

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

void stopAdbBridge()

Menghentikan jembatan adb dan layanan bergantung pada koneksi adb.

void terminate()

Menghentikan layanan pemantauan perangkat, dan menghentikan library ddm.

void terminateDeviceMonitor()

Hentikan Pemantau Perangkat.

void terminateDeviceRecovery()

Menghentikan thread pemulihan perangkat.

void terminateHard(String reason)

Seperti terminateHard().

void terminateHard()

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

boolean waitForFirstDeviceAdded(long timeout)

Tunggu hingga perangkat fisik pertama terhubung.

Konstanta

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Menampilkan string untuk properti yang tidak diketahui

Nilai Konstanta: "unknown"

Kolom

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

Konstruktor publik

PengelolaPerangkat

public DeviceManager ()

DeviceManager harus diambil dari GlobalConfiguration

Metode publik

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

Parameter
stubDevice IDevice

addAvailableNativeDevice

public void addAvailableNativeDevice (IDevice stubDevice)

Parameter
stubDevice IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Menambahkan IDeviceMonitor

Parameter
mon IDeviceMonitor

addFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Parameter
fastbootDevice DeviceManager.FastbootDevice

addFastbootListener

public 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 void addMonitoringTcpFastbootDevice (String serial, 
                String fastbootSerial)

Tambahkan perangkat ke monitor fastboot. Monitor fastboot akan menggunakan 'fastboot_serial' untuk berkomunikasi dengan perangkat.

Parameter
serial String: nomor seri perangkat.
fastbootSerial String: nomor seri mode fastboot perangkat.

allocateDevice

public 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 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 ITestDevice allocateDevice ()

Meminta perangkat fisik untuk pengujian

Hasil
ITestDevice ITestDevice untuk pengujian, atau null jika tidak tersedia

connectToTcpDevice

public 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 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 void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

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

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

executeCmdOnAvailableDevice

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

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Menjalankan perintah adb yang tidak ditargetkan ke perangkat tertentu, misalnya. 'adb connect'

Hasil
String output std jika perintah berhasil, null jika tidak.

forceAllocateDevice

public 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 void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Mengembalikan perangkat ke kumpulan

Upaya untuk mengembalikan perangkat yang belum dialokasikan sebelumnya akan diabaikan.

Parameter
device ITestDevice: ITestDevice yang akan dibebaskan
deviceState FreeDeviceState: FreeDeviceState. Digunakan untuk mengontrol apakah perangkat dikembalikan ke kumpulan perangkat yang tersedia.

getAdbPath

public String getAdbPath ()

Menampilkan jalur ke biner adb yang akan digunakan.

Hasil
String

getAdbVersion

public String getAdbVersion ()

Mendapatkan versi adb yang saat ini digunakan oleh pengelola perangkat.

Hasil
String

getDeviceDescriptor

public 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 String getFastbootPath ()

Menampilkan jalur ke biner fastboot yang akan digunakan.

Hasil
String

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

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

Parameter
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

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

Parameter
globalDeviceFilter IDeviceSelection: filter perangkat
globalDeviceMonitors

init

public void init ()

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

isEmulator

public 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 boolean isNullDevice (String serial)

Menentukan apakah serial tertentu merepresentasikan perangkat null

Parameter
serial String

Hasil
boolean

killEmulator

public 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

launchEmulator

public 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

listAllDevices

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

Menampilkan daftar DeviceDescriptor untuk semua perangkat yang dikenal

Hasil
daftar DeviceDescriptor untuk semua perangkat yang diketahui

reconnectDeviceToTcp

public 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

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

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

Parameter
mon IDeviceMonitor

removeFastbootListener

public 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 void restartAdbBridge ()

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

stopAdbBridge

public void stopAdbBridge ()

Menghentikan jembatan adb dan layanan bergantung pada koneksi adb.

terminate

public void terminate ()

Menghentikan layanan pemantauan perangkat, dan menghentikan library ddm.

Fungsi ini harus dipanggil saat penghentian aplikasi.

terminateDeviceMonitor

public void terminateDeviceMonitor ()

Hentikan Pemantau Perangkat.

terminateDeviceRecovery

public 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 void terminateHard ()

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

waitForFirstDeviceAdded

public 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