グローバル構成

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

パブリック メソッド
void	cleanup() tradefed シャットダウン時の適切なクリーンアップ。
File	cloneConfigWithFilter( exclusionPatterns, String... allowlistConfigs) ホワイトリストに基づいて GlobalConfiguration をフィルタし、XML ファイルに出力します。
File	cloneConfigWithFilter( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs) ホワイトリストに基づいて GlobalConfiguration をフィルタしつつ、 XML ファイルに出力することもできます。
File	cloneConfigWithFilter(String... allowlistConfigs) 許可リストに基づいて GlobalConfiguration をフィルタし、XML ファイルに出力します。
static	createGlobalConfiguration(String[] args) この TF インスタンスの GlobalConfiguration シングルトンを設定します。
ICommandScheduler	getCommandScheduler() 使用する ICommandScheduler を構成から取得します。
Object	getConfigurationObject(String typeName) 指定された名前のカスタム構成オブジェクトを取得します。
ICredentialFactory	getCredentialFactory() 認証情報を作成するための ICredentialFactory を取得します。
String	getDescription()
DeviceManagementGrpcServer	getDeviceManagementServer() DeviceManagementGrpcServer を返します。未定義の場合は null を返します。
IDeviceManager	getDeviceManager() 使用する IDeviceManager を構成から取得します。
static IDeviceManager	getDeviceManagerInstance() この TF のシングルトン DeviceManager インスタンスへの参照を返します。 作成します。
	getDeviceMonitors() グローバル構成から IDeviceMonitor のリストを取得します。
IDeviceSelection	getDeviceRequirements() 使用する IDeviceSelection を構成から取得します。
TradefedFeatureServer	getFeatureServer() TradefedFeatureServer を返します。未定義の場合は null を返します。
IConfigurationServer	getGlobalConfigServer() グローバル構成サーバーを取得します。
static	getHostMonitorInstances()
	getHostMonitors() グローバル構成から IHostMonitor のリストを取得します。
IHostOptions	getHostOptions() 使用する IHostOptions を構成から取得します。
IHostResourceManager	getHostResourceManager() グローバル構成から IHostResourceManager を取得します。
static IGlobalConfiguration	getInstance() この TF のシングルトン GlobalConfiguration インスタンスへの参照を返します。 作成します。
IKeyStoreFactory	getKeyStoreFactory() 使用する IKeyStoreFactory を構成から取得します。
	getMultiDeviceRecoveryHandlers() 使用する IMultiDeviceRecovery のリストを構成から取得します。
String	getName()
	getOptionValues(String optionName) オプションの値のリストを取得します。
	getResourceMetricCollectors() グローバル構成から IResourceMetricCollector のリストを取得します。
ISandboxFactory	getSandboxFactory() 呼び出しの実行に使用できるサンドボックス ファクトリを取得する
IShardHelper	getShardingStrategy() 構成をシャーディングする方法を定義する IShardHelper を返します。
TestInvocationManagementServer	getTestInvocationManagementSever() TestInvocationManagementServer を返します。未定義の場合は null を返します。
ITerribleFailureHandler	getWtfHandler() 使用する ITerribleFailureHandler を構成から取得します。
void	injectOptionValue(String optionName, String optionValue) 一連の構成オブジェクトにオプション値を挿入します。
void	injectOptionValue(String optionName, String optionKey, String optionValue) 一連の構成オブジェクトにオプション値を挿入します。
void	printCommandUsage(boolean importantOnly, PrintStream out) この設定のコマンドライン使用ヘルプテキストを、指定された printStream に出力します。
void	setCommandScheduler(ICommandScheduler scheduler) ICommandScheduler を設定し、既存の値を置き換えます。
void	setConfigurationFactory(IConfigurationFactory configFactory) この構成の IConfigurationFactory を設定します。
void	setConfigurationObject(String typeName, Object configObject) 指定された名前で構成オブジェクトを設定し、既存の値を置き換える汎用メソッド。
void	setConfigurationObjectList(String typeName, configList) 指定された名前の構成オブジェクト リストを設定する汎用メソッド。既存のリストが置き換えられます。 あります。
void	setDeviceManagementServer(DeviceManagementGrpcServer server) DeviceManagementGrpcServer を設定します。
void	setDeviceManager(IDeviceManager manager) IDeviceManager を設定し、既存の値を置き換えます。
void	setDeviceMonitor(IDeviceMonitor monitor) IDeviceMonitor を設定します。
void	setDeviceRequirements(IDeviceSelection devRequirements) IDeviceSelection を設定し、既存の値を置き換えます。
void	setHostMonitors( hostMonitors) IHostMonitor リストを設定します。
void	setHostOptions(IHostOptions hostOptions) IHostOptions を設定し、既存の値を置き換えます。
void	setHostResourceManager(IHostResourceManager hostResourceManager) IHostResourceManager を設定し、既存の値を置き換えます。
void	setInvocationServer(TestInvocationManagementServer server) TestInvocationManagementServer を設定します。
void	setKeyStoreFactory(IKeyStoreFactory factory) IKeyStoreFactory を設定し、既存の値を置き換えます。
	setOptionsFromCommandLineArgs( listArgs) 指定されたコマンドライン引数のセットでグローバル構成 Option フィールドを設定する 想定される形式については ArgsOptionParser をご覧ください
