GTestBase

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

Hằng số

String FILTER_EXTENSION

String GTEST_FLAG_FILE

String GTEST_FLAG_FILTER

String GTEST_FLAG_LIST_TESTS

String GTEST_FLAG_PRINT_TIME

String GTEST_FLAG_RUN_DISABLED_TESTS

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) bộ lọc mà bạn muốn loại trừ khỏi các kiểm thử.

void addAllIncludeFilters( filters)

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

void addExcludeFilter(String filter)

Thêm bộ lọc để loại trừ các kiểm thử.

void addIncludeFilter(String filter)

Thêm bộ lọc để chọn những kiểm thử cần đưa vào.

String cleanFilter(String filter)
void clearExcludeFilters()

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

void clearIncludeFilters()

Xoá tất cả cá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 các bộ lọc loại trừ.

getFileExclusionFilterRegex()

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

getGTestFlags()

Nhận 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()

Lấy mô-đun kiểm thử gốc Android để chạy.

boolean getRunDisabledTests()

Lấy xem GTest có nên chạy các 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 kiểm thử 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ỉ mục phân đoạn của bài kiểm thử này.

String getTestFilterKey()

Lấy khoá bộ lọc kiểm thử.

String getTestModule()

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

boolean isCollectTestsOnly()

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 hay không.

boolean isEnableXmlOutput()

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

boolean isSharded()

Lấy cờ isSharded.

void notifyTestExecution(boolean incompleteTestFound, failedTests)

Thông báo cho lớp cha về quá trình thực thi kiểm thử để các bộ lọc loại trừ/bao gồm có thể được xử lý đúng cách 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 dữ liệu thử nghiệm

void setConfiguration(IConfiguration configuration)

Chèn IConfiguration đang 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 kiểm thử này.

void setShardIndex(int shardIndex)

Đặt chỉ mục phân đoạn của kiểm thử này.

split(int shardCountHint)

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

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

String convertName(String gtestFlagName)
String createFlagFile(String filter)

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

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

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

IConfiguration getConfiguration()

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

String getExceptionMessage(Exception e)

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

String getGTestCmdLine(String fullPath, String flags)

Phương thức trợ giúp để tạo lệnh gtest cần 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 công cụ tương tự).

String getGTestFilters(String path)

Trợ giúp để lấy bộ lọc kiểm thử g-test của kiểm thử cần chạy.

ITestInvocationListener getGTestListener(ITestInvocationListener... listeners)

Trả về GTestListener cung cấp thông tin gỡ lỗi bổ sung, chẳng hạn như phát hiện và báo cáo các kiểm thử trùng lặp nếu mDisabledDuplicateCheck là false.

abstract String loadFilter(String path)

Xác định phương thức get filter.

void setRunDisabled(boolean runDisabled)

Đặt xem GTest có chạy các kiểm thử bị vô hiệu hoá hay không.

Hằng số

FILTER_EXTENSION

protected static final String FILTER_EXTENSION

Giá trị không đổi: ".filter"

GTEST_FLAG_FILE

protected static final String GTEST_FLAG_FILE

Giá trị không đổi: "--gtest_flagfile"

GTEST_FLAG_FILTER

protected static final String GTEST_FLAG_FILTER

Giá trị không đổi: "--gtest_filter"

GTEST_FLAG_LIST_TESTS

protected static final String GTEST_FLAG_LIST_TESTS

Giá trị không đổi: "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME

protected static final String GTEST_FLAG_PRINT_TIME

Giá trị không đổi: "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

Giá trị không đổi: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT

protected static final String GTEST_XML_OUTPUT

Giá trị không đổi: "--gtest_output=xml:%s"

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

GTestBase

public GTestBase ()

Phương thức công khai

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

Thêm ERROR(/Set) bộ lọc mà bạn muốn loại trừ khỏi các kiểm thử.

Tham số
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

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

Tham số
filters

addExcludeFilter

public void addExcludeFilter (String filter)

Thêm bộ lọc để loại trừ các kiểm thử.

Tham số
filter String

addIncludeFilter

public void addIncludeFilter (String filter)

Thêm bộ lọc để chọn những kiểm thử cần đưa vào.

Tham số
filter String

cleanFilter

public String cleanFilter (String filter)

Tham số
filter String

Giá trị trả về
String

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeFilters

public void clearIncludeFilters ()

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

getAbi

public IAbi getAbi ()

