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

GTestBase

public abstract class GTestBase
extends Object implements IAbiReceiver, IConfigurationReceiver, IRemoteTest, IRuntimeHintProvider, IShardableTest, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.GTestBase

알려진 직접 서브클래스

GTest, HostGTest

GTest	주어진 기기에서 네이티브 테스트 패키지를 실행하는 테스트입니다.
HostGTest	네이티브 테스트 패키지를 실행하는 테스트입니다.

알려진 간접 하위 클래스

ArtGTest

gTest의 기본 클래스

요약

상수
`String`	`FILTER_EXTENSION`
`String`	`GTEST_FLAG_FILE`
`String`	`GTEST_FLAG_FILTER`
`String`	`GTEST_FLAG_LIST_TESTS`
`String`	`GTEST_FLAG_PRINT_TIME`
`String`	`GTEST_FLAG_RUN_DISABLED_TESTS`
`String`	`GTEST_XML_OUTPUT`

공개 생성자
`GTestBase()`

공개 메서드
`void`	`addAllExcludeFilters( filters)` 제외할 테스트의 필터 `ERROR(/Set)`를 추가합니다.
`void`	`addAllIncludeFilters( filters)` 포함할 테스트의 필터 `ERROR(/Set)`를 추가합니다.
`void`	`addExcludeFilter(String filter)` 제외할 테스트의 필터를 추가합니다.
`void`	`addIncludeFilter(String filter)` 포함할 테스트의 필터를 추가합니다.
`String`	`cleanFilter(String filter)`
`void`	`clearExcludeFilters()` 현재 추적 중인 모든 제외 필터를 삭제합니다.
`void`	`clearIncludeFilters()` 현재 추적 중인 모든 포함 필터를 삭제합니다.
`IAbi`	`getAbi()`
	`getAfterTestCmd()` GTest 후에 실행할 셸 명령어를 가져옵니다.
	`getBeforeTestCmd()` GTest 전에 실행할 셸 명령어를 가져옵니다.
	`getExcludeFilters()` 현재 제외 필터의 `ERROR(/Set)`를 반환합니다.
	`getFileExclusionFilterRegex()` 실행에서 특정 파일을 제외하는 정규식을 가져옵니다.
	`getGTestFlags()` 네이티브 테스트의 셸 명령어에 전달할 추가 플래그 값을 가져옵니다.
	`getIncludeFilters()` 포함 필터의 현재 `ERROR(/Set)`를 반환합니다.
