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ơ sở 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
|
Nhà thầu 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 để loại trừ các bài kiểm tra. |
void | addIncludeFilter (String filter) Thêm một bộ lọc để đưa vào các bài kiểm tra. |
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 được theo dõi. |
IAbi | getAbi () |
getAfterTestCmd () Nhận (các) lệnh shell để chạy sau GTest. | |
getBeforeTestCmd () Nhận (các) lệnh shell để chạy trước GTest. | |
getExcludeFilters () Trả về | |
getFileExclusionFilterRegex () Nhận biểu thức chính quy để loại trừ một số tệp nhất định khỏi việc thực thi. | |
getGTestFlags () Nhận các giá trị cờ bổ sung để chuyển tới lệnh shell của bài kiểm tra gốc. | |
getIncludeFilters () Trả về | |
long | getMaxTestTimeMs () Lấy thời gian tối đa để chạy gtest. |
String | getModuleName () Tải mô-đun thử nghiệm gốc của Android để chạy. |
boolean | getRunDisabledTests () Biết liệu GTest có nên chạy thử nghiệm bị vô hiệu hóa hay không. |
long | getRuntimeHint () Trả về thời gian chạy thử nghiệm dự kiến tính bằng mili giây. |
int | getShardCount () Trả về số lượng phân đoạn hiện tại. |
int | getShardIndex () Lấy chỉ số phân đoạn của bài kiểm tra này. |
String | getTestFilterKey () Nhận khóa bộ lọc thử nghiệm. |
String | getTestModule () Lấy tên mô-đun. |
boolean | isCollectTestsOnly () Chỉ gọi mã 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 hay không. |
boolean | isEnableXmlOutput () Có sử dụng đầu ra gtest xml để biết kết quả kiểm tra hay không. |
boolean | isSharded () Nhận cờ isSharded. |
void | notifyTestExecution (boolean incompleteTestFound, failedTests) notifyTestExecution (boolean incompleteTestFound, failedTests) Thông báo cho phụ huynh về việc thực hiện kiểm tra để có thể xử lý đúng cách các bộ lọc bao gồm/loại trừ cho những lần thử lại. |
void | setAbi ( IAbi abi) |
void | setCollectTestsOnly (boolean shouldCollectTest) Bật hoặc tắt chế độ thu thập bài kiểm tra |
void | setConfiguration ( IConfiguration configuration) Tiêm |
void | setModuleName (String moduleName) Đặt mô-đun thử nghiệm 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 thử nghiệm này. |
split (int shardCountHint) Phiên bản thay thế của |
Phương pháp được bảo vệ | |
---|---|
String | createFlagFile (String filter) Tạo một tệp chứa các bộ lọc sẽ được sử dụng thông qua --gtest_flagfile để tránh mọi giới hạn của hệ điều hành về kích thước đối số. |
void | erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename) |
String | getAllGTestFlags (String path) Trình trợ giúp để chuyển tất cả các cờ GTest vào lệnh shell adb. |
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 thông báo 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ề GTestListener cung cấp thêm thông tin gỡ lỗi, như phát hiện và báo cáo các lần kiểm tra trùng lặp nếu mDisabledDuplicateCheck sai. |
abstract String | loadFilter (String path) Xác định phương thức lọc get. |
void | setRunDisabled (boolean runDisabled) Đặt xem GTest có nên chạy thử nghiệm 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
Nhà thầu 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ủa các bộ lọc cần loại trừ các xét nghiệm.
Thông số | |
---|---|
filters |
addAllIncludeFilters
public void addAllIncludeFilters (filters)
Thêm ERROR(/Set)
của các bộ lọc cần đưa vào các bài kiểm tra.
Thông số | |
---|---|
filters |
thêmLoại trừBộ lọc
public void addExcludeFilter (String filter)
Thêm một bộ lọc để loại trừ các bài kiểm tra.
Thông số | |
---|---|
filter | String |
thêmIncludeFilter
public void addIncludeFilter (String filter)
Thêm một bộ lọc để đưa vào các bài kiểm tra.
Thông số | |
---|---|
filter | String |
bộ lọc sạch
public String cleanFilter (String filter)
Thông số | |
---|---|
filter | String |
Trả lại | |
---|---|
String |
rõ ràngLoại trừBộ lọc
public void clearExcludeFilters ()
Xóa tất cả các bộ lọc loại trừ hiện được theo dõi.
rõ ràngBao gồmBộ lọc
public void clearIncludeFilters ()
Xóa tất cả các bộ lọc bao gồm hiện được theo dõi.
getAfterTestCmd
publicgetAfterTestCmd ()
Nhận (các) lệnh shell để chạy sau GTest.
Trả lại | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
Nhận (các) lệnh shell để chạy trước GTest.
Trả lại | |
---|---|
getExcludeFilters
publicgetExcludeFilters ()
Trả về ERROR(/Set)
hiện tại của các bộ lọc loại trừ.
Trả lại | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Nhận biểu thức chính quy để loại trừ một số tệp nhất định khỏi việc thực thi.
Trả lại | |
---|---|
getGTestFlags
publicgetGTestFlags ()
Nhận các giá trị cờ bổ sung để chuyển tới lệnh shell của bài kiểm tra gốc.
Trả lại | |
---|---|
getIncludeFilters
publicgetIncludeFilters ()
Trả về ERROR(/Set)
hiện tại của các bộ lọc bao gồm.
Trả lại | |
---|---|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
Lấy thời gian tối đa để chạy gtest.
Trả lại | |
---|---|
long |
getModuleName
public String getModuleName ()
Tải mô-đun thử nghiệm gốc của Android để chạy.
Trả lại | |
---|---|
String | tên của mô-đun thử nghiệm gốc sẽ chạy hoặc null nếu không được đặt |
getRunDisabledTests
public boolean getRunDisabledTests ()
Biết liệu GTest có nên chạy thử nghiệm bị vô hiệu hóa hay không.
Trả lại | |
---|---|
boolean | Đúng nếu chạy thử nghiệm bị vô hiệu hóa, nếu không thì sai |
getRuntimeHint
public long getRuntimeHint ()
Trả về thời gian chạy thử nghiệm dự kiến tính bằng mili giây. Thời gian được sử dụng để thực hiện phân chia cân bằng tải
Trả lại | |
---|---|
long |
getShardCount
public int getShardCount ()
Trả về số lượng phân đoạn hiện tại.
Trả lại | |
---|---|
int |
getShardIndex
public int getShardIndex ()
Lấy chỉ số phân đoạn của bài kiểm tra này.
Trả lại | |
---|---|
int |
getTestFilterKey
public String getTestFilterKey ()
Nhận khóa bộ lọc thử nghiệm.
Trả lại | |
---|---|
String |
getTestModule
public String getTestModule ()
Lấy tên mô-đun.
Trả lại | |
---|---|
String |
isCollectTestsOnly
public boolean isCollectTestsOnly ()
Chỉ gọi mã 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 hay không.
Trả lại | |
---|---|
boolean |
isEnableXmlĐầu ra
public boolean isEnableXmlOutput ()
Có sử dụng đầu ra gtest xml để biết kết quả kiểm tra hay không.
Trả lại | |
---|---|
boolean |
isSharded
public boolean isSharded ()
Nhận cờ isSharded.
Trả lại | |
---|---|
boolean |
thông báoTestExecution
public void notifyTestExecution (boolean incompleteTestFound,failedTests)
Thông báo cho phụ huynh về việc thực hiện kiểm tra để có thể xử lý đúng cách các bộ lọc bao gồm/loại trừ cho những lần thử lại.
Thông số | |
---|---|
incompleteTestFound | boolean |
failedTests |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Bật hoặc tắt chế độ thu thập bài kiểm tra
setConfiguration
public void setConfiguration (IConfiguration configuration)
Tiêm IConfiguration
đang sử dụng.
Thông số | |
---|---|
configuration | IConfiguration |
setModuleName
public void setModuleName (String moduleName)
Đặt mô-đun thử nghiệm 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 thử nghiệm 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 hữu ích đối với một số người chạy thử đôi khi không thể quyết định một cách tùy tiện.
Thông số | |
---|---|
shardCountHint | int : số lượng phân đoạn đã thử. |
Trả lại | |
---|---|
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 chia được |
Phương pháp được bảo vệ
tạoFlagFile
protected String createFlagFile (String filter)
Tạo một tệp chứa các bộ lọc sẽ được sử dụng thông qua --gtest_flagfile để tránh mọi giới hạn của hệ điều hành về kích thước đối số.
Thông số | |
---|---|
filter | String : Chuỗi bộ lọc |
Trả lại | |
---|---|
String | Đường dẫn đến file chứa bộ lọc. |
Ném | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
xóaTên tệp được chuẩn bị trước
protected void erasePrependedFileName (filters, String filename)
Thông số | |
---|---|
filters | |
filename | String |
getAllGTestFlags
protected String getAllGTestFlags (String path)
Trình trợ giúp để chuyển tất cả các cờ GTest vào lệnh shell adb.
Thông số | |
---|---|
path | String : đường dẫn đầy đủ của tệp nhị phân trên thiết bị. |
Trả lại | |
---|---|
String | String của tất cả các cờ GTest sẽ được chuyển tới GTest |
Ném | |
---|---|
DeviceNotAvailableException |
lấy cấu hình
protected IConfiguration getConfiguration ()
Trả về cấu hình thử nghiệm.
Trả lại | |
---|---|
IConfiguration | một cấu hình I |
getExceptionMessage
protected String getExceptionMessage (Exception e)
Cố gắng hết sức để truy xuất thông báo mô tả ngắn có ý nghĩa cho Exception
nhất định
Thông số | |
---|---|
e | Exception : Exception |
Trả lại | |
---|---|
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 tới nhị phân gtest trên thiết bị |
flags | String : cờ thực thi gtest |
Trả lại | |
---|---|
String | dòng lệnh shell để chạy 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 |
Trả lại | |
---|---|
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 theo tên hàm (ví dụ: "Kiểm tra" của Google Test); tất cả các "Trường hợp thử nghiệm" của Thử nghiệm 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ị. |
Trả lại | |
---|---|
String | cờ bộ lọc đầy đủ để chuyển đến kiểm tra g 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 lần kiểm tra trùng lặp nếu mDisabledDuplicateCheck sai. Ngược lại, trả về trình nghe được truyền vào.
Thông số | |
---|---|
listener | ITestInvocationListener |
Trả lại | |
---|---|
ITestInvocationListener |
bộ lọc tải
protected abstract String loadFilter (String path)
Xác định phương thức lọc get.
Lớp con phải triển khai cách lấy bộ lọc riêng.
Thông số | |
---|---|
path | String : đường dẫn đầy đủ của file bộ lọc. |
Trả lại | |
---|---|
String | chuỗi lọc. |
Ném | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
Đặt xem GTest có nên chạy thử nghiệm bị vô hiệu hóa hay không.
Thông số | |
---|---|
runDisabled | boolean |