デバイスマネージャ
public class DeviceManager
extends Object
implements IDeviceManager
java.lang.Object | |
↳ | com.android.tradefed.device.DeviceManager |
まとめ
ネストされたクラス | |
---|---|
class | DeviceManager.FastbootDevice Fastboot モードのデバイスの表現。 |
田畑 | |
---|---|
public static final String | UNKNOWN_DISPLAY_STRING 不明なプロパティの表示文字列 |
protected DeviceMonitorMultiplexer | mDvcMon |
protected boolean | mFastbootEnabled
|
パブリック コンストラクター | |
---|---|
DeviceManager () DeviceManager は |
公開メソッド | |
---|---|
void | addAvailableDevice (IDevice stubDevice) |
void | addDeviceMonitor ( IDeviceMonitor mon) |
void | addFastbootDevice ( DeviceManager.FastbootDevice fastbootDevice) |
void | addFastbootListener ( IDeviceManager.IFastbootListener listener) リスナーが fastboot 状態の変化に関心があることをマネージャーに通知します。 |
void | addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) fastboot モニターにデバイスを追加します。 |
ITestDevice | allocateDevice ( IDeviceSelection options, boolean isTemporary) 特定の基準を満たすテスト用のデバイスをリクエストします。 |
ITestDevice | allocateDevice ( IDeviceSelection options) 特定の基準を満たすテスト用のデバイスをリクエストします。 |
ITestDevice | allocateDevice () テスト用の物理デバイスをリクエストする |
ITestDevice | connectToTcpDevice (String ipAndPort) adb-over-tcp でデバイスに接続する このメソッドは新しいデバイスを割り当てます。最終的にはdisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) を介して解放する必要があります。返されたITestDevice オンラインになりますが、応答しない場合があります。 |
boolean | disconnectFromTcpDevice ( ITestDevice tcpDevice) adb-over-tcp 接続デバイスから切断します。 |
void | displayDevicesInfo (PrintWriter stream, boolean includeStub) 既知のデバイス、その状態、および一般的に使用される |
CommandResult | executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit) 利用可能なデバイスでシェル コマンドを実行するためのヘルパー メソッド。 |
String | executeGlobalAdbCommand (String... cmdArgs) 特定のデバイスを対象としていない adb コマンドを実行します。 |
ITestDevice | forceAllocateDevice (String serial) 現在利用できない場合でも、デバイスを無作法に割り当てます。 |
void | freeDevice ( ITestDevice device, FreeDeviceState deviceState) デバイスをプールに戻す 以前に割り当てられていないデバイスを返そうとしても無視されます。 |
String | getAdbPath () 使用する adb バイナリへのパスを返します。 |
String | getAdbVersion () デバイス マネージャーが現在使用している adb のバージョンを取得します。 |
DeviceDescriptor | getDeviceDescriptor (String serial) 指定されたシリアルで DeviceDescriptor を返します。 |
String | getFastbootPath () 使用する fastboot バイナリへのパスを返します。 |
void | init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) デバイスマネージャーを初期化します。 |
void | init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) デバイスマネージャーを初期化します。 |
void | init () デバイスマネージャーを初期化します。 |
boolean | isEmulator (String serial) 指定されたシリアルがエミュレータを表しているかどうかを判別 |
boolean | isFileSystemMountCheckEnabled () ファイルシステムが正しくマウントされていることを |
boolean | isNullDevice (String serial) 指定されたシリアルがヌル デバイスを表しているかどうかを判断する |
void | killEmulator ( ITestDevice device) 指定されたエミュレーターをシャットダウンします。 |
void | launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) エミュレーターを起動するヘルパー メソッド。 |
listAllDevices (boolean shortDescriptor) すべての既知のデバイスの DeviceDescriptor のリストを返します | |
listAllDevices () すべての既知のデバイスの DeviceDescriptor のリストを返します | |
ITestDevice | reconnectDeviceToTcp ( ITestDevice usbDevice) 指定された USB デバイスを adb-over-tcp モードに切り替え、 |
void | removeDeviceMonitor ( IDeviceMonitor mon) 以前に追加された |
void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) リスナーが fastboot 状態の変更に関心がなくなったことをマネージャーに通知します。 |
void | restartAdbBridge () 再起動 ( |
void | stopAdbBridge () adb ブリッジを停止し、サービスは adb 接続に依存します。 |
void | terminate () デバイス監視サービスを停止し、ddm ライブラリを終了します。 |
void | terminateDeviceMonitor () デバイス モニターを停止します。 |
void | terminateDeviceRecovery () デバイス回復スレッドを停止します。 |
void | terminateHard (String reason) |
void | terminateHard () |
boolean | waitForFirstDeviceAdded (long timeout) 最初の物理デバイスが接続されるまで待ちます。 |
田畑
UNKNOWN_DISPLAY_STRING
public static final String UNKNOWN_DISPLAY_STRING
不明なプロパティの表示文字列
mDvcMon
protected DeviceMonitorMultiplexer mDvcMon
mFastbootEnabled
protected boolean mFastbootEnabled
パブリック コンストラクター
公開メソッド
addAvailableDevice
public void addAvailableDevice (IDevice stubDevice)
パラメーター | |
---|---|
stubDevice | IDevice |
addDeviceMonitor
public void addDeviceMonitor (IDeviceMonitor mon)
IDeviceMonitor
を追加します
パラメーター | |
---|---|
mon | IDeviceMonitor |
addFastbootDevice
public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)
パラメーター | |
---|---|
fastbootDevice | DeviceManager.FastbootDevice |
addFastbootListener
public void addFastbootListener (IDeviceManager.IFastbootListener listener)
リスナーが fastboot 状態の変化に関心があることをマネージャーに通知します。
現在、IDeviceManager
アクティブなリスナーが 1 つ以上ある場合にのみ、fastboot でデバイスを監視します。 TODO: これはちょっとしたハックです - より良い解決策を見つけてくださいaddMonitoringTcpFastbootDevice
public void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)
fastboot モニターにデバイスを追加します。 fastboot モニターは、「fastboot_serial」を使用してデバイスと通信します。
パラメーター | |
---|---|
serial | String : デバイスのシリアル番号。 |
fastboot_serial | String : デバイスの fastboot モードのシリアル番号。 |
割り当てデバイス
public ITestDevice allocateDevice (IDeviceSelection options, boolean isTemporary)
特定の基準を満たすテスト用のデバイスをリクエストします。
パラメーター | |
---|---|
options | IDeviceSelection : デバイスが満たすべきIDeviceSelection 。 |
isTemporary | boolean : 一時的な NullDevice を作成するかどうか。 |
戻り値 | |
---|---|
ITestDevice | テスト用のITestDevice 、または利用できない場合はnull |
割り当てデバイス
public ITestDevice allocateDevice (IDeviceSelection options)
特定の基準を満たすテスト用のデバイスをリクエストします。
パラメーター | |
---|---|
options | IDeviceSelection : デバイスが満たすべきIDeviceSelection 。 |
戻り値 | |
---|---|
ITestDevice | テスト用のITestDevice 、または利用できない場合はnull |
割り当てデバイス
public ITestDevice allocateDevice ()
テスト用の物理デバイスをリクエストする
戻り値 | |
---|---|
ITestDevice | テスト用のITestDevice 、または利用できない場合はnull |
connectToTcpDevice
public ITestDevice connectToTcpDevice (String ipAndPort)
adb-over-tcp でデバイスに接続する
このメソッドは新しいデバイスを割り当てます。最終的にはdisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)
を介して解放する必要があります。返されたITestDevice
オンラインになりますが、応答しない場合があります。 TCP 接続されたデバイスで再起動などのアクションを実行すると、デバイスへの TCP 接続が切断され、 DeviceNotAvailableException
が発生することに注意してください。パラメーター | |
---|---|
ipAndPort | String : 接続するデバイスの元の IP アドレスとポート |
戻り値 | |
---|---|
ITestDevice | tcp 接続を形成できなかった場合はITestDevice またはnull |
disconnectFromTcpDevice
public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)
adb-over-tcp 接続デバイスから切断します。
デバイスを USB モードに戻し、解放します。パラメーター | |
---|---|
tcpDevice | ITestDevice : 以前にconnectToTcpDevice(String) 経由で割り当てられた、現在 tcp モードのデバイス |
戻り値 | |
---|---|
boolean | USB モードへの切り替えが成功した場合はtrue |
表示デバイス情報
public void displayDevicesInfo (PrintWriter stream, boolean includeStub)
既知のデバイス、その状態、および一般的に使用されるIDeviceSelection
オプションの値のリストを含むユーザー フレンドリな説明を出力します。
パラメーター | |
---|---|
stream | PrintWriter : 説明を出力するERROR(/PrintWriter) |
includeStub | boolean : スタブ デバイスも表示するかどうか。 |
executeCmdOnAvailableDevice
public CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)
利用可能なデバイスでシェル コマンドを実行するためのヘルパー メソッド。
パラメーター | |
---|---|
serial | String : デバイスのシリアル。 |
command | String : シェル コマンド。 |
timeout | long : コマンドが完了するまでの時間。 |
timeUnit | TimeUnit : タイムアウトの単位。 |
戻り値 | |
---|---|
CommandResult | CommandResult 。 |
executeGlobalAdbCommand
public String executeGlobalAdbCommand (String... cmdArgs)
特定のデバイスを対象としていない adb コマンドを実行します。 「adb接続」
戻り値 | |
---|---|
String | コマンドが成功した場合は std 出力、それ以外の場合は null。 |
forceAllocateDevice
public ITestDevice forceAllocateDevice (String serial)
現在利用できない場合でも、デバイスを無作法に割り当てます。
デバイスが既に割り当てられている場合は効果がありません。パラメーター | |
---|---|
serial | String : 割り当てるデバイスのシリアル |
戻り値 | |
---|---|
ITestDevice | ITestDevice 、または割り当てられなかった場合はnull |
フリーデバイス
public void freeDevice (ITestDevice device, FreeDeviceState deviceState)
デバイスをプールに戻す
以前に割り当てられていないデバイスを返そうとしても無視されます。パラメーター | |
---|---|
device | ITestDevice : 解放するITestDevice |
deviceState | FreeDeviceState : FreeDeviceState 。デバイスが使用可能なデバイス プールに戻されるかどうかを制御するために使用されます。 |
getAdbPath
public String getAdbPath ()
使用する adb バイナリへのパスを返します。
戻り値 | |
---|---|
String |
getAdbVersion
public String getAdbVersion ()
デバイス マネージャーが現在使用している adb のバージョンを取得します。
戻り値 | |
---|---|
String |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (String serial)
指定されたシリアルで DeviceDescriptor を返します。
パラメーター | |
---|---|
serial | String : 取得するデバイスのシリアル番号 |
戻り値 | |
---|---|
DeviceDescriptor | 選択したデバイスのDeviceDescriptor 、またはシリアルが既知のデバイスと一致しない場合は null。 |
getFastbootPath
public String getFastbootPath ()
使用する fastboot バイナリへのパスを返します。
戻り値 | |
---|---|
String |
初期化
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)
デバイスマネージャーを初期化します。これは、他のメソッドが呼び出される前に 1 回だけ呼び出す必要があります。
パラメーター | |
---|---|
globalDeviceFilter | IDeviceSelection |
globalDeviceMonitors | |
deviceFactory | IManagedTestDeviceFactory |
初期化
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors)
デバイスマネージャーを初期化します。これは、他のメソッドが呼び出される前に 1 回だけ呼び出す必要があります。
パラメーター | |
---|---|
globalDeviceFilter | IDeviceSelection : デバイス フィルター |
globalDeviceMonitors |
初期化
public void init ()
デバイスマネージャーを初期化します。これは、他のメソッドが呼び出される前に 1 回だけ呼び出す必要があります。
isEmulator
public boolean isEmulator (String serial)
指定されたシリアルがエミュレータを表しているかどうかを判別
パラメーター | |
---|---|
serial | String |
戻り値 | |
---|---|
boolean |
isFileSystemMountCheckEnabled
public boolean isFileSystemMountCheckEnabled ()
ファイルシステムが正しくマウントされていることをNativeDeviceStateMonitor
で確認する必要があるかどうかを返します。
戻り値 | |
---|---|
boolean |
isNullDevice
public boolean isNullDevice (String serial)
指定されたシリアルがヌル デバイスを表しているかどうかを判断する
パラメーター | |
---|---|
serial | String |
戻り値 | |
---|---|
boolean |
killEmulator
public void killEmulator (ITestDevice device)
指定されたエミュレーターをシャットダウンします。
エミュレーターが adb から消えるまでブロックします。エミュレータがまだ利用できない場合は効果がありません。パラメーター | |
---|---|
device | ITestDevice : シャットダウンするエミュレータを表すITestDevice |
スロー | |
---|---|
DeviceNotAvailableException |
launchEmulator
public void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
エミュレーターを起動するヘルパー メソッド。
呼び出し元の指定に従ってエミュレーターを起動しますパラメーター | |
---|---|
device | ITestDevice : 割り当てられたエミュレーター デバイスを表すプレースホルダーITestDevice |
bootTimeout | long : エミュレーターの起動を待機する時間 (ミリ秒) |
emulatorArgs |
スロー | |
---|---|
DeviceNotAvailableException |
listAllDevices
publiclistAllDevices (boolean shortDescriptor)
すべての既知のデバイスの DeviceDescriptor のリストを返します
パラメーター | |
---|---|
shortDescriptor | boolean : 記述子を最小限の情報に制限するかどうか |
戻り値 | |
---|---|
すべての既知のデバイスのDeviceDescriptor のリスト |
listAllDevices
publiclistAllDevices ()
すべての既知のデバイスの DeviceDescriptor のリストを返します
戻り値 | |
---|---|
すべての既知のデバイスのDeviceDescriptor のリスト |
reconnectDeviceToTcp
public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)
指定された USB デバイスを adb-over-tcp モードに切り替え、 connectToTcpDevice(String)
経由で接続するヘルパー メソッド。
パラメーター | |
---|---|
usbDevice | ITestDevice : 現在 USB モードになっているデバイス |
戻り値 | |
---|---|
ITestDevice | tcp モードで新しく割り当てられたITestDevice 、または tcp 接続を形成できなかった場合はnull |
スロー | |
---|---|
DeviceNotAvailableException |
removeDeviceMonitor
public void removeDeviceMonitor (IDeviceMonitor mon)
以前に追加されたIDeviceMonitor
を削除します。 mon が追加されていない場合は効果がありません。
パラメーター | |
---|---|
mon | IDeviceMonitor |
removeFastbootListener
public void removeFastbootListener (IDeviceManager.IFastbootListener listener)
リスナーが fastboot 状態の変更に関心がなくなったことをマネージャーに通知します。
再起動AdbBridge
public void restartAdbBridge ()
再起動 ( stopAdbBridge()
が呼び出された場合) adb ブリッジとサービスは adb 接続に依存します。
stopAdbBridge
public void stopAdbBridge ()
adb ブリッジを停止し、サービスは adb 接続に依存します。
終了する
public void terminate ()
デバイス監視サービスを停止し、ddm ライブラリを終了します。
これは、アプリケーションの終了時に呼び出す必要があります。終了DeviceMonitor
public void terminateDeviceMonitor ()
デバイス モニターを停止します。
デバイスの回復を終了します
public void terminateDeviceRecovery ()
デバイス回復スレッドを停止します。
終了ハード
public void terminateHard (String reason)
terminateHard()
のように。
パラメーター | |
---|---|
reason | String : 終了のオプションの理由。 |
waitForFirstDeviceAdded
public boolean waitForFirstDeviceAdded (long timeout)
最初の物理デバイスが接続されるまで待ちます。デバイスが以前に接続されていた場合は、直接 True を返します。デバイスが追加されていない場合は、タイムアウト後に false を返します。
パラメーター | |
---|---|
timeout | long : false を返すまでのミリ秒単位の待機時間。 |
戻り値 | |
---|---|
boolean |
このページのコンテンツやコードサンプルは、コンテンツ ライセンスに記載のライセンスに従います。Java および OpenJDK は Oracle および関連会社の商標または登録商標です。
最終更新日 2023-03-30 UTC。