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

ModuleDefinition

public class ModuleDefinition
extends Object implements ITestCollector

java.lang.Object
↳	com.android.tradefed.testtype.suite.ModuleDefinition

테스트 실행 구성의 컨테이너입니다. 이 클래스는 테스트를 준비하고 실행하는 도우미입니다.

요약

필드
`public static final String`	`MODULE_ABI`
`public static final String`	`MODULE_CONTROLLER`
`public static final String`	`MODULE_ID` 모듈 ID: testRunStart 중에 모듈을 고유하게 식별하는 데 사용되는 이름입니다.
`public static final String`	`MODULE_ISOLATED` 이 속성은 모듈이 새로 준비된 기기에서 실행된 경우 true로 설정됩니다.
`public static final String`	`MODULE_NAME` 모듈 이름은 모듈과 연결된 기본 이름으로, 일반적으로 모듈이 로드된 Xml TF 구성 파일에서 가져옵니다.
`public static final String`	`MODULE_PARAMETERIZATION`
`public static final String`	`PREPARATION_TIME`
`public static final String`	`RETRY_FAIL_COUNT`
`public static final String`	`RETRY_SUCCESS_COUNT`
`public static final String`	`RETRY_TIME`
`public static final String`	`TEAR_DOWN_TIME`
`public static final String`	`TEST_TIME`

공개 생성자
`ModuleDefinition(String name, tests, preparersPerDevice, multiPreparers, IConfiguration moduleConfig)` 생성자
`ModuleDefinition(String name, tests, preparersPerDevice, suitePreparersPerDevice, multiPreparers, IConfiguration moduleConfig)` 생성자

공개 메서드
`int`	`compareTo(ModuleDefinition moduleDef)`
`String`	`getId()` 고유한 모듈 이름을 반환합니다.
`IInvocationContext`	`getModuleInvocationContext()` 모듈과 연결된 `IInvocationContext`를 반환합니다.
	`getRequiredTokens()`
`long`	`getRuntimeHint()` 모듈의 모든 테스트를 실행하는 데 걸리는 대략적인 시간을 반환합니다.
`boolean`	`hasModuleFailed()` 모듈에서 testRunFailure이 호출된 경우 True를 반환합니다.
`int`	`numTests()` 실행 대기 중인 현재 `IRemoteTest` 수를 반환합니다.
`final void`	`reportNotExecuted(ITestInvocationListener listener, String message)` 완전히 실행되지 않은 모듈을 보고합니다.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener)` 모듈에 포함된 모든 `IRemoteTest`를 실행하고 그 전후에 모든 준비자를 사용하여 기기를 설정하고 정리합니다.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener)` 모듈에 포함된 모든 `IRemoteTest`를 실행하고 그 전후에 모든 준비자를 사용하여 기기를 설정하고 정리합니다.
`final void`	`run(TestInformation moduleInfo, ITestInvocationListener listener, moduleLevelListeners, TestFailureListener failureListener, int maxRunLimit)` 모듈에 포함된 모든 `IRemoteTest`를 실행하고 그 전후에 모든 준비자를 사용하여 기기를 설정하고 정리합니다.
`Throwable`	`runPreparation(boolean includeSuitePreparers)` 지정된 경우 모음 수준 준비자를 포함하여 테스트의 준비자를 실행합니다.
`void`	`setBuild(IBuildInfo build)` 테스트 중에 사용할 `IBuildInfo`를 삽입합니다.
`void`	`setCollectTestsOnly(boolean collectTestsOnly)` 테스트 수집 모드를 사용 설정 또는 사용 중지합니다.
`void`	`setDevice(ITestDevice device)` 테스트 중에 사용할 `ITestDevice`를 삽입합니다.
`void`	`setEnableDynamicDownload(boolean enableDynamicDownload)` 모듈 수준에서 동적 다운로드를 사용 설정할지 여부입니다.
`void`	`setLogSaver(ILogSaver logSaver)` 필요한 경우 모듈에서 사용할 수 있도록 호출 로그 저장기를 모듈에 전달합니다.
`final void`	`setMergeAttemps(boolean mergeAttempts)` 결과를 병합할지 여부를 설정합니다.
`void`	`setMetricCollectors( collectors)` 모듈에서 사용할 `IMetricCollector` 목록을 삽입합니다.
`final void`	`setRetryDecision(IRetryDecision decision)` 모듈 내 재시도에 사용할 `IRetryDecision`를 설정합니다.
`String`	`toString()`
`void`	`transferSuiteLevelOptions(IConfiguration mSuiteConfiguration)` 몇 가지 스위트 수준 구성 복사

