Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Pengaturan perangkat

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Objek
com.android.tradefed.device.DeviceManager


Ringkasan

Kelas bersarang

class DeviceManager.FastbootDevice

Representasi perangkat dalam mode Fastboot.

Bidang

public static final String UNKNOWN_DISPLAY_STRING

Tampilkan string untuk properti yang tidak diketahui

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

Konstruktor publik

DeviceManager ()

DeviceManager harus diambil dari GlobalConfiguration

Metode publik

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

Menambahkan IDeviceMonitor

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

Memberi tahu manajer bahwa pendengar tertarik dengan perubahan status fastboot.

void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

Tambahkan perangkat ke monitor fastboot.

ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

Minta perangkat untuk pengujian yang memenuhi kriteria tertentu.

ITestDevice allocateDevice ( IDeviceSelection options)

Minta perangkat untuk pengujian yang memenuhi kriteria tertentu.

ITestDevice allocateDevice ()

Minta perangkat fisik untuk pengujian

ITestDevice connectToTcpDevice (String ipAndPort)

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

boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

Putuskan sambungan dari perangkat yang terhubung dengan adb-over-tcp.

void displayDevicesInfo (PrintWriter stream, boolean includeStub)

Keluarkan deskripsi ramah pengguna yang berisi daftar perangkat yang dikenal, statusnya, dan nilainya untuk opsi IDeviceSelection yang umum digunakan.

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

Metode pembantu untuk menjalankan perintah shell pada perangkat yang tersedia.

String executeGlobalAdbCommand (String... cmdArgs)

Jalankan perintah adb yang tidak ditargetkan ke perangkat tertentu misalnya.

ITestDevice forceAllocateDevice (String serial)

Alokasikan perangkat dengan kasar, meskipun saat ini tidak tersedia.

void freeDevice ( ITestDevice device, FreeDeviceState deviceState)

Kembalikan perangkat ke kolam

Upaya mengembalikan perangkat yang belum dialokasikan sebelumnya akan diabaikan.

String getAdbPath ()

Mengembalikan jalur ke biner adb untuk digunakan.

String getAdbVersion ()

Dapatkan versi adb yang saat ini digunakan oleh pengelola perangkat.

DeviceDescriptor getDeviceDescriptor (String serial)

Mengembalikan DeviceDescriptor dengan serial yang diberikan.

String getFastbootPath ()

Mengembalikan jalur ke biner fastboot untuk digunakan.

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

Inisialisasi pengelola perangkat.

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

Inisialisasi pengelola perangkat.

void init ()

Inisialisasi pengelola perangkat.

boolean isEmulator (String serial)

Tentukan apakah serial yang diberikan mewakili emulator

boolean isFileSystemMountCheckEnabled ()

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

boolean isNullDevice (String serial)

Tentukan apakah serial yang diberikan mewakili perangkat nol

void killEmulator ( ITestDevice device)

Matikan emulator yang diberikan.

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

Metode pembantu untuk meluncurkan emulator.

listAllDevices (boolean shortDescriptor)

Mengembalikan daftar DeviceDescriptors untuk semua perangkat yang dikenal

listAllDevices ()

Mengembalikan daftar DeviceDescriptors untuk semua perangkat yang dikenal

ITestDevice reconnectDeviceToTcp ( ITestDevice usbDevice)

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

void removeDeviceMonitor ( IDeviceMonitor mon)

Menghapus IDeviceMonitor yang ditambahkan sebelumnya.

void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

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

void restartAdbBridge ()

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

void stopAdbBridge ()

Hentikan jembatan adb dan layanan bergantung pada koneksi adb.

void terminate ()

Menghentikan layanan pemantauan perangkat, dan menghentikan pustaka ddm.

void terminateDeviceMonitor ()

Hentikan Monitor Perangkat.

void terminateDeviceRecovery ()

Menghentikan utas pemulihan perangkat.

void terminateHard (String reason)

Seperti terminateHard() .

