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