보호된 메서드
`boolean`	`hasTests()` 모듈에 풀에서 실행할 `IRemoteTest`가 아직 있는 경우 true를 반환합니다.

필드

MODULE_ABI

public static final String MODULE_ABI

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

MODULE_ID

public static final String MODULE_ID

모듈 ID: testRunStart 중에 모듈을 고유하게 식별하는 데 사용되는 이름입니다. 일반적으로 MODULE_ABI + MODULE_NAME의 조합입니다.

MODULE_ISOLATED

public static final String MODULE_ISOLATED

이 속성은 모듈이 새로 준비된 기기에서 실행된 경우 true로 설정됩니다.

MODULE_NAME

public static final String MODULE_NAME

모듈 이름은 모듈과 연결된 기본 이름으로, 일반적으로 모듈이 로드된 Xml TF 구성 파일에서 가져옵니다.

MODULE_PARAMETERIZATION

public static final String MODULE_PARAMETERIZATION

PREPARATION_TIME

public static final String PREPARATION_TIME

RETRY_FAIL_COUNT

public static final String RETRY_FAIL_COUNT

RETRY_SUCCESS_COUNT

public static final String RETRY_SUCCESS_COUNT

RETRY_TIME

public static final String RETRY_TIME

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEST_TIME

public static final String TEST_TIME

공개 생성자

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

생성자

매개변수
`name`	`String`: 테스트 구성의 고유한 이름입니다.
`tests`	: 실행해야 하는 `IRemoteTest` 목록입니다.
`preparersPerDevice`	: 기기 설정에 사용할 `ITargetPreparer` 목록입니다.
`multiPreparers`
`moduleConfig`	`IConfiguration`: 기본 모듈 구성의 `IConfiguration`입니다.

ModuleDefinition

public ModuleDefinition (String name, 
                 tests, 
                 preparersPerDevice, 
                 suitePreparersPerDevice, 
                 multiPreparers, 
                IConfiguration moduleConfig)

생성자

매개변수
`name`	`String`: 테스트 구성의 고유한 이름입니다.
`tests`	: 실행해야 하는 `IRemoteTest` 목록입니다.
`preparersPerDevice`	: 기기 설정에 사용할 `ITargetPreparer` 목록입니다.
`suitePreparersPerDevice`
`multiPreparers`
`moduleConfig`	`IConfiguration`: 기본 모듈 구성의 `IConfiguration`입니다.

공개 메서드

compareTo

public int compareTo (ModuleDefinition moduleDef)

매개변수
`moduleDef`	`ModuleDefinition`

반환 값
`int`

getId

public String getId ()

고유한 모듈 이름을 반환합니다.

반환 값
`String`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

모듈과 연결된 IInvocationContext를 반환합니다.

반환 값
`IInvocationContext`

getRequiredTokens

public  getRequiredTokens ()

반환 값

getRuntimeHint

public long getRuntimeHint ()

모듈의 모든 테스트를 실행하는 데 걸리는 대략적인 시간을 반환합니다.

반환 값
`long`

hasModuleFailed

public boolean hasModuleFailed ()

모듈에서 testRunFailure이 호출된 경우 True를 반환합니다.

반환 값
`boolean`

numTests

public int numTests ()

실행 대기 중인 현재 IRemoteTest 수를 반환합니다.

반환 값
`int`

reportNotExecuted

public final void reportNotExecuted (ITestInvocationListener listener, 
                String message)

완전히 실행되지 않은 모듈을 보고합니다.

매개변수
`listener`	`ITestInvocationListener`
`message`	`String`

