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 ArtGTest

---

gTest의 기본 클래스

요약

필드
protected static final String	FILTER_EXTENSION
protected static final String	GTEST_FLAG_FILE
protected static final String	GTEST_FLAG_FILTER
protected static final String	GTEST_FLAG_LIST_TESTS
protected static final String	GTEST_FLAG_PRINT_TIME
protected static final String	GTEST_FLAG_RUN_DISABLED_TESTS
protected static final 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) args 크기의 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) get filter 메서드를 정의합니다.
void	setRunDisabled(boolean runDisabled) GTest에서 사용 중지된 테스트를 실행해야 하는지 설정합니다.

필드

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

공개 생성자

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)

args 크기의 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 테스트 'Test'). 모든 Google 테스트 'Test Cases'가 고려됩니다.

매개변수
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)

get filter 메서드를 정의합니다.

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

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

반환 값
String	필터 문자열을 사용합니다.

생성 값
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

GTest에서 사용 중지된 테스트를 실행해야 하는지 설정합니다.

매개변수
runDisabled	boolean