GTestBase

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

java.lang.Object의 클래스
   ↳ com.android.tradefed.testtype.GTestBase


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 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가 사용 중지된 테스트를 실행해야 하는지 설정합니다.

필드

필터_확장

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 ()

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

게트아비

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

보호된 메서드

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)

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

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

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

반환 값
String filter 문자열입니다.

생성 값
DeviceNotAvailableException

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

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

매개변수
runDisabled boolean