GTestBase
public abstract class GTestBase
extends Object
implements IRemoteTest , IConfigurationReceiver , ITestFilterReceiver , IRuntimeHintProvider , ITestCollector , IShardableTest , IAbiReceiver
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) addAllExcludeFilters ( filters) 제외할 테스트 필터의 |
void | addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) 포함할 테스트에 대한 필터의 |
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, failedTests) notifyTestExecution (boolean incompleteTestFound, failedTests) 재시도에 대해 포함/제외 필터가 적절하게 처리될 수 있도록 테스트 실행을 부모에게 알립니다. |
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) 인수 크기의 OS 제한을 피하기 위해 --gtest_flagfile을 통해 사용할 필터가 포함된 파일을 만듭니다. |
void | erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename) |
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 listener) mDisabledDuplicateCheck가 false인 경우 중복 테스트를 감지하고 보고하는 등 추가 디버깅 정보를 제공하는 GTestListener를 반환합니다. |
abstract String | loadFilter (String path) 필터 가져오기 방법을 정의합니다. |
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 |
클린필터
public String cleanFilter (String filter)
매개변수 | |
---|---|
filter | String |
보고 | |
---|---|
String |
클리어제외필터
public void clearExcludeFilters ()
현재 추적 중인 모든 제외 필터를 삭제합니다.
명확한IncludeFilters
public void clearIncludeFilters ()
현재 추적되는 모든 포함 필터를 삭제합니다.
getAfterTestCmd
publicgetAfterTestCmd ()
GTest 후에 실행할 셸 명령을 가져옵니다.
보고 | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
GTest 전에 실행할 셸 명령을 가져옵니다.
보고 | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
특정 파일을 실행에서 제외하는 정규식을 가져옵니다.
보고 | |
---|---|
getGTestFlags
publicgetGTestFlags ()
기본 테스트의 셸 명령에 전달할 추가 플래그 값을 가져옵니다.
보고 | |
---|---|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
gtest가 실행되는 최대 시간을 가져옵니다.
보고 | |
---|---|
long |
get모듈 이름
public String getModuleName ()
실행할 Android 네이티브 테스트 모듈을 가져옵니다.
보고 | |
---|---|
String | 실행할 네이티브 테스트 모듈의 이름. 설정되지 않은 경우 null |
getRunDisabledTests
public boolean getRunDisabledTests ()
GTest가 비활성화된 테스트를 실행해야 하는지 여부를 가져옵니다.
보고 | |
---|---|
boolean | 비활성화된 테스트를 실행해야 하면 참이고, 그렇지 않으면 거짓입니다. |
getRuntimeHint
public long getRuntimeHint ()
테스트의 예상 런타임을 밀리초 단위로 반환합니다. 시간은 샤딩 실행의 부하를 분산하는 데 사용됩니다.
보고 | |
---|---|
long |
getShardCount
public int getShardCount ()
현재 샤드 수를 반환합니다.
보고 | |
---|---|
int |
getShardIndex
public int getShardIndex ()
이 테스트의 샤드 인덱스를 가져옵니다.
보고 | |
---|---|
int |
getTestFilterKey
public String getTestFilterKey ()
테스트 필터 키를 가져옵니다.
보고 | |
---|---|
String |
getTest모듈
public String getTestModule ()
모듈 이름을 가져옵니다.
보고 | |
---|---|
String |
isCollectTestsOnly
public boolean isCollectTestsOnly ()
적용 가능한 테스트 케이스 목록을 수집하기 위해 테스트 바이너리만 호출합니다.
보고 | |
---|---|
boolean |
isEnableXmlOutput
public boolean isEnableXmlOutput ()
테스트 결과에 대해 gtest xml 출력 사용 여부를 가져옵니다.
보고 | |
---|---|
boolean |
isSharded
public boolean isSharded ()
isSharded 플래그를 가져옵니다.
보고 | |
---|---|
boolean |
통지테스트실행
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 |
보호된 방법
createFlag파일
protected String createFlagFile (String filter)
인수 크기의 OS 제한을 피하기 위해 --gtest_flagfile을 통해 사용할 필터가 포함된 파일을 만듭니다.
매개변수 | |
---|---|
filter | String : 필터 문자열 |
보고 | |
---|---|
String | 필터가 포함된 파일의 경로입니다. |
던지기 | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
삭제앞에 추가된 파일 이름
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 |
getException메시지
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 "Test"). 모든 Google 테스트 "테스트 사례"가 고려됩니다.
매개변수 | |
---|---|
path | String : 장치에 있는 바이너리의 전체 경로입니다. |
보고 | |
---|---|
String | g-test에 전달할 전체 필터 플래그, 또는 아무것도 지정되지 않은 경우 빈 문자열 |
던지기 | |
---|---|
DeviceNotAvailableException |
getGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)
mDisabledDuplicateCheck가 false인 경우 중복 테스트를 감지하고 보고하는 등 추가 디버깅 정보를 제공하는 GTestListener를 반환합니다. 그렇지 않으면 전달된 리스너를 반환합니다.
매개변수 | |
---|---|
listener | ITestInvocationListener |
보고 | |
---|---|
ITestInvocationListener |
로드필터
protected abstract String loadFilter (String path)
필터 가져오기 방법을 정의합니다.
하위 클래스는 자체 필터를 얻는 방법을 구현해야 합니다.
매개변수 | |
---|---|
path | String : 필터 파일의 전체 경로입니다. |
보고 | |
---|---|
String | 필터 문자열. |
던지기 | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
GTest가 비활성화된 테스트를 실행해야 하는지 여부를 설정합니다.
매개변수 | |
---|---|
runDisabled | boolean |