void	setOriginalConfig(String config) グローバル構成の作成に使用された元の構成を設定します。
void	setResourceMetricCollector(IResourceMetricCollector collector) IResourceMetricCollector を設定します。
void	setSandboxFactory(ISandboxFactory factory) ISandboxFactory を設定し、既存の値を置き換えます。
void	setShardingStrategy(IShardHelper sharding) 構成をシャーディングするときに使用する IShardHelper を設定します。
void	setTradefedFeatureServer(TradefedFeatureServer server) TradefedFeatureServer を設定します。
void	setWtfHandler(ITerribleFailureHandler wtfHandler) ITerribleFailureHandler を設定します。
void	setup() tradefed 開始時の適切なセットアップ。
void	validateOptions() オプションの値を検証します。

保護されたメソッド
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, a default list should be used. に設定されている場合

戻り値
File	フィルタされた新しいグローバル設定を含むファイル。

cloneConfigWithFilter

public File cloneConfigWithFilter ( exclusionPatterns, 
                IConfigOptionValueTransformer transformer, 
                boolean deepCopy, 
                String... allowlistConfigs)

ホワイトリストに基づいて GlobalConfiguration をフィルタしつつ、 XML ファイルに出力することもできます。

パラメータ
exclusionPatterns	: ダンプから除外するクラス名のパターン。
transformer	IConfigOptionValueTransformer
deepCopy	boolean
allowlistConfigs	String: 新しい XML に含める構成の String 配列 表示されます。 null, a default list should be used. に設定されている場合

戻り値
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, a default list should be used. に設定されている場合

戻り値
File	フィルタされた新しいグローバル設定を含むファイル。

createGlobalConfiguration

public static  createGlobalConfiguration (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。

getDescription

public String getDescription ()

戻り値
String	この Configuration でユーザーが読むことができる短い説明

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

public  getDeviceMonitors ()

グローバル構成から 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 static  getHostMonitorInstances ()

戻り値

getHostMonitor

public  getHostMonitors ()

グローバル構成から 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

public  getMultiDeviceRecoveryHandlers ()

使用する IMultiDeviceRecovery のリストを構成から取得します。

戻り値
	IMultiDeviceRecovery のリスト。設定されていない場合は null。

getName

public String getName ()

戻り値
String	この Configuration の名前

getOptionValues

public  getOptionValues (String optionName)

オプションの値のリストを取得します。

パラメータ
optionName	String: マップ オプション名

戻り値
	指定されたオプションの値のリスト。オプション名が一致しない場合は null あります。

getResourceMetricCollectors

public  getResourceMetricCollectors ()

グローバル構成から 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	: モニターのリスト

setHostOptions

public void setHostOptions (IHostOptions hostOptions)

IHostOptions を設定し、既存の値を置き換えます。

setHostResourceManager

public void setHostResourceManager (IHostResourceManager hostResourceManager)

IHostResourceManager を設定し、既存の値を置き換えます。

setInvocationServer

public void setInvocationServer (TestInvocationManagementServer server)

TestInvocationManagementServer を設定します。

パラメータ
server	TestInvocationManagementServer

setKeyStoreFactory

public void setKeyStoreFactory (IKeyStoreFactory factory)

IKeyStoreFactory を設定し、既存の値を置き換えます。

setOptionsFromCommandLineArgs

public  setOptionsFromCommandLineArgs ( 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 ハンドラ

設定

public void setup ()

tradefed 開始時の適切なセットアップ。

例外
ConfigurationException

validateOptions

public void validateOptions ()

オプションの値を検証します。

現時点では、必須オプションがすべて設定されていることを確認するだけです。

例外
ConfigurationException

保護されたメソッド

getConfigurationFactory

protected IConfigurationFactory getConfigurationFactory ()

戻り値
IConfigurationFactory