Google は、黒人コミュニティに対する人種平等の促進に取り組んでいます。取り組みを見る
このページは Cloud Translation API によって翻訳されました。
Switch to English

IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


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

概要

ネストされたクラス

interface IDeviceManager.IFastbootListener

fastboot状態変更のリスナー。

パブリックメソッド

abstract void addDeviceMonitor ( IDeviceMonitor mon)

IDeviceMonitor追加しIDeviceMonitor

abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

リスナーが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)介して最終的に解放されdisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

返されたITestDeviceはオンラインになりますが、応答しない場合があります。

abstract boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

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

abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)

既知のデバイスのリスト、それらの状態、および一般的に使用されるIDeviceSelectionオプションの値を含む、わかりやすい説明を出力します。

abstract ITestDevice forceAllocateDevice (String serial)

デバイスが現在利用できない場合でも、おおまかにデバイスを割り当てます。

abstract void freeDevice ( ITestDevice device, FreeDeviceState state)

デバイスをプールに戻す

以前に割り当てられていないデバイスを返そうとしても無視されます。

abstract String getAdbPath ()

使用するadbバイナリへのパスを返します。

abstract String getAdbVersion ()

デバイスマネージャーで現在使用されているadbのバージョンを取得します。

abstract int getAvailableFlashingPermits ()

利用可能な点滅許可の数を取得します

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)

指定されたシリアルがエミュレータを表すかどうかを判断する

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

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

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

以前に取得した点滅許可を復元します

abstract void stopAdbBridge ()

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

abstract void takeFlashingPermit ()

フラッシュする許可を要求します。

abstract void terminate ()

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

abstract void terminateDeviceMonitor ()

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

abstract void terminateDeviceRecovery ()

デバイス回復スレッドを停止します。

abstract void terminateHard ()

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

abstract boolean waitForFirstDeviceAdded (long timeout)

最初の物理デバイスが接続されるまで待ちます。

パブリックメソッド

addDeviceMonitor

public abstract void addDeviceMonitor ( IDeviceMonitor mon)

IDeviceMonitor追加しIDeviceMonitor

パラメーター
mon IDeviceMonitor

addFastbootListener

public abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

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

現在、 IDeviceManagerは、1つ以上のアクティブなリスナーがある場合にのみ、fastbootでデバイスを監視します。

TODO:これは少しハックです-より良い解決策を見つけてください

allocateDevice

public abstract ITestDevice allocateDevice ( IDeviceSelection options, 
                boolean isTemporary)

特定の基準を満たすテスト用デバイスをリクエストします。

パラメーター
options IDeviceSelection :デバイスが満たすべきIDeviceSelection

isTemporary boolean :一時的なNullDeviceを作成する必要があるかどうか。

戻り値
ITestDevice テスト用のITestDevice使用できない場合はnull

allocateDevice

public abstract ITestDevice allocateDevice ( IDeviceSelection options)

特定の基準を満たすテスト用のデバイスを要求します。

パラメーター
options IDeviceSelection :デバイスが満たすべきIDeviceSelection

戻り値
ITestDevice テスト用のITestDevice使用できない場合はnull

allocateDevice

public abstract ITestDevice allocateDevice ()

テストのために物理デバイスを要求する

戻り値
ITestDevice テスト用のITestDevice使用できない場合はnull

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

adb-over-tcpを使用してデバイスに接続する

このメソッドは、新しいデバイスを割り当てます。新しいデバイスは、 disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)介して最終的に解放されdisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

返されたITestDeviceはオンラインになりますが、応答しない場合があります。

tcp接続されたデバイスで再起動などのアクションを実行すると、デバイスへのtcp接続が切断され、 DeviceNotAvailableException発生することにDeviceNotAvailableExceptionして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 :スタブデバイスも表示するかどうか。

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

getAvailableFlashingPermits

public abstract int getAvailableFlashingPermits ()

利用可能な点滅許可の数を取得します

戻り値
int 使用可能なフラッシュ許可の数、または使用できない場合はInteger.MAX_VALUE。

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

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

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

戻り値
すべての既知のデバイスの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接続に依存します。

returnFlashingPermit

public abstract void returnFlashingPermit ()

以前に取得した点滅許可を復元します

stopAdbBridge

public abstract void stopAdbBridge ()

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

takeFlashingPermit

public abstract void takeFlashingPermit ()

フラッシュする許可を要求します。同時フラッシャーの数が制限されている場合、これはフラッシュ制限カウントを下回るようにするために並んで待機します。

終了する

public abstract void terminate ()

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

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

以下も参照してください。

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

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

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

デバイス回復スレッドを停止します。

terminateHard

public abstract void terminateHard ()

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

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

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

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

戻り値
boolean