Cơ sở kiểm thử GTest

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

java.lang.Object
   ↳ com.android.tradefed.testtype.GTestBase

Lớp cơ sở của gTest

Tóm tắt

Trường

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

Hàm khởi tạo công khai

GTestBase()

Phương thức công khai

void addAllExcludeFilters( filters)

Thêm ERROR(/Set) của các bộ lọc cần loại trừ.

void addAllIncludeFilters( filters)

Thêm ERROR(/Set) của các bộ lọc kiểm thử cần đưa vào.

void addExcludeFilter(String filter)

Thêm bộ lọc về các thử nghiệm cần loại trừ.

void addIncludeFilter(String filter)

Thêm bộ lọc chứa các bài kiểm thử cần đưa vào.

String cleanFilter(String filter)
void clearExcludeFilters()

Xoá tất cả bộ lọc loại trừ hiện đang được theo dõi.

void clearIncludeFilters()

Xoá tất cả bộ lọc bao gồm hiện đang đượ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ề ERROR(/Set) hiện tại của bộ lọc loại trừ.

getFileExclusionFilterRegex()

Nhận biểu thức chính quy để loại trừ một số tệp nhất định khỏi quá trình thực thi.

getGTestFlags()

Lấy các giá trị cờ bổ sung để truyền đến lệnh shell của kiểm thử gốc.

getIncludeFilters()

Trả về ERROR(/Set) hiện tại của bộ lọc bao gồm.

long getMaxTestTimeMs()

Lấy thời gian tối đa để chạy một gtest.

String getModuleName()

Tải mô-đun kiểm thử gốc Android để chạy.

boolean getRunDisabledTests()

Tìm hiểu xem GTest có nên chạy chương trình kiểm thử bị vô hiệu hoá hay không.

long getRuntimeHint()

Trả về thời gian chạy dự kiến của bài kiểm thử trong mili giây.

int getShardCount()

Trả về số lượng phân đoạn hiện tại.

int getShardIndex()

Lấy chỉ mục phân đoạn của chương trình kiểm thử này.

String getTestFilterKey()

Lấy khoá bộ lọc thử nghiệm.

String getTestModule()

Lấy tên mô-đun.

boolean isCollectTestsOnly()

Nhận chỉ gọi tệp nhị phân kiểm thử để thu thập danh sách các trường hợp kiểm thử có thể áp dụng hoặc không.

boolean isEnableXmlOutput()

Các gets có sử dụng đầu ra xml gtest cho kết quả kiểm thử hay không.

boolean isSharded()

Cờ Gets isSharded.

void notifyTestExecution(boolean incompleteTestFound, failedTests)

Thông báo cho cấp độ gốc về quá trình chạy thử nghiệm để có thể xử lý đúng cách các bộ lọc bao gồm/loại trừ cho các lần thử lại.

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)

Chèn IConfiguration đang sử dụng.

void setModuleName(String moduleName)

Đặt mô-đun kiểm thử gốc Android để chạy.

void setShardCount(int shardCount)

Đặt số lượng phân đoạn của chương trình kiểm thử này.

void setShardIndex(int shardIndex)

Đặt chỉ mục phân đoạn của chương trình kiểm thử này.

split(int shardCountHint)

Phiên bản thay thế của split() cũng cung cấp shardCount được thử cần chạy.

Phương thức được bảo vệ

String createFlagFile(String filter)

Tạo một tệp chứa các bộ lọc sẽ được dùng qua --gtest_flagfile để tránh mọi hệ điều hành giới hạn về kích thước đối số.

void erasePrependedFileName( filters, String filename)
String getAllGTestFlags(String path)

Trình trợ giúp để lấy tất cả cờ GTest để truyền vào lệnh shell adb.

IConfiguration getConfiguration()

Trả về cấu hình kiểm thử.

String getExceptionMessage(Exception e)

Hãy cố gắng hết sức để truy xuất một thông báo mô tả ngắn gọn có ý nghĩa cho Exception

String getGTestCmdLine(String fullPath, String flags)

Phương thức trợ giúp để tạo 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 bao bọc lệnh gtest trong một số công cụ khác (chroot, strace, gdb và các dịch vụ tương tự).

String getGTestFilters(String path)

Trợ giúp chạy bộ lọc kiểm thử g-test.

ITestInvocationListener getGTestListener(ITestInvocationListener listener)

Trả về GTestListener cung cấp thêm thông tin gỡ lỗi, chẳng hạn như tính năng phát hiện và báo cáo các lượt kiểm thử trùng lặp nếu mDisabledDuplicateCheck có giá trị là false (sai).

abstract String loadFilter(String path)

Xác định phương thức lọc.

void setRunDisabled(boolean runDisabled)

Thiết lập xem GTest có chạy kiểm thử đã tắt hay không.