`long`	`getMaxTestTimeMs()` gtest가 실행되는 최대 시간을 가져옵니다.
`String`	`getModuleName()` 실행할 Android 네이티브 테스트 모듈을 가져옵니다.
`boolean`	`getRunDisabledTests()` GTest가 사용 중지된 테스트를 실행해야 하는지 여부를 가져옵니다.
`long`	`getRuntimeHint()` 테스트의 예상 실행 시간을 밀리초 단위로 반환합니다.
`int`	`getShardCount()` 현재 샤드 수를 반환합니다.
`int`	`getShardIndex()` 이 테스트의 샤드 색인을 가져옵니다.
`String`	`getTestFilterKey()` 테스트 필터 키를 가져옵니다.
`String`	`getTestModule()` 모듈 이름을 가져옵니다.
`boolean`	`isCollectTestsOnly()` 관련 테스트 사례 목록을 수집하기 위해 테스트 바이너리를 호출하는지 여부만 가져옵니다.
`boolean`	`isEnableXmlOutput()` 테스트 결과에 gtest xml 출력을 사용할지 여부를 가져옵니다.
`boolean`	`isSharded()` isSharded 플래그를 가져옵니다.
`void`	`notifyTestExecution(boolean incompleteTestFound, failedTests)` 재시도 시 포함/제외 필터를 올바르게 처리할 수 있도록 테스트 실행을 부모에게 알립니다.
`void`	`setAbi(IAbi abi)`
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` 테스트 수집 모드를 사용 설정 또는 사용 중지합니다.
`void`	`setConfiguration(IConfiguration configuration)` 사용 중인 `IConfiguration`를 삽입합니다.
`void`	`setModuleName(String moduleName)` 실행할 Android 네이티브 테스트 모듈을 설정합니다.
`void`	`setShardCount(int shardCount)` 이 테스트의 샤드 수를 설정합니다.
`void`	`setShardIndex(int shardIndex)` 이 테스트의 샤드 색인을 설정합니다.
	`split(int shardCountHint)` 실행을 시도한 shardCount도 제공하는 `split()`의 대체 버전입니다.

보호된 메서드
`String`	`convertName(String gtestFlagName)`
`String`	`createFlagFile(String filter)` 인수 크기의 OS 제한을 방지하기 위해 --gtest_flagfile을 통해 사용될 필터가 포함된 파일을 만듭니다.
`void`	`erasePrependedFileName( filters, String filename)`
`String`	`getAllGTestFlags(String path)` adb 셸 명령어에 전달할 모든 GTest 플래그를 가져오는 도우미
`IConfiguration`	`getConfiguration()` 테스트 구성을 반환합니다.
`String`	`getExceptionMessage(Exception e)` 주어진 `Exception`에 대해 의미 있는 짧은 설명 메시지를 가져오기 위해 최선을 다합니다.
`String`	`getGTestCmdLine(String fullPath, String flags)` 실행할 gtest 명령어를 빌드하는 도우미 메서드
`String`	`getGTestCmdLineWrapper(String fullPath, String flags)` 파생 클래스가 다른 도구 (chroot, strace, gdb 등) 아래에서 gtest 명령어를 래핑할 수 있도록 지원하는 도우미입니다.
`String`	`getGTestFilters(String path)` 실행할 테스트의 g-test 필터를 가져오는 도우미
`ITestInvocationListener`	`getGTestListener(ITestInvocationListener... listeners)` mDisabledDuplicateCheck가 false인 경우 중복 테스트를 감지하고 보고하는 등 추가 디버깅 정보를 제공하는 GTestListener를 반환합니다.
`abstract String`	`loadFilter(String path)` 필터 가져오기 메서드를 정의합니다.
`void`	`setRunDisabled(boolean runDisabled)` GTest에서 사용 중지된 테스트를 실행할지 여부를 설정합니다.

상수

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

상수 값: '.filter'

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

상수 값: "--gtest_flagfile"

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

상수 값: "--gtest_filter"

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

상수 값: "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

상수 값: '--gtest_print_time'

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

상수 값: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

상수 값: "--gtest_output=xml:%s"

공개 생성자

GTestBase

public GTestBase ()

공개 메서드

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

제외할 테스트의 필터 ERROR(/Set)를 추가합니다.

매개변수
`filters`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

포함할 테스트의 필터 ERROR(/Set)를 추가합니다.

매개변수
`filters`

addExcludeFilter

public void addExcludeFilter (String filter)

제외할 테스트의 필터를 추가합니다.

매개변수
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

포함할 테스트의 필터를 추가합니다.

매개변수
`filter`	`String`

cleanFilter

public String cleanFilter (String filter)

매개변수
`filter`	`String`

반환 값
`String`

clearExcludeFilters

public void clearExcludeFilters ()

현재 추적 중인 모든 제외 필터를 삭제합니다.

clearIncludeFilters

public void clearIncludeFilters ()

현재 추적 중인 모든 포함 필터를 삭제합니다.

getAbi

public IAbi getAbi ()

반환 값
`IAbi`

getAfterTestCmd

public  getAfterTestCmd ()

GTest 후에 실행할 셸 명령어를 가져옵니다.

반환 값

getBeforeTestCmd

public  getBeforeTestCmd ()

GTest 전에 실행할 셸 명령어를 가져옵니다.

반환 값

getExcludeFilters

public  getExcludeFilters ()

현재 제외 필터의 ERROR(/Set)를 반환합니다.

반환 값

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

실행에서 특정 파일을 제외하는 정규식을 가져옵니다.

반환 값

getGTestFlags

public  getGTestFlags ()

네이티브 테스트의 셸 명령어에 전달할 추가 플래그 값을 가져옵니다.

반환 값

getIncludeFilters

public  getIncludeFilters ()

포함 필터의 현재 ERROR(/Set)를 반환합니다.

반환 값

getMaxTestTimeMs

public long getMaxTestTimeMs ()

gtest가 실행되는 최대 시간을 가져옵니다.

반환 값
`long`

getModuleName

public String getModuleName ()

실행할 Android 네이티브 테스트 모듈을 가져옵니다.

반환 값
`String`	실행할 네이티브 테스트 모듈의 이름입니다. 설정되지 않은 경우 null입니다.

getRunDisabledTests

public boolean getRunDisabledTests ()

GTest가 사용 중지된 테스트를 실행해야 하는지 여부를 가져옵니다.

반환 값
`boolean`	사용 중지된 테스트를 실행해야 하면 true, 그렇지 않으면 false입니다.

getRuntimeHint

public long getRuntimeHint ()

테스트의 예상 실행 시간을 밀리초 단위로 반환합니다. 이 시간은 샤딩된 실행의 부하를 분산하는 데 사용됩니다.

반환 값
`long`

getShardCount

public int getShardCount ()

현재 샤드 수를 반환합니다.

반환 값
`int`

getShardIndex

public int getShardIndex ()

이 테스트의 샤드 색인을 가져옵니다.

반환 값
`int`

getTestFilterKey

public String getTestFilterKey ()

테스트 필터 키를 가져옵니다.

반환 값
`String`

getTestModule

public String getTestModule ()

모듈 이름을 가져옵니다.

반환 값
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

관련 테스트 사례 목록을 수집하기 위해 테스트 바이너리를 호출하는지 여부만 가져옵니다.

반환 값
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

테스트 결과에 gtest xml 출력을 사용할지 여부를 가져옵니다.

반환 값
`boolean`

isSharded

public boolean isSharded ()

isSharded 플래그를 가져옵니다.

반환 값
`boolean`

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

재시도 시 포함/제외 필터를 올바르게 처리할 수 있도록 테스트 실행을 부모에게 알립니다.

매개변수
`incompleteTestFound`	`boolean`
`failedTests`

setAbi

public void setAbi (IAbi abi)

매개변수
`abi`	`IAbi`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

사용 중인 IConfiguration를 삽입합니다.

매개변수
`configuration`	`IConfiguration`

setModuleName

public void setModuleName (String moduleName)

실행할 Android 네이티브 테스트 모듈을 설정합니다.

매개변수
`moduleName`	`String`: 실행할 네이티브 테스트 모듈의 이름

setShardCount

public void setShardCount (int shardCount)

이 테스트의 샤드 수를 설정합니다.

매개변수
`shardCount`	`int`

setShardIndex

public void setShardIndex (int shardIndex)

이 테스트의 샤드 색인을 설정합니다.

매개변수
`shardIndex`	`int`

분할

public  split (int shardCountHint)

실행을 시도한 shardCount도 제공하는 split()의 대체 버전입니다. 이는 임의로 결정할 수 없는 일부 테스트 러너에 유용합니다.

매개변수
`shardCountHint`	`int`: 시도된 샤드 수입니다.

반환 값
	별도로 실행할 하위 테스트 모음 또는 테스트를 현재 샤딩할 수 없는 경우 `null`

보호된 메서드

convertName

protected String convertName (String gtestFlagName)

매개변수
`gtestFlagName`	`String`

반환 값
`String`

createFlagFile

protected String createFlagFile (String filter)

인수 크기의 OS 제한을 방지하기 위해 --gtest_flagfile을 통해 사용될 필터가 포함된 파일을 만듭니다.

매개변수
`filter`	`String`: 필터 문자열

반환 값
`String`	필터가 포함된 파일의 경로입니다.

생성 값
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

erasePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

매개변수
`filters`
`filename`	`String`

getAllGTestFlags

protected String getAllGTestFlags (String path)

adb 셸 명령어에 전달할 모든 GTest 플래그를 가져오는 도우미

매개변수
`path`	`String`: 기기에 있는 바이너리의 전체 경로

반환 값
`String`	GTest에 전달해야 하는 모든 GTest 플래그의 `String`

생성 값
`DeviceNotAvailableException`

getConfiguration

protected IConfiguration getConfiguration ()

테스트 구성을 반환합니다.

반환 값
`IConfiguration`	IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

주어진 Exception에 대해 의미 있는 짧은 설명 메시지를 가져오기 위해 최선을 다합니다.

매개변수
`e`	`Exception`: `Exception`

반환 값
`String`	짧은 메시지

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

실행할 gtest 명령어를 빌드하는 도우미 메서드

매개변수
`fullPath`	`String`: 기기의 gtest 바이너리에 대한 절대 파일 시스템 경로
`flags`	`String`: gtest 실행 플래그

반환 값
`String`	gtest를 실행할 셸 명령줄

getGTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

파생 클래스가 다른 도구 (chroot, strace, gdb 등) 아래에서 gtest 명령어를 래핑할 수 있도록 지원하는 도우미입니다.

매개변수
`fullPath`	`String`
`flags`	`String`

반환 값
`String`

getGTestFilters

protected String getGTestFilters (String path)

실행할 테스트의 g-test 필터를 가져오는 도우미

필터는 함수 이름 (예: Google 테스트 '테스트')에 대해서만 필터링합니다. 모든 Google 테스트 '테스트 사례'가 고려됩니다.

매개변수
`path`	`String`: 기기에 있는 바이너리의 전체 경로

반환 값
`String`	g-test에 전달할 전체 필터 플래그 또는 지정된 플래그가 없는 경우 빈 문자열

생성 값
`DeviceNotAvailableException`

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

mDisabledDuplicateCheck가 false인 경우 중복 테스트를 감지하고 보고하는 등 추가 디버깅 정보를 제공하는 GTestListener를 반환합니다. 그렇지 않으면 전달된 리스너를 반환합니다.

매개변수
`listeners`	`ITestInvocationListener`

반환 값
`ITestInvocationListener`

loadFilter

protected abstract String loadFilter (String path)

필터 가져오기 메서드를 정의합니다.

하위 클래스는 자체 필터를 가져오는 방법을 구현해야 합니다.

매개변수
`path`	`String`: 필터 파일의 전체 경로입니다.

반환 값
`String`	필터 문자열입니다.

생성 값
`DeviceNotAvailableException`

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

GTest에서 사용 중지된 테스트를 실행할지 여부를 설정합니다.

매개변수
`runDisabled`	`boolean`