2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main 대신 android-latest-release를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

IGlobalConfiguration

public interface IGlobalConfiguration

com.android.tradefed.config.IGlobalConfiguration

알려진 간접 하위 클래스

GlobalConfiguration

GlobalConfiguration 로드된 구성 객체를 맵에 저장하는 IGlobalConfiguration 구현

단일 Trade Federation 인스턴스의 전역 구성 정보를 포함하는 클래스(실제 구성의 호출 횟수와 관계없이 포함)입니다.

요약

공개 메서드
`abstract void`	`cleanup()` 트레이드페드 종료 시 적절한 정리
`abstract File`	`cloneConfigWithFilter( exclusionPatterns, String... allowlistConfigs)` 허용 목록을 기반으로 GlobalConfiguration을 필터링하고 XML 파일로 출력합니다.
`abstract File`	`cloneConfigWithFilter( exclusionPatterns, IConfigOptionValueTransformer transformer, boolean deepCopy, String... allowlistConfigs)` 옵션 값을 조작하고 XML 파일로 출력할 수 있도록 허용하면서 허용 목록을 기반으로 GlobalConfiguration을 필터링합니다.
`abstract File`	`cloneConfigWithFilter(String... allowlistConfigs)` 허용 목록을 기반으로 GlobalConfiguration을 필터링하고 XML 파일로 출력합니다.
`abstract ICommandScheduler`	`getCommandScheduler()` 구성에서 사용할 `ICommandScheduler`를 가져옵니다.
`abstract Object`	`getConfigurationObject(String typeName)` 지정된 이름의 맞춤 구성 객체를 가져옵니다.
`abstract ICredentialFactory`	`getCredentialFactory()` 사용자 인증 정보를 만들기 위한 `ICredentialFactory`를 가져옵니다.
`abstract DeviceManagementGrpcServer`	`getDeviceManagementServer()` `DeviceManagementGrpcServer`를 반환하거나 정의되지 않은 경우 null을 반환합니다.
`abstract IDeviceManager`	`getDeviceManager()` 구성에서 사용할 `IDeviceManager`를 가져옵니다.
`abstract`	`getDeviceMonitors()` 전역 구성에서 `IDeviceMonitor` 목록을 가져옵니다.
`abstract IDeviceSelection`	`getDeviceRequirements()` 구성에서 사용할 `IDeviceSelection`를 가져옵니다.
`abstract TradefedFeatureServer`	`getFeatureServer()` `TradefedFeatureServer`를 반환하거나 정의되지 않은 경우 null을 반환합니다.
`abstract IConfigurationServer`	`getGlobalConfigServer()` 전역 구성 서버를 가져옵니다.
`abstract`	`getHostMonitors()` 전역 구성에서 `IHostMonitor` 목록을 가져옵니다.
`abstract IHostOptions`	`getHostOptions()` 구성에서 사용할 `IHostOptions`를 가져옵니다.
`abstract IHostResourceManager`	`getHostResourceManager()` 전역 구성에서 `IHostResourceManager`를 가져옵니다.
`abstract IKeyStoreFactory`	`getKeyStoreFactory()` 구성에서 사용할 `IKeyStoreFactory`를 가져옵니다.
`abstract`	`getMultiDeviceRecoveryHandlers()` 구성에서 사용할 `IMultiDeviceRecovery` 목록을 가져옵니다.
`abstract`	`getOptionValues(String optionName)` 옵션 값 목록을 가져옵니다.
`abstract`	`getResourceMetricCollectors()` 전역 구성에서 `IResourceMetricCollector` 목록을 가져옵니다.
`abstract ISandboxFactory`	`getSandboxFactory()` 호출을 실행하는 데 사용할 수 있는 샌드박스 팩토리 가져오기
`abstract IShardHelper`	`getShardingStrategy()` 구성을 샤딩하는 방법을 정의하는 `IShardHelper`를 반환합니다.
`abstract TestInvocationManagementServer`	`getTestInvocationManagementSever()` `TestInvocationManagementServer`를 반환하거나 정의되지 않은 경우 null을 반환합니다.
`abstract ITerribleFailureHandler`	`getWtfHandler()` 구성에서 사용할 `ITerribleFailureHandler`를 가져옵니다.
`abstract void`	`injectOptionValue(String optionName, String optionValue)` 구성 객체 집합에 옵션 값을 삽입합니다.
`abstract void`	`injectOptionValue(String optionName, String optionKey, String optionValue)` 구성 객체 집합에 옵션 값을 삽입합니다.
`abstract void`	`setCommandScheduler(ICommandScheduler scheduler)` `ICommandScheduler`를 설정하여 기존 값을 대체합니다.
`abstract void`	`setConfigurationFactory(IConfigurationFactory configFactory)` 이 구성의 `IConfigurationFactory`를 설정합니다.
`abstract void`	`setConfigurationObject(String name, Object configObject)` 지정된 이름으로 구성 객체를 설정하여 기존 값을 대체하는 일반 메서드입니다.
`abstract void`	`setConfigurationObjectList(String typeName, configList)` 지정된 이름의 구성 객체 목록을 설정하는 일반 메서드로, 기존 값을 대체합니다.
`abstract void`	`setDeviceManagementServer(DeviceManagementGrpcServer server)` `DeviceManagementGrpcServer`를 설정합니다.
`abstract void`	`setDeviceManager(IDeviceManager deviceManager)` `IDeviceManager`를 설정하여 기존 값을 대체합니다.
`abstract void`	`setDeviceMonitor(IDeviceMonitor deviceMonitor)` `IDeviceMonitor`를 설정합니다.
`abstract void`	`setDeviceRequirements(IDeviceSelection deviceSelection)` `IDeviceSelection`를 설정하여 기존 값을 대체합니다.
`abstract void`	`setHostMonitors( hostMonitors)` `IHostMonitor` 목록을 설정합니다.
`abstract void`	`setHostOptions(IHostOptions hostOptions)` `IHostOptions`를 설정하여 기존 값을 대체합니다.
`abstract void`	`setHostResourceManager(IHostResourceManager hostResourceManager)` `IHostResourceManager`를 설정하여 기존 값을 대체합니다.
`abstract void`	`setInvocationServer(TestInvocationManagementServer server)` `TestInvocationManagementServer`를 설정합니다.
`abstract void`	`setKeyStoreFactory(IKeyStoreFactory factory)` `IKeyStoreFactory`를 설정하여 기존 값을 대체합니다.
`abstract`	`setOptionsFromCommandLineArgs( listArgs)` 지정된 명령줄 인수 세트로 전역 구성 `Option` 필드 설정 예상 형식은 `ArgsOptionParser`를 참고하세요.
`abstract void`	`setOriginalConfig(String config)` 전역 구성을 만드는 데 사용된 원래 구성을 설정합니다.
`abstract void`	`setResourceMetricCollector(IResourceMetricCollector collector)` `IResourceMetricCollector`를 설정합니다.
`abstract void`	`setSandboxFactory(ISandboxFactory factory)` `ISandboxFactory`를 설정하여 기존 값을 대체합니다.
`abstract void`	`setShardingStrategy(IShardHelper sharding)` 구성을 샤딩할 때 사용할 `IShardHelper`를 설정합니다.
`abstract void`	`setTradefedFeatureServer(TradefedFeatureServer server)` `TradefedFeatureServer`를 설정합니다.
`abstract void`	`setWtfHandler(ITerribleFailureHandler wtfHandler)` `ITerribleFailureHandler`를 설정합니다.
`abstract void`	`setup()` Tradefed 시작 시 올바른 설정
`abstract void`	`validateOptions()` 옵션 값을 검증합니다.