실행

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners, 
                TestFailureListener failureListener)

모듈에 포함된 모든 IRemoteTest를 실행하고 그 전후에 모든 준비자를 사용하여 기기를 설정하고 정리합니다.

매개변수
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`: 결과를 보고할 `ITestInvocationListener`입니다.
`moduleLevelListeners`	: 모듈 수준의 리스너 목록입니다.
`failureListener`	`TestFailureListener`: testFail에서 로그를 수집하는 특정 리스너입니다. null일 수 있습니다.

생성 값
`DeviceNotAvailableException`	기기가 오프라인 상태가 되는 경우

실행

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

모듈에 포함된 모든 IRemoteTest를 실행하고 그 전후에 모든 준비자를 사용하여 기기를 설정하고 정리합니다.

매개변수
`moduleInfo`	`TestInformation`
`listener`	`ITestInvocationListener`: 결과를 보고할 `ITestInvocationListener`입니다.

생성 값
`DeviceNotAvailableException`	기기가 오프라인 상태가 되는 경우

실행

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener, 
                 moduleLevelListeners, 
                TestFailureListener failureListener, 
                int maxRunLimit)

모듈에 포함된 모든 IRemoteTest를 실행하고 그 전후에 모든 준비자를 사용하여 기기를 설정하고 정리합니다.

매개변수
`moduleInfo`	`TestInformation`: 모듈의 `TestInformation`입니다.
`listener`	`ITestInvocationListener`: 결과를 보고할 `ITestInvocationListener`입니다.
`moduleLevelListeners`	: 모듈 수준의 리스너 목록입니다.
`failureListener`	`TestFailureListener`: testFail에서 로그를 수집하는 특정 리스너입니다. null일 수 있습니다.
`maxRunLimit`	`int`: 각 테스트 사례의 최대 실행 횟수입니다.

생성 값
`DeviceNotAvailableException`	기기가 오프라인 상태가 되는 경우

runPreparation

public Throwable runPreparation (boolean includeSuitePreparers)

지정된 경우 모음 수준 준비자를 포함하여 테스트의 준비자를 실행합니다.

매개변수
`includeSuitePreparers`	`boolean`: 모음 수준 준비 도구도 실행하도록 `true`로 설정합니다.

반환 값
`Throwable`	준비 도구를 실행할 때 발생한 예외의 `Throwable`

setBuild

public void setBuild (IBuildInfo build)

테스트 중에 사용할 IBuildInfo를 삽입합니다.

매개변수
`build`	`IBuildInfo`

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

테스트 수집 모드를 사용 설정 또는 사용 중지합니다.

setDevice

public void setDevice (ITestDevice device)

테스트 중에 사용할 ITestDevice를 삽입합니다.

매개변수
`device`	`ITestDevice`

setEnableDynamicDownload

public void setEnableDynamicDownload (boolean enableDynamicDownload)

모듈 수준에서 동적 다운로드를 사용 설정할지 여부입니다.

매개변수
`enableDynamicDownload`	`boolean`

setLogSaver

public void setLogSaver (ILogSaver logSaver)

필요한 경우 모듈에서 사용할 수 있도록 호출 로그 저장기를 모듈에 전달합니다.

매개변수
`logSaver`	`ILogSaver`

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

결과를 병합할지 여부를 설정합니다.

매개변수
`mergeAttempts`	`boolean`

setMetricCollectors

public void setMetricCollectors ( collectors)

모듈에서 사용할 IMetricCollector 목록을 삽입합니다.

매개변수
`collectors`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

모듈 내 재시도에 사용할 IRetryDecision를 설정합니다.

매개변수
`decision`	`IRetryDecision`

toString

public String toString ()

반환 값
`String`

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

몇 가지 스위트 수준 구성 복사

매개변수
`mSuiteConfiguration`	`IConfiguration`

보호된 메서드

hasTests

protected boolean hasTests ()

모듈에 풀에서 실행할 IRemoteTest가 아직 있는 경우 true를 반환합니다. 그렇지 않으면 false입니다.

반환 값
`boolean`