GTestBase

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

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

Các lớp con trực tiếp đã biết GTest , HostGTest GTest Thử nghiệm chạy gói thử nghiệm gốc trên thiết bị nhất định. HostGTest Thử nghiệm chạy gói thử nghiệm gốc.

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

---

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 ERROR(/Set) các bộ lọc mà các thử nghiệm cần loại trừ.
void	addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) Thêm ERROR(/Set) các bộ lọc mà các thử nghiệm sẽ bao gồ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ề ERROR(/Set) bộ lọc loại trừ hiện tại.
	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ề ERROR(/Set) hiện tại của các bộ lọc bao gồm.
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) IConfiguration đang sử dụng.
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 split() cũng cung cấp shardCount đang cố gắng chạy.

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 Exception đã 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 thử nghiệm trùng lặp nếu mDisabledDuplicateCheck là sai.
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.

getAbi

public IAbi getAbi ()

Lợi nhuận
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

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

Lợi nhuận

getBeforeTestCmd

public  getBeforeTestCmd ()

Cho phép (các) lệnh shell chạy trước GTest.

Lợi nhuận

getExcludeFilters

public  getExcludeFilters ()

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

Lợi nhuận

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Gets regex để loại trừ các tệp nhất định khỏi việc thực thi.

Lợi nhuận

getGTestFlags

public  getGTestFlags ()

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

public  getIncludeFilters ()

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

setAbi

public void setAbi (IAbi abi)

Thông số
abi	IAbi

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

public  split (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