GTestBase
public abstract class GTestBase
extends Object
implements IRemoteTest , IConfigurationReceiver , ITestFilterReceiver , IRuntimeHintProvider , ITestCollector , IShardableTest , IAbiReceiver
java.lang.Object | |
↳ | com.android.tradefed.testtype.GTestBase |
Lớp cơ bản của gTest
Bản tóm tắt
Lĩnh vực | |
---|---|
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
|
Các nhà xây dựng công cộng | |
---|---|
GTestBase () |
Phương pháp công khai | |
---|---|
void | addAllExcludeFilters ( filters) addAllExcludeFilters ( filters) Thêm |
void | addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) Thêm |
void | addExcludeFilter (String filter) Thêm một bộ lọc trong đó các thử nghiệm cần loại trừ. |
void | addIncludeFilter (String filter) Thêm một bộ lọc để bao gồm các thử nghiệm. |
String | cleanFilter (String filter) |
void | clearExcludeFilters () Xóa tất cả các bộ lọc loại trừ hiện được theo dõi. |
void | clearIncludeFilters () Xóa tất cả các bộ lọc bao gồm hiện đang theo dõi. |
IAbi | getAbi () |
getAfterTestCmd () Nhận (các) lệnh shell để chạy sau GTest. | |
getBeforeTestCmd () Cho phép (các) lệnh shell chạy trước GTest. | |
getExcludeFilters () Trả về | |
getFileExclusionFilterRegex () Gets regex để loại trừ các tệp nhất định khỏi việc thực thi. | |
getGTestFlags () Nhận các giá trị cờ bổ sung để chuyển đến lệnh shell của thử nghiệm gốc. | |
getIncludeFilters () Trả về | |
long | getMaxTestTimeMs () Nhận thời gian tối đa để một gtest chạy. |
String | getModuleName () Lấy mô-đun kiểm tra gốc của Android để chạy. |
boolean | getRunDisabledTests () Tìm hiểu xem GTest có nên chạy các bài kiểm tra bị vô hiệu hóa hay không. |
long | getRuntimeHint () Trả về thời gian chạy dự kiến của bài kiểm tra tính bằng mili giây. |
int | getShardCount () Trả về số phân đoạn hiện tại. |
int | getShardIndex () Nhận chỉ mục phân đoạn của bài kiểm tra này. |
String | getTestFilterKey () Nhận khóa bộ lọc kiểm tra. |
String | getTestModule () Nhận tên mô-đun. |
boolean | isCollectTestsOnly () Chỉ được phép gọi nhị phân thử nghiệm để thu thập danh sách các trường hợp thử nghiệm có thể áp dụng hoặc không. |
boolean | isEnableXmlOutput () Được phép sử dụng đầu ra xml gtest để biết kết quả kiểm tra hay không. |
boolean | isSharded () Nhận cờ isSharded. |
void | setAbi ( IAbi abi) |
void | setCollectTestsOnly (boolean shouldCollectTest) Bật hoặc tắt chế độ thu thập thử nghiệm |
void | setConfiguration ( IConfiguration configuration) |
void | setModuleName (String moduleName) Đặt mô-đun kiểm tra gốc của Android để chạy. |
void | setShardCount (int shardCount) Đặt số lượng phân đoạn của thử nghiệm này. |
void | setShardIndex (int shardIndex) Đặt chỉ mục phân đoạn của bài kiểm tra này. |
split (int shardCountHint) Phiên bản thay thế của |
Các phương pháp được bảo vệ | |
---|---|
String | createFlagFile (String filter) Tạo một tệp có chứa các bộ lọc sẽ được sử dụng qua --gtest_flagfile để tránh bất kỳ giới hạn hệ điều hành nào trong kích thước args. |
void | erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename) |
String | getAllGTestFlags (String path) Người trợ giúp để nhận được tất cả các cờ GTest để chuyển vào lệnh adb shell. |
IConfiguration | getConfiguration () Trả về cấu hình thử nghiệm. |
String | getExceptionMessage (Exception e) Cố gắng hết sức để truy xuất một thông điệp mô tả ngắn có ý nghĩa cho |
String | getGTestCmdLine (String fullPath, String flags) Phương thức trợ giúp để xây dựng lệnh gtest để chạy. |
String | getGTestCmdLineWrapper (String fullPath, String flags) Trình trợ giúp cho phép các lớp dẫn xuất bọc lệnh gtest dưới một số công cụ khác (chroot, strace, gdb, v.v.). |
String | getGTestFilters (String path) Người trợ giúp để chạy bộ lọc thử nghiệm g-test. |
ITestInvocationListener | getGTestListener ( ITestInvocationListener listener) Trả về |
abstract String | loadFilter (String path) Xác định phương thức bộ lọc lấy. |
void | setRunDisabled (boolean runDisabled) Đặt GTest có nên chạy các bài kiểm tra bị vô hiệu hóa hay không. |
Lĩnh vực
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
Các nhà xây dựng công cộng
GTestBase
public GTestBase ()
Phương pháp công khai
addAllExcludeFilters
public void addAllExcludeFilters (filters)
Thêm ERROR(/Set)
các bộ lọc mà các thử nghiệm cần loại trừ.
Thông số | |
---|---|
filters |
addAllIncludeFilters
public void addAllIncludeFilters (filters)
Thêm ERROR(/Set)
các bộ lọc mà các thử nghiệm sẽ bao gồm.
Thông số | |
---|---|
filters |
addExcludeFilter
public void addExcludeFilter (String filter)
Thêm một bộ lọc trong đó các thử nghiệm cần loại trừ.
Thông số | |
---|---|
filter | String |
addIncludeFilter
public void addIncludeFilter (String filter)
Thêm một bộ lọc để bao gồm các thử nghiệm.
Thông số | |
---|---|
filter | String |
cleanFilter
public String cleanFilter (String filter)
Thông số | |
---|---|
filter | String |
Lợi nhuận | |
---|---|
String |
clearExcludeFilters
public void clearExcludeFilters ()
Xóa tất cả các bộ lọc loại trừ hiện được theo dõi.
clearIncludeFilters
public void clearIncludeFilters ()
Xóa tất cả các bộ lọc bao gồm hiện đang theo dõi.
getAfterTestCmd
publicgetAfterTestCmd ()
Nhận (các) lệnh shell để chạy sau GTest.
Lợi nhuận | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
Cho phép (các) lệnh shell chạy trước GTest.
Lợi nhuận | |
---|---|
getExcludeFilters
publicgetExcludeFilters ()
Trả về ERROR(/Set)
bộ lọc loại trừ hiện tại.
Lợi nhuận | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Gets regex để loại trừ các tệp nhất định khỏi việc thực thi.
Lợi nhuận | |
---|---|
getGTestFlags
publicgetGTestFlags ()
Nhận các giá trị cờ bổ sung để chuyển đến lệnh shell của thử nghiệm gốc.
Lợi nhuận | |
---|---|
getIncludeFilters
publicgetIncludeFilters ()
Trả về ERROR(/Set)
hiện tại của các bộ lọc bao gồm.
Lợi nhuận | |
---|---|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
Nhận thời gian tối đa để một gtest chạy.
Lợi nhuận | |
---|---|
long |
getModuleName
public String getModuleName ()
Lấy mô-đun kiểm tra gốc của Android để chạy.
Lợi nhuận | |
---|---|
String | tên của mô-đun thử nghiệm gốc để chạy hoặc null nếu không được đặt |
getRunDisabledTests
public boolean getRunDisabledTests ()
Tìm hiểu xem GTest có nên chạy các bài kiểm tra bị vô hiệu hóa hay không.
Lợi nhuận | |
---|---|
boolean | Đúng nếu các thử nghiệm bị vô hiệu hóa sẽ được chạy, nếu không thì sai |
getRuntimeH Gợi ý
public long getRuntimeHint ()
Trả về thời gian chạy dự kiến của bài kiểm tra tính bằng mili giây. Thời gian được sử dụng để tải thực thi phân đoạn số dư
Lợi nhuận | |
---|---|
long |
getShardCount
public int getShardCount ()
Trả về số phân đoạn hiện tại.
Lợi nhuận | |
---|---|
int |
getShardIndex
public int getShardIndex ()
Nhận chỉ mục phân đoạn của bài kiểm tra này.
Lợi nhuận | |
---|---|
int |
getTestFilterKey
public String getTestFilterKey ()
Nhận khóa bộ lọc kiểm tra.
Lợi nhuận | |
---|---|
String |
getTestModule
public String getTestModule ()
Nhận tên mô-đun.
Lợi nhuận | |
---|---|
String |
isCollectTestsOnly
public boolean isCollectTestsOnly ()
Chỉ được phép gọi nhị phân thử nghiệm để thu thập danh sách các trường hợp thử nghiệm có thể áp dụng hoặc không.
Lợi nhuận | |
---|---|
boolean |
isEnableXmlOutput
public boolean isEnableXmlOutput ()
Được phép sử dụng đầu ra xml gtest để biết kết quả kiểm tra hay không.
Lợi nhuận | |
---|---|
boolean |
isSharded
public boolean isSharded ()
Nhận cờ isSharded.
Lợi nhuận | |
---|---|
boolean |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Bật hoặc tắt chế độ thu thập thử nghiệm
setConfiguration
public void setConfiguration (IConfiguration configuration)
IConfiguration
đang sử dụng.
Thông số | |
---|---|
configuration | IConfiguration |
setModuleName
public void setModuleName (String moduleName)
Đặt mô-đun kiểm tra gốc của Android để chạy.
Thông số | |
---|---|
moduleName | String : Tên của mô-đun thử nghiệm gốc sẽ chạy |
setShardCount
public void setShardCount (int shardCount)
Đặt số lượng phân đoạn của thử nghiệm này.
Thông số | |
---|---|
shardCount | int |
setShardIndex
public void setShardIndex (int shardIndex)
Đặt chỉ mục phân đoạn của bài kiểm tra này.
Thông số | |
---|---|
shardIndex | int |
tách ra
publicsplit (int shardCountHint)
Phiên bản thay thế của split()
cũng cung cấp shardCount đang cố gắng chạy. Điều này rất hữu ích cho một số người chạy thử mà đôi khi không thể tự ý quyết định.
Thông số | |
---|---|
shardCountHint | int : số lượng phân đoạn đã cố gắng. |
Lợi nhuận | |
---|---|
một tập hợp các bài kiểm tra phụ sẽ được thực hiện riêng biệt hoặc null nếu bài kiểm tra hiện không thể phân mảnh được |
Các phương pháp được bảo vệ
createFlagFile
protected String createFlagFile (String filter)
Tạo một tệp có chứa các bộ lọc sẽ được sử dụng qua --gtest_flagfile để tránh bất kỳ giới hạn hệ điều hành nào trong kích thước args.
Thông số | |
---|---|
filter | String : Chuỗi bộ lọc |
Lợi nhuận | |
---|---|
String | Đường dẫn đến tệp chứa bộ lọc. |
Ném | |
---|---|
DeviceNotAvailableException |
deletePrependedFileName
protected void erasePrependedFileName (filters, String filename)
Thông số | |
---|---|
filters | |
filename | String |
getAllGTestFlags
protected String getAllGTestFlags (String path)
Người trợ giúp để nhận được tất cả các cờ GTest để chuyển vào lệnh adb shell.
Thông số | |
---|---|
path | String : đường dẫn đầy đủ của tệp nhị phân trên thiết bị. |
Lợi nhuận | |
---|---|
String | String của tất cả các cờ GTest sẽ được chuyển cho GTest |
Ném | |
---|---|
DeviceNotAvailableException |
getConfiguration
protected IConfiguration getConfiguration ()
Trả về cấu hình thử nghiệm.
Lợi nhuận | |
---|---|
IConfiguration | một cấu hình IC |
getExceptionMessage
protected String getExceptionMessage (Exception e)
Cố gắng hết sức để truy xuất một thông điệp mô tả ngắn có ý nghĩa cho Exception
đã cho
Thông số | |
---|---|
e | Exception : trường hợp Exception |
Lợi nhuận | |
---|---|
String | một tin nhắn ngắn |
getGTestCmdLine
protected String getGTestCmdLine (String fullPath, String flags)
Phương thức trợ giúp để xây dựng lệnh gtest để chạy.
Thông số | |
---|---|
fullPath | String : đường dẫn hệ thống tệp tuyệt đối đến mã nhị phân gtest trên thiết bị |
flags | String : cờ thực thi gtest |
Lợi nhuận | |
---|---|
String | dòng lệnh shell để chạy cho gtest |
getGTestCmdLineWrapper
protected String getGTestCmdLineWrapper (String fullPath, String flags)
Trình trợ giúp cho phép các lớp dẫn xuất bọc lệnh gtest dưới một số công cụ khác (chroot, strace, gdb, v.v.).
Thông số | |
---|---|
fullPath | String |
flags | String |
Lợi nhuận | |
---|---|
String |
getGTestFilters
protected String getGTestFilters (String path)
Người trợ giúp để chạy bộ lọc thử nghiệm g-test.
Lưu ý rằng các bộ lọc chỉ lọc tên hàm (ví dụ: "Kiểm tra" của Google Test); tất cả các "Trường hợp Kiểm tra" Kiểm tra của Google sẽ được xem xét.
Thông số | |
---|---|
path | String : đường dẫn đầy đủ của tệp nhị phân trên thiết bị. |
Lợi nhuận | |
---|---|
String | cờ bộ lọc đầy đủ để chuyển đến g-test hoặc một chuỗi trống nếu không có chuỗi nào được chỉ định |
Ném | |
---|---|
DeviceNotAvailableException |
getGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)
Trả về GTestListener
cung cấp thêm thông tin gỡ lỗi, như phát hiện và báo cáo các thử nghiệm trùng lặp nếu mDisabledDuplicateCheck là sai. Nếu không, trả về trình nghe đã chuyển vào.
Thông số | |
---|---|
listener | ITestInvocationListener |
Lợi nhuận | |
---|---|
ITestInvocationListener |
loadFilter
protected abstract String loadFilter (String path)
Xác định phương thức lọc lấy.
Lớp con phải triển khai cách lấy bộ lọc riêng của nó.
Thông số | |
---|---|
path | String : đường dẫn đầy đủ của tệp bộ lọc. |
Lợi nhuận | |
---|---|
String | chuỗi bộ lọc. |
Ném | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
Đặt GTest có nên chạy các bài kiểm tra bị vô hiệu hóa hay không.
Thông số | |
---|---|
runDisabled | boolean |