Google は、黒人コミュニティに対する人種平等の促進に取り組んでいます。取り組みを見る

IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


テストに使用できるデバイスのセットを管理するためのインターフェース。

概要

ネストされたクラス

interface IDeviceManager.IFastbootListener

fastboot状態変更のリスナー。

パブリックメソッド

abstract void addDeviceMonitor ( IDeviceMonitor mon)

IDeviceMonitorを追加します

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)

既知のデバイスのリスト、それらの状態、および一般的に使用されるIDeviceSelectionオプションの値を含むユーザーフレンドリーな説明を出力します。

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

NativeDeviceStateMonitorでファイルシステムが正しくマウントされているかどうかをチェックインする必要があるかどうかを返します。

abstract boolean isNullDevice (String serial)

指定されたシリアルがnullデバイスを表すかどうかを判別します

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

既知のすべてのデバイスのDeviceDescriptorのリストを返します

abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

指定されたusbデバイスをadb-over-tcpモードに切り替え、 connectToTcpDevice(String)を介して接続するヘルパーメソッド。

abstract void removeDeviceMonitor ( IDeviceMonitor mon)

以前に追加されたIDeviceMonitorを削除します。

abstract void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

リスナーがfastboot状態の変更に関心がなくなったことをマネージャーに通知します。

abstract void restartAdbBridge ()

再起動( stopAdbBridge()が呼び出された場合)adbブリッジとサービスはadb接続に依存します。

abstract void stopAdbBridge ()

adbブリッジを停止すると、サービスはadb接続に依存します。

abstract void terminate ()

デバイス監視サービスを停止し、ddmライブラリを終了します。

abstract void terminateDeviceMonitor ()

デバイスモニターを停止します。

abstract void terminateDeviceRecovery ()

デバイスリカバリスレッドを停止します。

default void terminateHard (String reason)

terminateHard()のように。

abstract void terminateHard ()

terminate()と同様ですが、adbも強制的にシャットダウンしようとします。

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 ITestDevice 、またはtcp接続を形成できなかった場合はnull

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

adb-over-tcp接続デバイスから切断します。

デバイスをUSBモードに戻し、解放します。

パラメーター
tcpDevice ITestDevice :現在tcpモードになっているデバイスで、以前はconnectToTcpDevice(String)を介して割り当てられていました

戻り値
boolean USBモードへの切り替えが成功した場合はtrue

displayDevicesInfo

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

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

デバイスをプールに戻す

以前に割り当てられていないデバイスを返す試みは無視されます。

パラメーター
device ITestDevice :解放するITestDevice

state FreeDeviceStateFreeDeviceState 。デバイスが使用可能なデバイスプールに戻されるかどうかを制御するために使用されます。

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)

指定されたシリアルがnullデバイスを表すかどうかを判別します

パラメーター
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 abstract  listAllDevices ()

既知のすべてのデバイスの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状態の変更に関心がなくなったことをマネージャーに通知します。

restartAdbBridge

public abstract void restartAdbBridge ()

再起動( stopAdbBridge()が呼び出された場合)adbブリッジとサービスはadb接続に依存します。

stopAdbBridge

public abstract void stopAdbBridge ()

adbブリッジを停止すると、サービスはadb接続に依存します。

終了する

public abstract void terminate ()

デバイス監視サービスを停止し、ddmライブラリを終了します。

これは、アプリケーションの終了時に呼び出す必要があります。

ターミネートデバイスモニター

public abstract void terminateDeviceMonitor ()

デバイスモニターを停止します。

terminalDeviceRecovery

public abstract void terminateDeviceRecovery ()

デバイスリカバリスレッドを停止します。

ターミネートハード

public void terminateHard (String reason)

terminateHard()のように。

パラメーター
reason String :終了のオプションの理由。

ターミネートハード

public abstract void terminateHard ()

terminate()と同様ですが、adbも強制的にシャットダウンしようとします。

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

最初の物理デバイスが接続されるまで待ちます。デバイスが以前に接続されていた場合は、直接Trueを返します。デバイスが追加されていない場合、タイムアウト後にfalseを返します。

パラメーター
timeout long :falseを返す前にミリ秒単位で待機する時間。

戻り値
boolean