2026년부터 트렁크 안정 개발 모델과 일치하고 생태계의 플랫폼 안정성을 보장하기 위해 2분기와 4분기에 AOSP에 소스 코드를 게시합니다. AOSP를 빌드하고 기여하려면 android-latest-release를 사용하세요. android-latest-release 매니페스트 브랜치는 항상 AOSP에 푸시된 최신 버전을 참조합니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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, List<String> unconsumedArgs, IKeyStoreClient keyStoreClient)` 키 저장소와 함께 명령줄 인수에서 `IConfiguration`를 만듭니다.
`IConfiguration`	`createConfigurationFromArgs(String[] arrayArgs, List<String> unconsumedArgs)` 명령줄 인수에서 `IConfiguration`를 만듭니다.
`IConfiguration`	`createConfigurationFromArgs(String[] arrayArgs)` `null` 두 번째 인수로 `createConfigurationFromArgs(String[],List)`를 호출하는 편의 메서드입니다.
`IGlobalConfiguration`	`createGlobalConfigurationFromArgs(String[] arrayArgs, List<String> remainingArgs)` 명령줄 인수에서 `IGlobalConfiguration`을 만듭니다.
`IConfiguration`	`createPartialConfigurationFromArgs(String[] arrayArgs, IKeyStoreClient keyStoreClient, Set<String> allowedObjects, TradefedDelegator delegator)` 선택한 객체 집합만 포함하는 구성을 만듭니다.
`void`	`dumpConfig(String configName, PrintStream out)` 구성의 콘텐츠를 지정된 `PrintStream`에 덤프합니다.
`List<String>`	`getConfigList(String subPath, boolean loadFromEnv)` 환경에서 구성을 로드할지 여부를 지정할 수 있는 `getConfigList()`의 변형입니다.
`List<String>`	`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'가 알려진 구성을 참조하는 경우 `IConfiguration` 객체가 XML에서 생성되고 해당 `IConfiguration`에 대한 도움말이 출력됩니다.

보호된 메서드
`InputStream`	`getBundledConfigStream(String name)`
`String`	`getConfigPrefix()` 클래스 경로에 있는 구성 xml 파일의 경로 접두사를 반환합니다. 단위 테스트에서 모의할 수 있도록 노출됩니다.
`BufferedInputStream`	`getConfigStream(String name)` 지정된 구성 이름의 InputStream을 로드합니다.
`ConfigurationDef`	`getConfigurationDef(String name, boolean isGlobal, Map<String, String> templateMap)` 지정된 이름의 `ConfigurationDef` 가져오기
`Map<ConfigurationFactory.ConfigId, ConfigurationDef>`	`getMapConfig()` 테스트를 위해 노출됩니다.
`boolean`	`isDirectConfiguration(String configName)`
`String[]`	`reorderArgs(String[] args)` 템플릿:map 인수가 모두 앞으로 이동되도록 인수의 순서를 바꿉니다.
`IRemoteFileResolver.ResolvedFile`	`resolveRemoteFile(URI configURI, URI destDir)`

보호된 생성자

ConfigurationFactory

protected ConfigurationFactory ()

공개 메서드

clearMapConfig

public void clearMapConfig ()

특정 경우에는 지도를 지워야 합니다.

createConfigurationFromArgs

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

키 저장소와 함께 명령줄 인수에서 IConfiguration를 만듭니다.

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

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

반환
`IConfiguration`	로드된 `IConfiguration`입니다. 위임 객체 `Option` 필드가 args의 값으로 채워졌습니다.

생성 값
`ConfigurationException`

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                List<String> unconsumedArgs)

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

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

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

반환
`IConfiguration`	로드된 `IConfiguration`입니다. 위임 객체 `Option` 필드가 args의 값으로 채워졌습니다.

생성 값
`ConfigurationException`

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

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

매개변수
`arrayArgs`	`String`

반환
`IConfiguration`

생성 값
`ConfigurationException`

createGlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                List<String> remainingArgs)

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

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

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

반환
`IGlobalConfiguration`	로드된 `IGlobalConfiguration`입니다. 위임 객체 `Option` 필드가 args의 값으로 채워졌습니다.

생성 값
`ConfigurationException`

createPartialConfigurationFromArgs

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

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

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

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

생성 값
`ConfigurationException`

dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

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

매개변수
`configName`	`String`: 구성 이름
`out`	`PrintStream`: 출력을 덤프할 `PrintStream`

getConfigList

public List<String> getConfigList (String subPath, 
                boolean loadFromEnv)

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

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

반환
`List<String>`

getConfigList

public List<String> getConfigList ()

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

반환
`List<String>`

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`: 출력을 덤프할 `PrintStream`

printHelpForConfig

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

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

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

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

매개변수
`args`	`String`: 명령줄 인수
`importantOnly`	`boolean`: `true`인 경우 중요한 세부정보만 나열하는 간략한 도움말을 출력합니다.
`out`	`PrintStream`: 출력을 덤프할 `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`	구성 콘텐츠를 읽기 위한 `BufferedInputStream`

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

getConfigurationDef

protected ConfigurationDef getConfigurationDef (String name, 
                boolean isGlobal, 
                Map<String, String> templateMap)

지정된 이름의 ConfigurationDef 가져오기

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

반환
`ConfigurationDef`	`ConfigurationDef`

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

getMapConfig

protected Map<ConfigurationFactory.ConfigId, ConfigurationDef> getMapConfig ()

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

반환
`Map<ConfigurationFactory.ConfigId, ConfigurationDef>`

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

매개변수
`configName`	`String`

반환
`boolean`

reorderArgs

protected String[] reorderArgs (String[] args)

템플릿: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