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

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

ConfigurationFactory

public class ConfigurationFactory
extends Object implements IConfigurationFactory

java.lang.Object
↳	com.android.tradefed.config.ConfigurationFactory

알려진 직접 서브클래스

GCSConfigurationFactory, RetryConfigurationFactory, SandboxConfigurationFactory

GCSConfigurationFactory	`ConfigurationFactory`는 Google Cloud Storage에서 구성을 로드합니다.
RetryConfigurationFactory	명령어 재시도를 처리하는 팩토리입니다.
SandboxConfigurationFactory	샌드박스 목적으로 구성 생성을 처리하는 특수 구성 팩토리입니다.

IConfiguration를 만들기 위한 팩토리입니다.

요약

중첩된 클래스
`class`	`ConfigurationFactory.ConfigLoader` 하나의 루트 구성에서 포함된 구성을 추적하고 순환 포함 시 예외를 발생시키는 IConfigDefLoader의 구현입니다.
`class`	`ConfigurationFactory.ExceptionLoader`

보호된 생성자
`ConfigurationFactory()`

공개 메서드
`void`	`clearMapConfig()` 경우에 따라 지도를 지워야 합니다.
`IConfiguration`	`createConfigurationFromArgs(String[] arrayArgs, unconsumedArgs)` 명령줄 인수에서 `IConfiguration`를 만듭니다.
`IConfiguration`	`createConfigurationFromArgs(String[] arrayArgs, unconsumedArgs, IKeyStoreClient keyStoreClient)` 키 저장소가 있는 명령줄 인수에서 `IConfiguration`를 만듭니다.
`IConfiguration`	`createConfigurationFromArgs(String[] arrayArgs)` `null` 두 번째 인수를 사용하여 `ERROR(/#createConfigurationFromArgs(String[],List))`를 호출하는 편의 메서드입니다.
`IGlobalConfiguration`	`createGlobalConfigurationFromArgs(String[] arrayArgs, remainingArgs)` 명령줄 인수에서 `IGlobalConfiguration`를 만듭니다.
`IConfiguration`	`createPartialConfigurationFromArgs(String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator)` 선택한 객체 집합만 포함하는 구성을 만듭니다.
`void`	`dumpConfig(String configName, PrintStream out)` 구성의 콘텐츠를 지정된 `ERROR(/PrintStream)`에 덤프합니다.
	`getConfigList(String subPath, boolean loadFromEnv)` 환경에서 구성을 로드할지 여부를 지정할 수 있는 `getConfigList()`의 변형입니다.
	`getConfigList()` 클래스 경로의 JAR에서 찾은 모든 구성의 이름 목록을 반환합니다.
`static IConfigurationFactory`	`getInstance()` 싱글톤 `IConfigurationFactory` 인스턴스를 가져옵니다.
`void`	`loadAllConfigs(boolean discardExceptions)` 클래스 경로 및 테스트 사례 디렉터리에 있는 모든 구성을 로드합니다.
`void`	`loadAndPrintAllConfigs()` 모든 구성을 로드, 파싱하고 모든 옵션 값을 설정할 수 있는지 확인하는 유틸리티 메서드입니다.
`void`	`printHelp(PrintStream out)` 이 팩토리의 도움말 출력을 출력합니다.
`void`	`printHelpForConfig(String[] args, boolean importantOnly, PrintStream out)` 명령줄 인수에 지정된 `IConfiguration`의 도움말 출력을 출력합니다. 'args'가 알려진 구성을 참조하는 경우 XML에서 `IConfiguration` 객체가 생성되고 해당 `IConfiguration`에 관한 도움말이 출력됩니다.

보호된 메서드
`InputStream`	`getBundledConfigStream(String name)`
`String`	`getConfigPrefix()` 클래스 경로에서 구성 XML 파일의 경로 접두사를 반환합니다. 단위 테스트에서 모의 처리할 수 있도록 노출됩니다.
`BufferedInputStream`	`getConfigStream(String name)` 지정된 구성 이름의 InputStream을 로드합니다.
`ConfigurationDef`	`getConfigurationDef(String name, boolean isGlobal, templateMap)` 지정된 이름의 `ConfigurationDef` 가져오기
	`getMapConfig()` 테스트를 위해 노출됩니다.
`boolean`	`isDirectConfiguration(String configName)`
`String[]`	`reorderArgs(String[] args)` template:map 인수가 모두 앞에 오도록 인수를 재정렬합니다.
`IRemoteFileResolver.ResolvedFile`	`resolveRemoteFile(URI configURI, URI destDir)`

보호된 생성자

ConfigurationFactory

protected ConfigurationFactory ()

공개 메서드

clearMapConfig

public void clearMapConfig ()

경우에 따라 지도를 지워야 합니다.

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs)