Trường

BỘ LỌC_TIỀN

protected static final String FILTER_EXTENSION

Hàm GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

Bộ lọc GTEST_FLAG

protected static final String GTEST_FLAG_FILTER

Hàm GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

Hàm GTEST_FLAG_Print_TIME

protected static final String GTEST_FLAG_PRINT_TIME

Hàm GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

Hàm GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Hàm khởi tạo công khai

Cơ sở kiểm thử GTest

public GTestBase ()

Phương thức công khai

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Thêm ERROR(/Set) của các bộ lọc cần loại trừ.

Tham số
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Thêm ERROR(/Set) của các bộ lọc kiểm thử cần đưa vào.

Tham số
filters

thêmLoại trừ Bộ lọc

public void addExcludeFilter (String filter)

Thêm bộ lọc về các thử nghiệm cần loại trừ.

Tham số
filter String

thêmBao gồmBộ lọc

public void addIncludeFilter (String filter)

Thêm bộ lọc chứa các bài kiểm thử cần đưa vào.

Tham số
filter String

làm sạch bộ lọc

public String cleanFilter (String filter)

Tham số
filter String

Giá trị trả về
String

clearExcludeFilters

public void clearExcludeFilters ()

Xoá tất cả bộ lọc loại trừ hiện đang được theo dõi.

clearIncludeFilters

public void clearIncludeFilters ()

Xoá tất cả bộ lọc bao gồm hiện đang được theo dõi.

getAbi

public IAbi getAbi ()

Giá trị trả về
IAbi

getSauTestCmd

public  getAfterTestCmd ()

Nhận(các) lệnh shell để chạy sau GTest.

Giá trị trả về

gettrướcTestCmd

public  getBeforeTestCmd ()

Lấy(các) lệnh shell để chạy trước GTest.

Giá trị trả về

getExcludeFilters

public  getExcludeFilters ()

Trả về ERROR(/Set) hiện tại của bộ lọc loại trừ.

Giá trị trả về

getFileExcludeFilterRegex

public  getFileExclusionFilterRegex ()

Nhận biểu thức chính quy để loại trừ một số tệp nhất định khỏi quá trình thực thi.

Giá trị trả về

getGTestGắn cờ

public  getGTestFlags ()

Lấy các giá trị cờ bổ sung để truyền đến lệnh shell của kiểm thử gốc.

Giá trị trả về

getIncludeFilters

public  getIncludeFilters ()

Trả về ERROR(/Set) hiện tại của bộ lọc bao gồm.

Giá trị trả về

getMaxTestTimeMs

public long getMaxTestTimeMs ()

Lấy thời gian tối đa để chạy một gtest.

Giá trị trả về
long

getModuleName

public String getModuleName ()

Tải mô-đun kiểm thử gốc Android để chạy.

Giá trị trả về
String tên của mô-đun kiểm thử gốc để chạy hoặc rỗng nếu không được đặt

getRunDisabledTests

public boolean getRunDisabledTests ()

Tìm hiểu xem GTest có nên chạy chương trình kiểm thử bị vô hiệu hoá hay không.

Giá trị trả về
boolean "True" nếu kiểm thử đã tắt, nếu không thì kiểm thử

getRuntimeHint

public long getRuntimeHint ()

Trả về thời gian chạy dự kiến của bài kiểm thử trong mili giây. Thời gian dùng để tải quá trình thực thi được phân đoạn cho số dư tải

Giá trị trả về
long

getShardCount

public int getShardCount ()

Trả về số lượng phân đoạn hiện tại.

Giá trị trả về
int

getShardIndex

public int getShardIndex ()

Lấy chỉ mục phân đoạn của chương trình kiểm thử này.

Giá trị trả về
int

getTestFilterKey

public String getTestFilterKey ()

Lấy khoá bộ lọc thử nghiệm.

Giá trị trả về
String

getTestModule

public String getTestModule ()

Lấy tên mô-đun.

Giá trị trả về
String

Chỉ thu thập kiểm thử

public boolean isCollectTestsOnly ()

Nhận chỉ gọi tệp nhị phân kiểm thử để thu thập danh sách các trường hợp kiểm thử có thể áp dụng hoặc không.

Giá trị trả về
boolean

Đầu ra isEnableXml

public boolean isEnableXmlOutput ()

Các gets có sử dụng đầu ra xml gtest cho kết quả kiểm thử hay không.

Giá trị trả về
boolean

được phân đoạn

public boolean isSharded ()

Cờ Gets isSharded.

Giá trị trả về
boolean

Thông báo kiểm thử

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Thông báo cho cấp độ gốc về hoạt động thực thi thử nghiệm để có thể xử lý đúng cách các bộ lọc bao gồm/loại trừ cho các lần thử lại.

Tham số
incompleteTestFound boolean

