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

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

ModuleDefinition

public class ModuleDefinition
extends Object implements ITestCollector

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

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

요약

필드
`public static final String`	`ISOLATION_COST`
`public static final String`	`MODULE_ABI`
`public static final String`	`MODULE_CACHED` 이 속성은 테스트 모듈 결과가 캐시된 경우 true로 설정됩니다.
`public static final String`	`MODULE_CONTROLLER`
`public static final String`	`MODULE_EXTERNAL_DEPENDENCIES`
`public static final String`	`MODULE_ID` 모듈 ID: testRunStart 중에 모듈을 고유하게 식별하는 데 사용되는 이름입니다.
`public static final String`	`MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY`
`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`	`MODULE_SKIPPED` 테스트 모듈이 건너뛴 경우 이 속성은 true로 설정됩니다.
`public static final String`	`MODULE_TEST_COUNT`
`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`	`SPARSE_MODULE` 모듈 수준 이벤트만 보고되는 경우 이 속성은 true로 설정됩니다.
`public static final String`	`TEAR_DOWN_TIME`
`public static final String`	`TEST_TIME`

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

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

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

필드

ISOLATION_COST

public static final String ISOLATION_COST

MODULE_ABI

public static final String MODULE_ABI

MODULE_CACHED

public static final String MODULE_CACHED

이 속성은 테스트 모듈 결과가 캐시된 경우 true로 설정됩니다.

MODULE_CONTROLLER

public static final String MODULE_CONTROLLER

MODULE_EXTERNAL_DEPENDENCIES

public static final String MODULE_EXTERNAL_DEPENDENCIES

MODULE_ID

public static final String MODULE_ID

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

MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

public static final String MODULE_INVOCATION_ATTRIBUTE_FLAG_OVERRIDES_KEY

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

MODULE_SKIPPED

public static final String MODULE_SKIPPED

테스트 모듈이 건너뛴 경우 이 속성은 true로 설정됩니다.

MODULE_TEST_COUNT

public static final String MODULE_TEST_COUNT

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

SPARSE_MODULE

public static final String SPARSE_MODULE

모듈 수준 이벤트만 보고되는 경우 이 속성은 true로 설정됩니다.

TEAR_DOWN_TIME

public static final String TEAR_DOWN_TIME

TEST_TIME

public static final String TEST_TIME

공개 생성자

ModuleDefinition

public ModuleDefinition ()

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`

getIntraModuleShardCount

public Integer getIntraModuleShardCount ()

반환 값
`Integer`

getIntraModuleShardIndex

public Integer getIntraModuleShardIndex ()

반환 값
`Integer`

getModuleConfiguration

public IConfiguration getModuleConfiguration ()

반환 값
`IConfiguration`

getModuleInvocationContext

public IInvocationContext getModuleInvocationContext ()

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

반환 값
`IInvocationContext`

getRequiredTokens

public  getRequiredTokens (TestInformation testInfo)

매개변수
`testInfo`	`TestInformation`

반환 값

getRuntimeHint

public long getRuntimeHint ()

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

반환 값
`long`

hasModuleFailed

public boolean hasModuleFailed ()

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

반환 값
`boolean`

neededDevices

public int neededDevices ()

이 테스트를 실행할 것으로 예상되는 기기 수를 반환합니다.

반환 값
`int`

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, 
                int maxRunLimit)

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

매개변수
`moduleInfo`	`TestInformation`: 모듈의 `TestInformation`입니다.
`listener`	`ITestInvocationListener`: 결과를 보고할 `ITestInvocationListener`입니다.
`maxRunLimit`	`int`: 각 테스트 사례의 최대 실행 횟수입니다.

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

실행

public final void run (TestInformation moduleInfo, 
                ITestInvocationListener listener)

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

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

생성 값
`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`

setIntraModuleInformation

public void setIntraModuleInformation (int shardCount, 
                int shardIndex)

매개변수
`shardCount`	`int`
`shardIndex`	`int`

setLogSaver

public void setLogSaver (ILogSaver logSaver)

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

매개변수
`logSaver`	`ILogSaver`

setMergeAttemps

public final void setMergeAttemps (boolean mergeAttempts)

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

매개변수
`mergeAttempts`	`boolean`

setMetricCollectors

public void setMetricCollectors ( collectors)

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

매개변수
`collectors`

setRecoverVirtualDevice

public void setRecoverVirtualDevice (boolean recoverVirtualDevice)

세트가 가상 기기를 복구해야 합니다.

매개변수
`recoverVirtualDevice`	`boolean`

setReportModuleEnd

public void setReportModuleEnd (boolean shouldReportModuleEnd)

매개변수
`shouldReportModuleEnd`	`boolean`

setReportModuleStart

public void setReportModuleStart (boolean shouldReportModuleStart)

매개변수
`shouldReportModuleStart`	`boolean`

setRetryDecision

public final void setRetryDecision (IRetryDecision decision)

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

매개변수
`decision`	`IRetryDecision`

setUseModuleResultsForwarder

public void setUseModuleResultsForwarder (boolean useModuleResultsForwarder)

매개변수
`useModuleResultsForwarder`	`boolean`

shouldRecoverVirtualDevice

public boolean shouldRecoverVirtualDevice ()

가상 기기를 복구해야 하는지 여부를 반환합니다.

반환 값
`boolean`

toString

public String toString ()

반환 값
`String`

transferSuiteLevelOptions

public void transferSuiteLevelOptions (IConfiguration mSuiteConfiguration)

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

매개변수
`mSuiteConfiguration`	`IConfiguration`

보호된 메서드

hasTests

protected boolean hasTests ()

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

반환 값
`boolean`