Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Trang này được dịch bởi Cloud Translation API.

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

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 các bộ lọc kiểm thử cần đưa vào.
`void`	`addExcludeFilter(String filter)` Thêm bộ lọc về những 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 để chuyể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()` Xem liệu 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 chương trình 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ác gets 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 cấp độ gốc về phiên chạy thử nghiệm để có thể xử lý các bộ lọc bao gồm/loại trừ đú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 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 đã cố gắng 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 thông qua --gtest_flagfile để tránh mọi giới hạn về hệ điều hành 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)` 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át 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

Hàm 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 các bộ lọc kiểm thử cần đưa vào.

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ề

gettrướcTestCmd

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

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 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 chương trình 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 ()

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`

isSharded

public boolean isSharded ()

Lấy cờ isSharded.

Giá trị trả về
`boolean`

Thông báo kiểm thử

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`

Chỉ setthuTests

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`

Tên mô-đun

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`

Chỉ mục setShard

public void setShardIndex (int shardIndex)

Đặt chỉ mục phân đoạn của 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 mà bạn đang cố gắng chạy. Điều này rất 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ụ được thực thi riêng biệt hoặc `null` nếu chương trình kiểm thử 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 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`

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

getExceptionMessage

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 đã 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 để 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`

Đã tắt setRun

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`