공개 메서드

정리

public abstract void cleanup ()

트레이드페드 종료 시 적절한 정리

cloneConfigWithFilter

public abstract File cloneConfigWithFilter ( exclusionPatterns, 
                String... allowlistConfigs)

허용 목록을 기반으로 GlobalConfiguration을 필터링하고 XML 파일로 출력합니다.

매개변수
`exclusionPatterns`	: 덤프에서 제외할 클래스 이름의 패턴입니다.
`allowlistConfigs`	`String`: 새 XML 파일에 포함할 구성의 `String` 배열입니다. `null, a default list should be used.`로 설정된 경우

반환 값
`File`	새 필터링된 전역 구성이 포함된 파일입니다.

생성 값
	IOException

참고:

cloneConfigWithFilter(String)

cloneConfigWithFilter

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

옵션 값을 조작하고 XML 파일로 출력할 수 있도록 허용하면서 허용 목록을 기반으로 GlobalConfiguration을 필터링합니다.

매개변수
`exclusionPatterns`	: 덤프에서 제외할 클래스 이름의 패턴입니다.
`transformer`	`IConfigOptionValueTransformer`
`deepCopy`	`boolean`
`allowlistConfigs`	`String`: 새 XML 파일에 포함할 구성의 `String` 배열입니다. `null, a default list should be used.`로 설정된 경우