Giá trị trả về
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

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

Giá trị trả về

getBeforeTestCmd

public  getBeforeTestCmd ()

Nhận(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 các bộ lọc loại trừ.

Giá trị trả về

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

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

Giá trị trả về

getGTestFlags

public  getGTestFlags ()

Nhận 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 ()

Lấy 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 cần chạy hoặc giá trị rỗng nếu chưa được đặt

getRunDisabledTests

public boolean getRunDisabledTests ()

Lấy xem GTest có nên chạy các kiểm thử bị vô hiệu hoá hay không.

Giá trị trả về
boolean True nếu bạn muốn chạy các kiểm thử bị vô hiệu hoá, false nếu không

getRuntimeHint

public long getRuntimeHint ()

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

Giá trị trả về
long

getShardCount

public int getShardCount ()

Trả về số 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 bài kiểm thử này.

Giá trị trả về
int

getTestFilterKey

public String getTestFilterKey ()

Lấy khoá bộ lọc kiểm thử.

Giá trị trả về
String

getTestModule

public String getTestModule ()

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

Giá trị trả về
String

isCollectTestsOnly

public boolean isCollectTestsOnly ()

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 hay không.

Giá trị trả về
boolean

isEnableXmlOutput

public boolean isEnableXmlOutput ()

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

Giá trị trả về
boolean

isSharded

public boolean isSharded ()

Nhận cờ isSharded.

Giá trị trả về
boolean

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Thông báo cho lớp cha về quá trình thực thi kiểm thử để các bộ lọc loại trừ/bao gồm có thể được xử lý đúng cách cho các lần thử lại.

Tham số
incompleteTestFound boolean

failedTests

setAbi

public void setAbi (IAbi abi)

Tham số
abi IAbi

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

Chèn IConfiguration đang dùng.

Tham số
configuration IConfiguration

setModuleName

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 kiểm thử này.

Tham số
shardCount int

setShardIndex

public void setShardIndex (int shardIndex)

Đặt chỉ mục phân đoạn của kiểm thử này.

Tham số
shardIndex int

tách

public  split (int shardCountHint)

Phiên bản thay thế của split() cũng cung cấp shardCount được cố gắng 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 đôi khi.

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

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

convertName

protected String convertName (String gtestFlagName)

Tham số
gtestFlagName String

Giá trị trả về
String

createFlagFile

protected String createFlagFile (String filter)

Tạo một tệp chứa các bộ lọc sẽ được dùng thông qua --gtest_flagfile để tránh mọi giới hạn về hệ điều hành đối với 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

erasePrependedFileName

protected void erasePrependedFileName ( filters, 
                String filename)

Tham số
filters

filename String

getAllGTestFlags

protected String getAllGTestFlags (String path)

Trợ giúp để lấy tất cả cờ GTest cần 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ác cờ GTest cần được truyền đến GTest
Gửi
DeviceNotAvailableException

getConfiguration

protected IConfiguration getConfiguration ()

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

Giá trị trả về
IConfiguration IConfiguration

getExceptionMessage

protected String getExceptionMessage (Exception e)

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

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 cần chạy.

Tham số
fullPath String: đường dẫn tuyệt đối của hệ thống tệp đế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 công cụ tương tự).

Tham số
fullPath String

flags String

Giá trị trả về
String

getGTestFilters

protected String getGTestFilters (String path)

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

Xin lưu ý rằng bộ lọc chỉ lọc theo tên hàm (ví dụ: Google Test "Test"); tất cả "Test Cases" của Google Test 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 đủ để truyền đến g-test hoặc một chuỗi trống nếu không có cờ nào được chỉ định
Gửi
DeviceNotAvailableException

getGTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

Trả về GTestListener cung cấp thông tin gỡ lỗi bổ sung, chẳng hạn như phát hiện và báo cáo các kiểm thử trùng lặp nếu mDisabledDuplicateCheck là false. Nếu không, phương thức này sẽ trả về trình nghe được truyền vào.

Tham số
listeners ITestInvocationListener

Giá trị trả về
ITestInvocationListener

loadFilter

protected abstract String loadFilter (String path)

Xác định phương thức get filter.

Lớp con phải triển khai cách lấy 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

setRunDisabled

protected void setRunDisabled (boolean runDisabled)

Đặt xem GTest có chạy các kiểm thử bị vô hiệu hoá hay không.

Tham số
runDisabled boolean