명령줄 인수에서 IConfiguration를 만듭니다.

예상 형식은 'CONFIG [options]'이며 여기서 CONFIG는 내장 구성 이름 또는 구성 XML 파일의 파일 경로입니다.

매개변수
`arrayArgs`	`String`: 명령줄 인수
`unconsumedArgs`	: 지정된 구성과 연결된 객체에서 사용되지 않은 인수로 채워지는 목록입니다. 이 값이 `null`이면 처리되지 않은 인수가 남아 있으면 구현에서 `ConfigurationException`을 발생시킵니다.

반환 값
`IConfiguration`	로드된 `IConfiguration` 대리인 객체 `Option` 필드가 args의 값으로 채워졌습니다.

생성 값
`ConfigurationException`

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs, 
                IKeyStoreClient keyStoreClient)

키 저장소가 있는 명령줄 인수에서 IConfiguration를 만듭니다.

예상 형식은 'CONFIG [options]'이며 여기서 CONFIG는 내장 구성 이름 또는 구성 XML 파일의 파일 경로입니다.

매개변수
`arrayArgs`	`String`: 명령줄 인수
`unconsumedArgs`	: 지정된 구성과 연결된 객체에서 사용되지 않은 인수로 채워지는 목록입니다. 이 값이 `null`이면 처리되지 않은 인수가 남아 있으면 구현에서 `ConfigurationException`을 발생시킵니다.
`keyStoreClient`	`IKeyStoreClient`: args에서 민감한 정보를 가져오는 데 사용되는 `IKeyStoreClient`입니다.

반환 값
`IConfiguration`	로드된 `IConfiguration` 대리인 객체 `Option` 필드가 args의 값으로 채워졌습니다.

생성 값
`ConfigurationException`

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

null 두 번째 인수를 사용하여 ERROR(/#createConfigurationFromArgs(String[],List))를 호출하는 편의 메서드입니다. 따라서 사용되지 않은 인수가 남아 있으면 ConfigurationException이 발생합니다.

매개변수
`arrayArgs`	`String`

반환 값
`IConfiguration`

생성 값
`ConfigurationException`

createGlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                 remainingArgs)

명령줄 인수에서 IGlobalConfiguration를 만듭니다.

예상 형식은 'CONFIG [options]'이며 여기서 CONFIG는 내장 구성 이름 또는 구성 XML 파일의 파일 경로입니다.

매개변수
`arrayArgs`	`String`: 명령줄 인수
`remainingArgs`	: 전역 인수로 처리되지 않은 인수로 채워지는 목록

반환 값
`IGlobalConfiguration`	로드된 `IGlobalConfiguration` 대리인 객체 `Option` 필드가 args의 값으로 채워졌습니다.

생성 값
`ConfigurationException`

createPartialConfigurationFromArgs

public IConfiguration createPartialConfigurationFromArgs (String[] arrayArgs, 
                IKeyStoreClient keyStoreClient, 
                 allowedObjects, 
                TradefedDelegator delegator)

선택한 객체 집합만 포함하는 구성을 만듭니다.

매개변수
`arrayArgs`	`String`: 명령줄 인수
`keyStoreClient`	`IKeyStoreClient`: 인수에서 민감한 정보를 가져오는 데 사용되는 `IKeyStoreClient`입니다.
`allowedObjects`	: 생성할 수 있는 허용된 객체 집합입니다.
`delegator`	`TradefedDelegator`

반환 값
`IConfiguration`	로드된 `IConfiguration`입니다.

생성 값
`ConfigurationException`

dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

구성의 콘텐츠를 지정된 ERROR(/PrintStream)에 덤프합니다.

매개변수
`configName`	`String`: 구성 이름
`out`	`PrintStream`: 출력을 덤프할 `ERROR(/PrintStream)`입니다.

getConfigList

public  getConfigList (String subPath, 
                boolean loadFromEnv)

환경에서 구성을 로드할지 여부를 지정할 수 있는 getConfigList()의 변형입니다.

매개변수
`subPath`	`String`: 구성을 확인할 하위 디렉터리의 이름입니다. null인 경우 `getConfigList()`와 동일하게 작동합니다.
`loadFromEnv`	`boolean`: 환경 변수에 구성을 로드해야 하는 경우 true입니다.

반환 값

getConfigList

public  getConfigList ()

클래스 경로의 JAR에서 찾은 모든 구성의 이름 목록을 반환합니다. 구성을 로드하려고 시도하지 않으므로 이 목록에 작동하지 않는 구성이 있을 수 있습니다.

반환 값

getInstance

public static IConfigurationFactory getInstance ()

싱글톤 IConfigurationFactory 인스턴스를 가져옵니다.

반환 값
`IConfigurationFactory`

loadAllConfigs