반환 값
`File`	새 필터링된 전역 구성이 포함된 파일입니다.

참고:

cloneConfigWithFilter(String)

cloneConfigWithFilter

public abstract 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`	새 필터링된 전역 구성이 포함된 파일입니다.

생성 값
	IOException

getCommandScheduler

public abstract ICommandScheduler getCommandScheduler ()

구성에서 사용할 ICommandScheduler를 가져옵니다.

반환 값
`ICommandScheduler`	`ICommandScheduler` null을 반환하지 않습니다.

getConfigurationObject

public abstract Object getConfigurationObject (String typeName)

지정된 이름의 맞춤 구성 객체를 가져옵니다.

매개변수
`typeName`	`String`: 구성 객체의 고유 유형

반환 값
`Object`	객체 또는 이름이 같은 객체를 찾을 수 없는 경우 null

getCredentialFactory

public abstract ICredentialFactory getCredentialFactory ()

사용자 인증 정보를 만들기 위한 ICredentialFactory를 가져옵니다.

반환 값
`ICredentialFactory`	지정하지 않은 경우 `ICredentialFactory` 또는 `null`입니다.

getDeviceManagementServer

public abstract DeviceManagementGrpcServer getDeviceManagementServer ()

DeviceManagementGrpcServer를 반환하거나 정의되지 않은 경우 null을 반환합니다.

반환 값
`DeviceManagementGrpcServer`

getDeviceManager

public abstract IDeviceManager getDeviceManager ()

구성에서 사용할 IDeviceManager를 가져옵니다. 테스트에 사용할 수 있는 기기 세트를 관리합니다.

반환 값
`IDeviceManager`	구성에 제공된 `IDeviceManager`입니다.

getDeviceMonitors

public abstract  getDeviceMonitors ()

전역 구성에서 IDeviceMonitor 목록을 가져옵니다.

반환 값
	전역 구성의 `IDeviceMonitor` 목록 또는 지정되지 않은 경우 `null`입니다.

getDeviceRequirements

public abstract IDeviceSelection getDeviceRequirements ()

구성에서 사용할 IDeviceSelection를 가져옵니다. DeviceManager가 볼 수 있는 기기의 전역 필터를 나타냅니다.

반환 값
`IDeviceSelection`	구성에 제공된 `IDeviceSelection`입니다.

getFeatureServer

public abstract TradefedFeatureServer getFeatureServer ()

TradefedFeatureServer를 반환하거나 정의되지 않은 경우 null을 반환합니다.

반환 값
`TradefedFeatureServer`

getGlobalConfigServer

public abstract IConfigurationServer getGlobalConfigServer ()

전역 구성 서버를 가져옵니다. 글로벌 구성 서버는 로컬 파일에서 가져오는 대신 서버에서 호스트 구성을 가져오는 데 사용됩니다.

반환 값
`IConfigurationServer`

getHostMonitors

public abstract  getHostMonitors ()

전역 구성에서 IHostMonitor 목록을 가져옵니다.

반환 값
	전역 구성의 `IHostMonitor` 목록 또는 지정되지 않은 경우 `null`입니다.

getHostOptions

public abstract IHostOptions getHostOptions ()

구성에서 사용할 IHostOptions를 가져옵니다.

반환 값
`IHostOptions`	구성에 제공된 `IDeviceManager`입니다.

getHostResourceManager

public abstract IHostResourceManager getHostResourceManager ()

전역 구성에서 IHostResourceManager를 가져옵니다.

반환 값
`IHostResourceManager`	전체 구성의 `IHostResourceManager` 또는 호스트 구성에 지정된 것이 없는 경우 기본 구현 `LocalHostResourceManager`입니다.

getKeyStoreFactory

public abstract IKeyStoreFactory getKeyStoreFactory ()

구성에서 사용할 IKeyStoreFactory를 가져옵니다.

반환 값
`IKeyStoreFactory`	키 저장소 팩토리가 설정되지 않은 경우 `IKeyStoreFactory` 또는 null입니다.

getMultiDeviceRecoveryHandlers

public abstract  getMultiDeviceRecoveryHandlers ()

구성에서 사용할 IMultiDeviceRecovery 목록을 가져옵니다.

반환 값
	`IMultiDeviceRecovery` 목록 또는 설정되지 않은 경우 `null`입니다.

getOptionValues

public abstract  getOptionValues (String optionName)

옵션 값 목록을 가져옵니다.

매개변수
`optionName`	`String`: 지도 옵션 이름

반환 값
	지정된 옵션의 값 목록입니다. 옵션 이름이 없는 경우 `null`입니다.

getResourceMetricCollectors

public abstract  getResourceMetricCollectors ()

전역 구성에서 IResourceMetricCollector 목록을 가져옵니다.

반환 값
	전역 구성의 `IResourceMetricCollector` 목록 또는 지정되지 않은 경우 `null`입니다.

getSandboxFactory

public abstract ISandboxFactory getSandboxFactory ()

호출을 실행하는 데 사용할 수 있는 샌드박스 팩토리 가져오기

반환 값
`ISandboxFactory`

getShardingStrategy

public abstract IShardHelper getShardingStrategy ()

구성을 샤딩하는 방법을 정의하는 IShardHelper를 반환합니다.

반환 값
`IShardHelper`

getTestInvocationManagementSever

public abstract TestInvocationManagementServer getTestInvocationManagementSever ()

TestInvocationManagementServer를 반환하거나 정의되지 않은 경우 null을 반환합니다.

반환 값
`TestInvocationManagementServer`

getWtfHandler

public abstract ITerribleFailureHandler getWtfHandler ()

구성에서 사용할 ITerribleFailureHandler를 가져옵니다. WTF (What a Terrible Failure)가 발생할 경우 취할 조치를 처리합니다.

반환 값
`ITerribleFailureHandler`	구성에 제공된 `ITerribleFailureHandler` 또는 핸들러가 설정되지 않은 경우 null

injectOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionValue)

구성 객체 집합에 옵션 값을 삽입합니다.

동적으로 생성되는 옵션의 값을 제공하는 데 유용합니다.

매개변수
`optionName`	`String`: 옵션 이름
`optionValue`	`String`: 옵션 값

생성 값
`ConfigurationException`	옵션 값을 설정하지 못한 경우

injectOptionValue

public abstract void injectOptionValue (String optionName, 
                String optionKey, 
                String optionValue)

구성 객체 집합에 옵션 값을 삽입합니다.

동적으로 생성되는 옵션의 값을 제공하는 데 유용합니다.

매개변수
`optionName`	`String`: 지도 옵션 이름
`optionKey`	`String`: 지도 옵션 키
`optionValue`	`String`: 지도 옵션 값

생성 값
`ConfigurationException`	옵션 값을 설정하지 못한 경우

setCommandScheduler

public abstract void setCommandScheduler (ICommandScheduler scheduler)

ICommandScheduler를 설정하여 기존 값을 대체합니다.

setConfigurationFactory

public abstract void setConfigurationFactory (IConfigurationFactory configFactory)

이 구성의 IConfigurationFactory를 설정합니다.

매개변수
`configFactory`	`IConfigurationFactory`

setConfigurationObject

public abstract void setConfigurationObject (String name, 
                Object configObject)

지정된 이름으로 구성 객체를 설정하여 기존 값을 대체하는 일반 메서드입니다.

매개변수
`name`	`String`: 구성 객체 유형의 고유한 이름입니다.
`configObject`	`Object`: 구성 객체

생성 값
`ConfigurationException`	configObject가 올바른 유형이 아니면

setConfigurationObjectList

public abstract void setConfigurationObjectList (String typeName, 
                 configList)

지정된 이름의 구성 객체 목록을 설정하는 일반 메서드로, 기존 값을 대체합니다.

매개변수
`typeName`	`String`: 구성 객체 유형의 고유한 이름입니다.
`configList`	: 구성 객체 목록

생성 값
`ConfigurationException`	목록의 객체가 올바른 유형이 아닌 경우

setDeviceManagementServer

public abstract void setDeviceManagementServer (DeviceManagementGrpcServer server)

DeviceManagementGrpcServer를 설정합니다.

매개변수
`server`	`DeviceManagementGrpcServer`

setDeviceManager

public abstract void setDeviceManager (IDeviceManager deviceManager)

IDeviceManager를 설정하여 기존 값을 대체합니다. 이렇게 하면 테스트 기기의 관리자가 설정됩니다.

setDeviceMonitor

public abstract void setDeviceMonitor (IDeviceMonitor deviceMonitor)

IDeviceMonitor를 설정합니다.

매개변수
`deviceMonitor`	`IDeviceMonitor`: 모니터

생성 값
`ConfigurationException`	`IDeviceMonitor`가 이미 설정된 경우

setDeviceRequirements

public abstract void setDeviceRequirements (IDeviceSelection deviceSelection)

IDeviceSelection를 설정하여 기존 값을 대체합니다. 이렇게 하면 DeviceManager가 볼 수 있는 기기에 대한 전역 기기 필터가 설정됩니다.

setHostMonitors

public abstract void setHostMonitors ( hostMonitors)

IHostMonitor 목록을 설정합니다.

매개변수
`hostMonitors`	: 모니터 목록

생성 값
`ConfigurationException`	`IHostMonitor`가 이미 설정된 경우

setHostOptions

public abstract void setHostOptions (IHostOptions hostOptions)

IHostOptions를 설정하여 기존 값을 대체합니다.

setHostResourceManager

public abstract void setHostResourceManager (IHostResourceManager hostResourceManager)

IHostResourceManager를 설정하여 기존 값을 대체합니다.

setInvocationServer

public abstract void setInvocationServer (TestInvocationManagementServer server)

TestInvocationManagementServer를 설정합니다.

매개변수
`server`	`TestInvocationManagementServer`

setKeyStoreFactory

public abstract void setKeyStoreFactory (IKeyStoreFactory factory)

IKeyStoreFactory를 설정하여 기존 값을 대체합니다.

setOptionsFromCommandLineArgs

public abstract  setOptionsFromCommandLineArgs ( listArgs)

지정된 명령줄 인수 세트로 전역 구성 Option 필드 설정

예상 형식은 ArgsOptionParser를 참고하세요.

매개변수
`listArgs`	: 명령줄 인수

반환 값
	사용되지 않은 인수

생성 값
`ConfigurationException`

setOriginalConfig

public abstract void setOriginalConfig (String config)

전역 구성을 만드는 데 사용된 원래 구성을 설정합니다.

매개변수
`config`	`String`

setResourceMetricCollector

public abstract void setResourceMetricCollector (IResourceMetricCollector collector)

IResourceMetricCollector를 설정합니다.

매개변수
`collector`	`IResourceMetricCollector`

setSandboxFactory

public abstract void setSandboxFactory (ISandboxFactory factory)

ISandboxFactory를 설정하여 기존 값을 대체합니다.

setShardingStrategy

public abstract void setShardingStrategy (IShardHelper sharding)

구성을 샤딩할 때 사용할 IShardHelper를 설정합니다.

매개변수
`sharding`	`IShardHelper`

setTradefedFeatureServer

public abstract void setTradefedFeatureServer (TradefedFeatureServer server)

TradefedFeatureServer를 설정합니다.

매개변수
`server`	`TradefedFeatureServer`

setWtfHandler

public abstract void setWtfHandler (ITerribleFailureHandler wtfHandler)

ITerribleFailureHandler를 설정합니다.

매개변수
`wtfHandler`	`ITerribleFailureHandler`: WTF 핸들러

생성 값
`ConfigurationException`	`ITerribleFailureHandler`가 이미 설정된 경우

설정

public abstract void setup ()

Tradefed 시작 시 올바른 설정

생성 값
	com.android.tradefed.config.ConfigurationException
`ConfigurationException`

validateOptions

public abstract void validateOptions ()

옵션 값을 검증합니다.

현재는 모든 필수 옵션이 설정되었는지만 확인합니다.

생성 값
`ConfigurationException`	구성에 필수 입력란이 누락된 경우