void terminateHard ()

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

boolean waitForFirstDeviceAdded (long timeout)

Tunggu hingga perangkat fisik pertama terhubung.

Bidang

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Tampilkan string untuk properti yang tidak diketahui

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

Konstruktor publik

Pengaturan perangkat

public DeviceManager ()

DeviceManager harus diambil dari GlobalConfiguration

Metode publik

addAvailableDevice

public void addAvailableDevice (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 manajer bahwa pendengar tertarik dengan perubahan status fastboot.

Saat ini IDeviceManager hanya akan memantau perangkat di fastboot jika ada satu atau lebih pendengar yang aktif.

TODO: ini sedikit peretasan - temukan solusi yang lebih baik

addMonitoringTcpFastbootDevice

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

alokasikan Perangkat

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

Pengembalian
ITestDevice a ITestDevice untuk pengujian, atau null jika tidak tersedia

alokasikan Perangkat

public ITestDevice allocateDevice (IDeviceSelection options)

Minta perangkat untuk pengujian yang memenuhi kriteria tertentu.

Parameter
options IDeviceSelection : IDeviceSelection yang harus dipenuhi perangkat.

Pengembalian
ITestDevice a ITestDevice untuk pengujian, atau null jika tidak tersedia

alokasikan Perangkat

public ITestDevice allocateDevice ()

Minta perangkat fisik untuk pengujian

Pengembalian
ITestDevice a ITestDevice untuk pengujian, atau null jika tidak tersedia

connectToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

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

Perhatikan bahwa melakukan tindakan seperti me-reboot perangkat yang terhubung dengan tcp, akan memutuskan koneksi tcp ke perangkat, dan menghasilkan DeviceNotAvailableException

Parameter
ipAndPort String : alamat ip asli dan port perangkat yang akan dihubungkan

Pengembalian
ITestDevice ITestDevice atau null jika koneksi tcp tidak dapat dibuat

disconnectFromTcpDevice

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Putuskan sambungan dari perangkat yang terhubung dengan adb-over-tcp.

Mengalihkan perangkat kembali ke mode usb, dan membebaskannya.

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

Pengembalian
boolean true jika beralih ke mode usb berhasil

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

Keluarkan deskripsi ramah pengguna yang berisi daftar perangkat yang dikenal, statusnya, dan nilainya untuk opsi IDeviceSelection yang umum digunakan.

Parameter
stream PrintWriter : ERROR(/PrintWriter) untuk menampilkan deskripsi

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

jalankanCmdOnAvailableDevice

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

Metode pembantu untuk menjalankan perintah shell pada perangkat yang tersedia.

Parameter
serial String : Serial perangkat.

command String : Perintah shell.

timeout long : Jumlah waktu untuk menyelesaikan perintah.

timeUnit TimeUnit : Unit untuk batas waktu.

Pengembalian
CommandResult Sebuah CommandResult .

jalankan Perintah GlobalAdb

public String executeGlobalAdbCommand (String... cmdArgs)

Jalankan perintah adb yang tidak ditargetkan ke perangkat tertentu misalnya. 'sambungan adb'

Pengembalian
String std output jika perintah berhasil null sebaliknya.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

Alokasikan perangkat dengan kasar, meskipun saat ini tidak tersedia.

Tidak akan berpengaruh jika perangkat sudah dialokasikan.

Parameter
serial String : serial perangkat yang akan dialokasikan

Pengembalian
ITestDevice ITestDevice , atau null jika tidak dapat dialokasikan

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

Kembalikan perangkat ke kolam

Upaya mengembalikan perangkat yang belum dialokasikan sebelumnya akan diabaikan.

Parameter
device ITestDevice : ITestDevice gratis

deviceState FreeDeviceState : FreeDeviceState . Digunakan untuk mengontrol apakah perangkat dikembalikan ke kumpulan perangkat yang tersedia.

getAdbPath

public String getAdbPath ()

Mengembalikan jalur ke biner adb untuk digunakan.

Pengembalian
String

getAdbVersion

public String getAdbVersion ()

Dapatkan versi adb yang saat ini digunakan oleh pengelola perangkat.

Pengembalian
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

Mengembalikan DeviceDescriptor dengan serial yang diberikan.

Parameter
serial String : nomor seri untuk mendapatkan perangkat

Pengembalian
DeviceDescriptor DeviceDescriptor untuk perangkat yang dipilih, atau null jika serial tidak cocok dengan perangkat yang dikenal.

getFastbootPath

public String getFastbootPath ()

Mengembalikan jalur ke biner fastboot untuk digunakan.

Pengembalian
String

init

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

Inisialisasi pengelola perangkat. Ini harus dipanggil sekali dan hanya sekali sebelum metode lain dipanggil.

Parameter
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

Inisialisasi pengelola perangkat. Ini harus dipanggil sekali dan hanya sekali sebelum metode lain dipanggil.

Parameter
globalDeviceFilter IDeviceSelection : filter perangkat

globalDeviceMonitors

init

public void init ()

Inisialisasi pengelola perangkat. Ini harus dipanggil sekali dan hanya sekali sebelum metode lain dipanggil.

isEmulator

public boolean isEmulator (String serial)

Tentukan apakah serial yang diberikan mewakili emulator

Parameter
serial String

Pengembalian
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

Pengembalian
boolean

isNullDevice

public boolean isNullDevice (String serial)

Tentukan apakah serial yang diberikan mewakili perangkat nol

Parameter
serial String

Pengembalian
boolean

killEmulator

public 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

Melempar
DeviceNotAvailableException

launchEmulator

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

Metode pembantu 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 ms untuk menunggu emulator melakukan booting

emulatorArgs : argumen baris perintah untuk meluncurkan emulator

Melempar
DeviceNotAvailableException

listAllDevices

public  listAllDevices (boolean shortDescriptor)

Mengembalikan daftar DeviceDescriptors untuk semua perangkat yang dikenal

Parameter
shortDescriptor boolean : apakah akan membatasi deskriptor ke info minimum

Pengembalian
daftar DeviceDescriptor untuk semua perangkat yang dikenal

listAllDevices

public  listAllDevices ()

Mengembalikan daftar DeviceDescriptors untuk semua perangkat yang dikenal

Pengembalian
daftar DeviceDescriptor untuk semua perangkat yang dikenal

sambungkan kembaliDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

Parameter
usbDevice ITestDevice : perangkat saat ini dalam mode usb

Pengembalian
ITestDevice ITestDevice yang baru dialokasikan dalam mode tcp atau null jika koneksi tcp tidak dapat dibentuk

Melempar
DeviceNotAvailableException

hapus DeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

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

Parameter
mon IDeviceMonitor

hapus FastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

restartAdbBridge

public void restartAdbBridge ()

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

stopAdbBridge

public void stopAdbBridge ()

Hentikan jembatan adb dan layanan bergantung pada koneksi adb.

mengakhiri

public void terminate ()

Menghentikan layanan pemantauan perangkat, dan menghentikan pustaka ddm.

Ini harus dipanggil setelah penghentian aplikasi.

terminasiDeviceMonitor

public void terminateDeviceMonitor ()

Hentikan Monitor Perangkat.

terminasiDeviceRecovery

public void terminateDeviceRecovery ()

Menghentikan utas pemulihan perangkat.

menghentikanHard

public void terminateHard (String reason)

Seperti terminateHard() .

Parameter
reason String : alasan opsional yang diberikan untuk penghentian.

menghentikanHard

public void terminateHard ()

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

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

Tunggu hingga perangkat fisik pertama terhubung. Jika perangkat terhubung sebelumnya, itu langsung mengembalikan True. Jika tidak ada perangkat yang ditambahkan, itu mengembalikan salah setelah waktu habis.

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

Pengembalian
boolean