public void loadAllConfigs (boolean discardExceptions)

클래스 경로 및 테스트 사례 디렉터리에 있는 모든 구성을 로드합니다.

매개변수
`discardExceptions`	`boolean`: ConfigurationException을 무시해야 하는 경우 true입니다.

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

loadAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

모든 구성을 로드, 파싱하고 모든 옵션 값을 설정할 수 있는지 확인하는 유틸리티 메서드입니다. 종속 프로젝트에서 구성을 검증할 수 있도록 노출됩니다. 콘솔에 노출되어서는 안 됩니다.

생성 값
`ConfigurationException`	하나 이상의 구성을 로드할 수 없는 경우

printHelp

public void printHelp (PrintStream out)

이 팩토리의 도움말 출력을 출력합니다.

일반 도움말 정보를 출력하고 사용 가능한 모든 구성을 나열합니다.

매개변수
`out`	`PrintStream`: 출력을 덤프할 `ERROR(/PrintStream)`입니다.

printHelpForConfig

public void printHelpForConfig (String[] args, 
                boolean importantOnly, 
                PrintStream out)

명령줄 인수에 지정된 IConfiguration의 도움말 출력을 출력합니다.

'args'가 알려진 구성을 참조하는 경우 XML에서 IConfiguration 객체가 생성되고 해당 IConfiguration에 관한 도움말이 출력됩니다. 다른 모든 'args' 값은 무시됩니다. 즉, 도움말 텍스트는 XML에서 로드된 Option의 현재 값을 설명하며 명령줄 args로 설정된 옵션 값을 반영하지 않습니다.

'args'가 알려진 IConfiguration를 참조하지 않으면 일반 printHelp(PrintStream) 도움말이 표시됩니다.

매개변수
`args`	`String`: 명령줄 인수
`importantOnly`	`boolean`: `true`인 경우 중요한 세부정보만 나열된 축약된 도움말을 출력합니다.
`out`	`PrintStream`: 출력을 덤프할 `ERROR(/PrintStream)`입니다.

보호된 메서드

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

매개변수
`name`	`String`

반환 값
`InputStream`

getConfigPrefix

protected String getConfigPrefix ()

클래스 경로에서 구성 XML 파일의 경로 접두사를 반환합니다.

단위 테스트에서 모의 처리할 수 있도록 노출됩니다.

반환 값
`String`	후행 /가 있는 `String` 경로

getConfigStream

protected BufferedInputStream getConfigStream (String name)

지정된 구성 이름의 InputStream을 로드합니다.

매개변수
`name`	`String`: 로드할 구성 이름

반환 값
`BufferedInputStream`	구성 콘텐츠를 읽기 위한 `ERROR(/BufferedInputStream)`

생성 값
`ConfigurationException`	구성을 찾을 수 없는 경우

getConfigurationDef

protected ConfigurationDef getConfigurationDef (String name, 
                boolean isGlobal, 
                 templateMap)

지정된 이름의 ConfigurationDef 가져오기

매개변수
`name`	`String`: 로드할 내장 구성의 이름 또는 로드할 구성 파일의 파일 경로입니다.
`isGlobal`	`boolean`
`templateMap`

반환 값
`ConfigurationDef`	`ConfigurationDef`

생성 값
`ConfigurationException`	구성을 로드하는 중에 오류가 발생한 경우

getMapConfig

protected  getMapConfig ()

테스트를 위해 노출됩니다. 지도의 사본을 반환합니다.

반환 값

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

매개변수
`configName`	`String`

반환 값
`boolean`

reorderArgs

protected String[] reorderArgs (String[] args)

template:map 인수가 모두 앞에 오도록 인수를 재정렬합니다.

매개변수
`args`	`String`

반환 값
`String[]`

resolveRemoteFile

protected IRemoteFileResolver.ResolvedFile resolveRemoteFile (URI configURI, 
                URI destDir)

매개변수
`configURI`	`URI`
`destDir`	`URI`

반환 값
`IRemoteFileResolver.ResolvedFile`

생성 값
`BuildRetrievalError`

ConfigurationFactory

요약

중첩된 클래스

보호된 생성자

공개 메서드

보호된 메서드

보호된 생성자

ConfigurationFactory

공개 메서드

clearMapConfig

createConfigurationFromArgs

createConfigurationFromArgs

createConfigurationFromArgs

createGlobalConfigurationFromArgs

createPartialConfigurationFromArgs

dumpConfig

getConfigList

getConfigList

getInstance

loadAllConfigs

loadAndPrintAllConfigs

printHelp

printHelpForConfig

보호된 메서드

getBundledConfigStream

getConfigPrefix

getConfigStream

getConfigurationDef

getMapConfig

isDirectConfiguration

reorderArgs

resolveRemoteFile