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(
제외할 테스트 필터의 |
void
|
addAllIncludeFilters(
포함할 테스트의 필터 |
void
|
addExcludeFilter(String filter)
제외할 테스트의 필터를 추가합니다. |
void
|
addIncludeFilter(String filter)
포함할 테스트의 필터를 추가합니다. |
String
|
cleanFilter(String filter)
|
void
|
clearExcludeFilters()
현재 추적 중인 제외 필터를 모두 삭제합니다. |
void
|
clearIncludeFilters()
현재 추적된 모든 포함 필터를 삭제합니다. |
IAbi
|
getAbi()
|
|
getAfterTestCmd()
GTest 후에 실행할 셸 명령어를 가져옵니다. |
|
getBeforeTestCmd()
GTest 전에 실행할 셸 명령어를 가져옵니다. |
|
getExcludeFilters()
제외 필터의 현재 |
|
getFileExclusionFilterRegex()
특정 파일이 실행되지 않도록 하는 정규식을 가져옵니다. |
|
getGTestFlags()
네이티브 테스트의 셸 명령어에 전달할 추가 플래그 값을 가져옵니다. |
|
getIncludeFilters()
포함 필터의 현재 |
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,
재시도 시 포함/제외 필터를 올바르게 처리할 수 있도록 테스트 실행에 관한 상위 요소에 알립니다. |
void
|
setAbi(IAbi abi)
|
void
|
setCollectTestsOnly(boolean shouldCollectTest)
테스트 수집 모드 사용 설정 또는 중지 |
void
|
setConfiguration(IConfiguration configuration)
사용 중인 |
void
|
setModuleName(String moduleName)
Android 네이티브 테스트 모듈을 실행하도록 설정합니다. |
void
|
setShardCount(int shardCount)
이 테스트의 샤드 수를 설정합니다. |
void
|
setShardIndex(int shardIndex)
이 테스트의 샤드 색인을 설정합니다. |
|
split(int shardCountHint)
실행하려는 shardCount도 제공하는 |
보호된 메서드 | |
---|---|
String
|
createFlagFile(String filter)
args 크기의 OS 제한을 방지하기 위해 --gtest_flagfile을 통해 사용될 필터가 포함된 파일을 만듭니다. |
void
|
erasePrependedFileName(
|
String
|
getAllGTestFlags(String path)
adb 셸 명령어에 전달할 모든 GTest 플래그를 가져오는 도우미 |
IConfiguration
|
getConfiguration()
테스트 구성을 반환합니다. |
String
|
getExceptionMessage(Exception e)
주어진 |
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 ()
현재 추적 중인 포함 필터를 모두 삭제합니다.
getAfterTestCmd
publicgetAfterTestCmd ()
GTest 후에 실행할 셸 명령어를 가져옵니다.
반환 값 | |
---|---|
|
getBeforeTestCmd
publicgetBeforeTestCmd ()
GTest 전에 실행할 셸 명령어를 가져옵니다.
반환 값 | |
---|---|
|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
정규식을 가져와 특정 파일이 실행되지 않도록 제외합니다.
반환 값 | |
---|---|
|
getGTestFlags
publicgetGTestFlags ()
네이티브 테스트의 셸 명령어에 전달할 추가 플래그 값을 가져옵니다.
반환 값 | |
---|---|
|
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 |
|
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 |
분할
publicsplit (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 |