グローバル構成
public
class
GlobalConfiguration
extends Object
implements
IGlobalConfiguration
java.lang.Object | |
↳ | com.android.tradefed.config.GlobalConfiguration |
読み込まれた構成オブジェクトをマップに保存する IGlobalConfiguration
実装
概要
フィールド | |
---|---|
public
static
final
String |
CREDENTIAL_FACTORY_TYPE_NAME
|
public
static
final
String |
DEVICE_MANAGER_TYPE_NAME
|
public
static
final
String |
DEVICE_MONITOR_TYPE_NAME
|
public
static
final
String |
DEVICE_REQUIREMENTS_TYPE_NAME
|
public
static
final
String |
GLOBAL_CONFIG_SERVER
|
public
static
final
String |
GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE
|
public
static
final
String |
GLOBAL_CONFIG_VARIABLE
|
public
static
final
String |
HOST_MONITOR_TYPE_NAME
|
public
static
final
String |
HOST_OPTIONS_TYPE_NAME
|
public
static
final
String |
HOST_RESOURCE_MANAGER_TYPE_NAME
|
public
static
final
String |
KEY_STORE_TYPE_NAME
|
public
static
final
String |
MULTI_DEVICE_RECOVERY_TYPE_NAME
|
public
static
final
String |
RESOURCE_METRIC_COLLECTOR_TYPE_NAME
|
public
static
final
String |
SANDBOX_FACTORY_TYPE_NAME
|
public
static
final
String |
SCHEDULER_TYPE_NAME
|
public
static
final
String |
SHARDING_STRATEGY_TYPE_NAME
|
public
static
final
String |
TF_DEVICE_MANAGEMENT_SERVER_NAME
|
public
static
final
String |
TF_FEATURE_SERVER_NAME
|
public
static
final
String |
TF_INVOCATION_SERVER_NAME
|
public
static
final
String |
WTF_HANDLER_TYPE_NAME
|
保護されたメソッド | |
---|---|
IConfigurationFactory
|
getConfigurationFactory()
|
フィールド
CREDENTIAL_FACTORY_TYPE_NAME
public static final String CREDENTIAL_FACTORY_TYPE_NAME
DEVICE_MANAGER_TYPE_NAME
public static final String DEVICE_MANAGER_TYPE_NAME
DEVICE_MONITOR_TYPE_NAME
public static final String DEVICE_MONITOR_TYPE_NAME
DEVICE_REQUIREMENTS_TYPE_NAME
public static final String DEVICE_REQUIREMENTS_TYPE_NAME
GLOBAL_CONFIG_SERVER
public static final String GLOBAL_CONFIG_SERVER
GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE
public static final String GLOBAL_CONFIG_SERVER_CONFIG_VARIABLE
GLOBAL_CONFIG_VARIABLE
public static final String GLOBAL_CONFIG_VARIABLE
HOST_MONITOR_TYPE_NAME
public static final String HOST_MONITOR_TYPE_NAME
HOST_OPTIONS_TYPE_NAME
public static final String HOST_OPTIONS_TYPE_NAME
HOST_RESOURCE_MANAGER_TYPE_NAME
public static final String HOST_RESOURCE_MANAGER_TYPE_NAME
KEY_STORE_TYPE_NAME
public static final String KEY_STORE_TYPE_NAME
MULTI_DEVICE_RECOVERY_TYPE_NAME
public static final String MULTI_DEVICE_RECOVERY_TYPE_NAME
RESOURCE_METRIC_COLLECTOR_TYPE_NAME
public static final String RESOURCE_METRIC_COLLECTOR_TYPE_NAME
サンドボックス FACTORY_TYPE_NAME
public static final String SANDBOX_FACTORY_TYPE_NAME
SCHEDULER_TYPE_NAME
public static final String SCHEDULER_TYPE_NAME
SHARDING_STRATEGY_TYPE_NAME
public static final String SHARDING_STRATEGY_TYPE_NAME
TF_DEVICE_MANAGEMENT_SERVER_NAME
public static final String TF_DEVICE_MANAGEMENT_SERVER_NAME
TF_FEATURE_SERVER_NAME
public static final String TF_FEATURE_SERVER_NAME
TF_INVOCATION_SERVER_NAME
public static final String TF_INVOCATION_SERVER_NAME
WTF_HANDLER_TYPE_NAME
public static final String WTF_HANDLER_TYPE_NAME
パブリック メソッド
クリーンアップ
public void cleanup ()
tradefed シャットダウン時の適切なクリーンアップ。
cloneConfigWithFilter
public File cloneConfigWithFilter (exclusionPatterns, String... allowlistConfigs)
ホワイトリストに基づいて GlobalConfiguration をフィルタし、XML ファイルに出力します。
パラメータ | |
---|---|
exclusionPatterns |
: ダンプから除外するクラス名のパターン。 |
allowlistConfigs |
String : 新しい XML ファイルに含める設定の String 配列。
null に設定されている場合 |
戻り値 | |
---|---|
File |
フィルタされた新しいグローバル設定を含むファイル。 |
cloneConfigWithFilter
public File cloneConfigWithFilter (exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs)
ホワイトリストに基づいて GlobalConfiguration をフィルタしつつ、 XML ファイルに出力することもできます。
パラメータ | |
---|---|
exclusionPatterns |
: ダンプから除外するクラス名のパターン。 |
transformer |
IConfigOptionValueTransformer |
deepCopy |
boolean |
allowlistConfigs |
String : 新しい XML に含める構成の String 配列
表示されます。
null に設定されている場合 |
戻り値 | |
---|---|
File |
フィルタされた新しいグローバル設定を含むファイル。 |
cloneConfigWithFilter
public File cloneConfigWithFilter (String... allowlistConfigs)
許可リストに基づいて GlobalConfiguration をフィルタし、XML ファイルに出力します。
たとえば、次の構成の場合:
<xml>
<configuration>
<device_monitor class="com.android.tradefed.device.DeviceMonitorMultiplexer" />
<wtf_handler class="com.android.tradefed.log.TerribleFailureEmailHandler" />
<key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" />
</configuration>
</xml>
「key_store」を除くすべての構成フィルタされ、その結果、
次の内容が含まれます。
<xml>
<configuration>
<key_store class="com.android.tradefed.util.keystore.JSONFileKeyStoreFactory" />
</configuration>
</xml>
パラメータ | |
---|---|
allowlistConfigs |
String : 新しい XML ファイルに含める設定の String 配列。
null に設定されている場合 |
戻り値 | |
---|---|
File |
フィルタされた新しいグローバル設定を含むファイル。 |
createGlobalConfiguration
public staticcreateGlobalConfiguration (String[] args)
この TF インスタンスの GlobalConfiguration
シングルトンを設定します。呼び出す必要がある
getInstance()
の呼び出しが試行される前に 1 回だけ
パラメータ | |
---|---|
args |
String |
戻り値 | |
---|---|
|
例外 | |
---|---|
IllegalStateException |
複数回呼び出された場合 |
ConfigurationException |
getCommandScheduler
public ICommandScheduler getCommandScheduler ()
使用する ICommandScheduler
を構成から取得します。
戻り値 | |
---|---|
ICommandScheduler |
ICommandScheduler 。null が返されることはありません。 |
getConfigurationObject
public Object getConfigurationObject (String typeName)
指定された名前のカスタム構成オブジェクトを取得します。
パラメータ | |
---|---|
typeName |
String : 構成オブジェクトの一意のタイプ |
戻り値 | |
---|---|
Object |
その名前のオブジェクトが見つからない場合は null。 |
getCredentialFactory
public ICredentialFactory getCredentialFactory ()
認証情報を作成するための ICredentialFactory
を取得します。
戻り値 | |
---|---|
ICredentialFactory |
指定されていない場合は ICredentialFactory または null 。 |
getDeviceManagementServer
public DeviceManagementGrpcServer getDeviceManagementServer ()
DeviceManagementGrpcServer
を返します。未定義の場合は null を返します。
戻り値 | |
---|---|
DeviceManagementGrpcServer |
getDeviceManager
public IDeviceManager getDeviceManager ()
使用する IDeviceManager
を構成から取得します。使用可能な一連の
テスト用デバイス
戻り値 | |
---|---|
IDeviceManager |
構成で指定された IDeviceManager 。 |
getDeviceManagerInstance
public static IDeviceManager getDeviceManagerInstance ()
この TF のシングルトン DeviceManager
インスタンスへの参照を返します。
作成します。
戻り値 | |
---|---|
IDeviceManager |
例外 | |
---|---|
IllegalStateException |
(createGlobalConfiguration(String[]) がアップロードされていない場合)
すでに呼び出されています。 |
getDeviceMonitor
publicgetDeviceMonitors ()
グローバル構成から IDeviceMonitor
のリストを取得します。
戻り値 | |
---|---|
|
グローバル構成の IDeviceMonitor のリスト。それ以外の場合は null
指定されていません。 |
getDeviceRequirements
public IDeviceSelection getDeviceRequirements ()
使用する IDeviceSelection
を構成から取得します。グローバル フィルタを表します。
DeviceManager
がアクセスできるデバイスを指定できます。
戻り値 | |
---|---|
IDeviceSelection |
構成で指定された IDeviceSelection 。 |
getFeatureServer
public TradefedFeatureServer getFeatureServer ()
TradefedFeatureServer
を返します。未定義の場合は null を返します。
戻り値 | |
---|---|
TradefedFeatureServer |
getGlobalConfigServer
public IConfigurationServer getGlobalConfigServer ()
グローバル構成サーバーを取得します。グローバル構成サーバーは、サーバーからホスト構成を取得するために使用されます。 ローカル ファイルから取得しません。
戻り値 | |
---|---|
IConfigurationServer |
getHostMonitorInstances
public staticgetHostMonitorInstances ()
戻り値 | |
---|---|
|
getHostMonitor
publicgetHostMonitors ()
グローバル構成から IHostMonitor
のリストを取得します。
戻り値 | |
---|---|
|
グローバル構成の IHostMonitor のリスト。存在しない場合は null 。
指定されていました。 |
getHostOptions
public IHostOptions getHostOptions ()
使用する IHostOptions
を構成から取得します。
戻り値 | |
---|---|
IHostOptions |
構成で指定された IDeviceManager 。 |
getHostResourceManager
public IHostResourceManager getHostResourceManager ()
グローバル構成から IHostResourceManager
を取得します。
戻り値 | |
---|---|
IHostResourceManager |
グローバル構成の IHostResourceManager 、またはデフォルト実装
ホスト構成で何も指定されていない場合は LocalHostResourceManager 。 |
getInstance
public static IGlobalConfiguration getInstance ()
この TF のシングルトン GlobalConfiguration
インスタンスへの参照を返します。
作成します。
戻り値 | |
---|---|
IGlobalConfiguration |
例外 | |
---|---|
IllegalStateException |
(createGlobalConfiguration(String[]) がアップロードされていない場合)
すでに呼び出されています。 |
getKeyStoreFactory
public IKeyStoreFactory getKeyStoreFactory ()
使用する IKeyStoreFactory
を構成から取得します。
戻り値 | |
---|---|
IKeyStoreFactory |
IKeyStoreFactory 。キーストア ファクトリが設定されていない場合は null。 |
getMultiDeviceRecoveryHandlers
publicgetMultiDeviceRecoveryHandlers ()
使用する IMultiDeviceRecovery
のリストを構成から取得します。
戻り値 | |
---|---|
|
IMultiDeviceRecovery のリスト。設定されていない場合は null 。 |
getOptionValues
publicgetOptionValues (String optionName)
オプションの値のリストを取得します。
パラメータ | |
---|---|
optionName |
String : マップ オプション名 |
戻り値 | |
---|---|
|
指定されたオプションの値のリスト。オプション名が一致しない場合は null
あります。 |
getResourceMetricCollectors
publicgetResourceMetricCollectors ()
グローバル構成から IResourceMetricCollector
のリストを取得します。
戻り値 | |
---|---|
|
グローバル構成の IResourceMetricCollector のリスト。指定されていない場合は null
。 |
getSandboxFactory
public ISandboxFactory getSandboxFactory ()
呼び出しの実行に使用できるサンドボックス ファクトリを取得する
戻り値 | |
---|---|
ISandboxFactory |
getShardingStrategy
public IShardHelper getShardingStrategy ()
構成をシャーディングする方法を定義する IShardHelper
を返します。
戻り値 | |
---|---|
IShardHelper |
getTestInvocationManagementSever
public TestInvocationManagementServer getTestInvocationManagementSever ()
TestInvocationManagementServer
を返します。未定義の場合は null を返します。
戻り値 | |
---|---|
TestInvocationManagementServer |
getWtfHandler
public ITerribleFailureHandler getWtfHandler ()
使用する ITerribleFailureHandler
を構成から取得します。
WTF(What a Terrible Failure)が発生した場合の対応方法
発生します。
戻り値 | |
---|---|
ITerribleFailureHandler |
引数として渡される ITerribleFailureHandler
ハンドラが設定されていない場合は null。 |
annotationOptionValue
public void injectOptionValue (String optionName, String optionValue)
一連の構成オブジェクトにオプション値を挿入します。
動的に生成されるオプションの値を指定する場合に便利です。
パラメータ | |
---|---|
optionName |
String : オプション名 |
optionValue |
String : オプションの値 |
例外 | |
---|---|
ConfigurationException |
annotationOptionValue
public void injectOptionValue (String optionName, String optionKey, String optionValue)
一連の構成オブジェクトにオプション値を挿入します。
動的に生成されるオプションの値を指定する場合に便利です。
パラメータ | |
---|---|
optionName |
String : マップ オプション名 |
optionKey |
String : マップのオプションキー |
optionValue |
String : マップ オプションの値 |
例外 | |
---|---|
ConfigurationException |
printCommandUsage
public void printCommandUsage (boolean importantOnly, PrintStream out)
この設定のコマンドライン使用ヘルプテキストを、指定された printStream に出力します。
パラメータ | |
---|---|
importantOnly |
boolean |
out |
PrintStream : 使用する ERROR(/PrintStream) 。 |
例外 | |
---|---|
|
com.android.tradefed.config.ConfigurationException |
ConfigurationException |
setCommandScheduler
public void setCommandScheduler (ICommandScheduler scheduler)
ICommandScheduler
を設定し、既存の値を置き換えます。
setConfigurationFactory
public void setConfigurationFactory (IConfigurationFactory configFactory)
この構成の IConfigurationFactory
を設定します。
パラメータ | |
---|---|
configFactory |
IConfigurationFactory |
setConfigurationObject
public void setConfigurationObject (String typeName, Object configObject)
指定された名前で構成オブジェクトを設定し、既存の値を置き換える汎用メソッド。
パラメータ | |
---|---|
typeName |
String : 構成オブジェクト タイプの一意の名前。 |
configObject |
Object : config オブジェクト |
例外 | |
---|---|
ConfigurationException |
setConfigurationObjectList
public void setConfigurationObjectList (String typeName,configList)
指定された名前の構成オブジェクト リストを設定する汎用メソッド。既存のリストが置き換えられます。 あります。
パラメータ | |
---|---|
typeName |
String : 構成オブジェクト タイプの一意の名前。 |
configList |
: 構成オブジェクトのリスト |
例外 | |
---|---|
ConfigurationException |
setDeviceManagementServer
public void setDeviceManagementServer (DeviceManagementGrpcServer server)
DeviceManagementGrpcServer
を設定します。
パラメータ | |
---|---|
server |
DeviceManagementGrpcServer |
setDeviceManager
public void setDeviceManager (IDeviceManager manager)
IDeviceManager
を設定し、既存の値を置き換えます。これにより、
テストデバイス
setDeviceMonitor
public void setDeviceMonitor (IDeviceMonitor monitor)
IDeviceMonitor
を設定します。
パラメータ | |
---|---|
monitor |
IDeviceMonitor : モニター |
setDeviceRequirements
public void setDeviceRequirements (IDeviceSelection devRequirements)
IDeviceSelection
を設定し、既存の値を置き換えます。グローバル デバイスが設定されます
DeviceManager
が認識できるデバイスのフィルタ。
setHostMonitors
public void setHostMonitors (hostMonitors)
IHostMonitor
リストを設定します。
パラメータ | |
---|---|
hostMonitors |
: モニターのリスト |
setHostResourceManager
public void setHostResourceManager (IHostResourceManager hostResourceManager)
IHostResourceManager
を設定し、既存の値を置き換えます。
setInvocationServer
public void setInvocationServer (TestInvocationManagementServer server)
TestInvocationManagementServer
を設定します。
パラメータ | |
---|---|
server |
TestInvocationManagementServer |
setKeyStoreFactory
public void setKeyStoreFactory (IKeyStoreFactory factory)
IKeyStoreFactory
を設定し、既存の値を置き換えます。
setOptionsFromCommandLineArgs
publicsetOptionsFromCommandLineArgs ( listArgs)
指定されたコマンドライン引数のセットでグローバル構成 Option
フィールドを設定する
想定される形式については ArgsOptionParser
をご覧ください
パラメータ | |
---|---|
listArgs |
: コマンドライン引数 |
戻り値 | |
---|---|
|
未使用の引数は |
例外 | |
---|---|
ConfigurationException |
setOriginalConfig
public void setOriginalConfig (String config)
グローバル構成の作成に使用された元の構成を設定します。
パラメータ | |
---|---|
config |
String |
setResourceMetricCollector
public void setResourceMetricCollector (IResourceMetricCollector collector)
IResourceMetricCollector
を設定します。
パラメータ | |
---|---|
collector |
IResourceMetricCollector |
setSandboxFactory
public void setSandboxFactory (ISandboxFactory factory)
ISandboxFactory
を設定し、既存の値を置き換えます。
setShardingStrategy
public void setShardingStrategy (IShardHelper sharding)
構成をシャーディングするときに使用する IShardHelper
を設定します。
パラメータ | |
---|---|
sharding |
IShardHelper |
setTradefedFeatureServer
public void setTradefedFeatureServer (TradefedFeatureServer server)
TradefedFeatureServer
を設定します。
パラメータ | |
---|---|
server |
TradefedFeatureServer |
setWtfHandler
public void setWtfHandler (ITerribleFailureHandler wtfHandler)
ITerribleFailureHandler
を設定します。
パラメータ | |
---|---|
wtfHandler |
ITerribleFailureHandler : WTF ハンドラ |
validateOptions
public void validateOptions ()
オプションの値を検証します。
現時点では、必須オプションがすべて設定されていることを確認するだけです。
例外 | |
---|---|
ConfigurationException |
保護されたメソッド
getConfigurationFactory
protected IConfigurationFactory getConfigurationFactory ()
戻り値 | |
---|---|
IConfigurationFactory |