GTestBase

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

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

Các lớp con trực tiếp đã biết GTest, HostGTest GTest Một chương trình kiểm thử chạy một gói kiểm thử gốc trên một thiết bị nhất định.  HostGTest Một chương trình kiểm thử chạy một gói kiểm thử gốc.

Các lớp con gián tiếp đã biết ArtGTest ArtGTest

---

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 bộ lọc về các kiểm thử cần loại trừ.
void	addAllIncludeFilters( filters) Thêm ERROR(/Set) của bộ lọc bao gồm các kiểm thử.
void	addExcludeFilter(String filter) Thêm bộ lọc về các chương trình kiểm thử cần loại trừ.
void	addIncludeFilter(String filter) Thêm bộ lọc về các 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() Lấy(các) lệnh shell để chạy sau GTest.
	getBeforeTestCmd() Lấy(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() Lấy 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() 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 gtest.
String	getModuleName() Chạy mô-đun kiểm thử gốc Android.
boolean	getRunDisabledTests() Xác định xem GTest có nên chạy các chương trình kiểm thử bị tắt 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 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() Xác định xem 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 thành phần mẹ về việc thực thi kiểm thử để có thể xử lý đúng cách các bộ lọc đưa vào/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 kiểm thử
void	setConfiguration(IConfiguration configuration) Chèn IConfiguration đang sử dụng.
void	setModuleName(String moduleName) Thiết lập 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 mà bạn đang 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 sử dụng thông qua --gtest_flagfile để tránh mọi giới hạn về kích thước args của hệ điều hành.
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) Cố gắng hết sức để truy xuất thông báo mô tả ngắn có ý nghĩa cho một Exception nhất định
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 phái sinh gói 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ình trợ giúp để lấy bộ lọc kiểm thử g-test của kiểm thử để chạy.
ITestInvocationListener	getGTestListener(ITestInvocationListener... listeners) Trả về GTestListener cung cấp thêm thông tin gỡ lỗi, 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à sai.
abstract String	loadFilter(String path) Xác định phương thức lọc get.
void	setRunDisabled(boolean runDisabled) Đặt xem GTest có chạy các chương trình kiểm thử bị tắt hay không.

Trường

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

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) của bộ lọc về các kiểm thử cần loại trừ.

Tham số
filters

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

Thêm ERROR(/Set) của bộ lọc bao gồm các kiểm thử.

Tham số
filters

addExcludeFilter

public void addExcludeFilter (String filter)

Thêm bộ lọc về các chương trình kiểm thử cần loại trừ.

Tham số
filter	String

addIncludeFilter

public void addIncludeFilter (String filter)

Thêm bộ lọc về các 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ả 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

getAfterTestCmd

public  getAfterTestCmd ()

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

Giá trị trả về

getBeforeTestCmd

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ề

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Lấy 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.

Giá trị trả về

getGTestFlags

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 gtest.

Giá trị trả về
long

getModuleName

public String getModuleName ()

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

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

getRunDisabledTests

public boolean getRunDisabledTests ()

Xác định xem GTest có nên chạy các chương trình kiểm thử bị tắt hay không.

Giá trị trả về
boolean	Đúng nếu bạn nên chạy các kiểm thử bị vô hiệu hoá, sai 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 để tải cân bằng quá trình thực thi phân đoạn

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 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 ()

Xác định xem 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 ()

Lấy cờ isSharded.

Giá trị trả về
boolean

notifyTestExecution

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

Thông báo cho thành phần mẹ về việc thực thi kiểm thử để có thể xử lý đúng cách các bộ lọc đưa vào/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

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

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

Tham số
configuration	IConfiguration

setModuleName

public void setModuleName (String moduleName)

Thiết lập 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 mà bạn đang cố gắng chạy. Điều này hữu ích cho một số trình chạy kiểm thử đôi khi không thể quyết định tuỳ ý.

Tham số
shardCountHint	int: số lượng phân mảnh đã thử.

Giá trị trả về
	một tập hợp các chương trình kiểm thử phụ sẽ được thực thi riêng biệt hoặc null nếu chương trình 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 sử dụng thông qua --gtest_flagfile để tránh mọi giới hạn về kích thước args của hệ điều hành.

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ì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

getConfiguration

protected IConfiguration getConfiguration ()

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

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

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 một Exception nhất định

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 phái sinh gói 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ình trợ giúp để lấy bộ lọc kiểm thử g-test của kiểm thử để chạy.

Xin lưu ý rằng bộ lọc chỉ lọc theo tên hàm (ví dụ: "Kiểm thử" của Google Test); tất cả "Kiểm thử" 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 kiểm thử g 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êm thông tin gỡ lỗi, 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à sai. Nếu không, hãy trả về trình nghe đã 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 lọc get.

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

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 chương trình kiểm thử bị tắt hay không.

Tham số
runDisabled	boolean