failedTests

setAbi

public void setAbi (IAbi abi)

Tham số
abi IAbi

Chỉ setcollectionTests

public void setCollectTestsOnly (boolean shouldCollectTest)

Bật hoặc tắt chế độ thu thập thử nghiệm

Cấu hình đặt

public void setConfiguration (IConfiguration configuration)

Chèn IConfiguration đang sử dụng.

Tham số
configuration IConfiguration

Tên mô-đun

public void setModuleName (String moduleName)

Đặt mô-đun kiểm thử gốc Android để chạy.

Tham số
moduleName String: Tên của mô-đun kiểm thử gốc cần chạy

setShardCount

public void setShardCount (int shardCount)

Đặt số lượng phân đoạn của chương trình kiểm thử này.

Tham số
shardCount int

Chỉ mục setShard

public void setShardIndex (int shardIndex)

Đặt chỉ mục phân đoạn của chương trình kiểm thử này.

Tham số
shardIndex int

cắt video

public  split (int shardCountHint)

Phiên bản thay thế của split() cũng cung cấp shardCount được thử cần chạy. Điều này hữu ích cho một số trình chạy kiểm thử không thể tuỳ ý quyết định.

Tham số
shardCountHint int: số lượng phân đoạn được thử.
Giá trị trả về
một tập hợp các kiểm thử phụ được thực thi riêng biệt hoặc null nếu kiểm thử là hiện không thể phân đoạn

Phương thức được bảo vệ

createflagFile

protected String createFlagFile (String filter)

Tạo một tệp chứa các bộ lọc sẽ được dùng qua --gtest_flagfile để tránh mọi hệ điều hành giới hạn về kích thước đối số.

Tham số
filter String: Chuỗi bộ lọc
Giá trị trả về
String Đường dẫn đến tệp chứa bộ lọc.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

DeletePrepundoFileName (Tên tệp tin xoá trước)

protected void erasePrependedFileName ( filters, 
                String filename)

Tham số
filters

filename String

getAllGTestGắn cờ

protected String getAllGTestFlags (String path)

Trình trợ giúp để lấy tất cả cờ GTest để truyền vào lệnh shell adb.

Tham số
path String: đường dẫn đầy đủ của tệp nhị phân trên thiết bị.
Giá trị trả về
String String của tất cả cờ GTest cần được truyền đến GTest
Gửi
DeviceNotAvailableException

nhận cấu hình

protected IConfiguration getConfiguration ()

Trả về cấu hình kiểm thử.

Giá trị trả về
IConfiguration một IConfiguration

Nhận Tin nhắn ngoại lệ

protected String getExceptionMessage (Exception e)

Hãy cố gắng hết sức để truy xuất một thông báo mô tả ngắn gọn có ý nghĩa cho Exception

Tham số
e Exception: Exception
Giá trị trả về
String một tin nhắn ngắn

getGTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

Phương thức trợ giúp để tạo lệnh gtest để chạy.

Tham số
fullPath String: đường dẫn hệ thống tệp tuyệt đối đến tệp nhị phân gtest trên thiết bị
flags String: cờ thực thi gtest
Giá trị trả về
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 bao bọc lệnh gtest trong một số công cụ khác (chroot, strace, gdb và các dịch vụ tương tự).

Tham số
fullPath String

flags String

Giá trị trả về
String

getGTestFilters

protected String getGTestFilters (String path)

Trợ giúp chạy bộ lọc kiểm thử g-test.

Lưu ý rằng chỉ lọc tên hàm (ví dụ: Google Test "Test"); tất cả sản phẩm của Google Kiểm thử "Trường hợp kiểm thử" sẽ được xem xét.

Tham số
path String: đường dẫn đầy đủ của tệp nhị phân trên thiết bị.
Giá trị trả về
String cờ bộ lọc đầy đủ để chuyển đến g-test hoặc một chuỗi trống nếu không có được chỉ định
Gửi
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

Trả về GTestListener cung cấp thêm thông tin gỡ lỗi, chẳng hạn như tính năng phát hiện và báo cáo các lượt kiểm thử trùng lặp nếu mDisabledDuplicateCheck có giá trị là false (sai). Nếu không, hãy trả về giá trị đã nhập trình nghe.

Tham số
listener ITestInvocationListener

Giá trị trả về
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

Xác định phương thức lọc.

Lớp con phải triển khai cách để có bộ lọc riêng.

Tham số
path String: đường dẫn đầy đủ của tệp bộ lọc.
Giá trị trả về
String chuỗi bộ lọc.
Gửi
DeviceNotAvailableException

Đã tắt setRun

protected void setRunDisabled (boolean runDisabled)

Thiết lập xem GTest có chạy kiểm thử bị vô hiệu hoá hay không.

Tham số
runDisabled boolean