本頁面由 Cloud Translation API 翻譯而成。

測試庫

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

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

已知的直接子類

主機 G測試

測試	在給定設備上執行本機測試包的測試。
主機G測試	執行本機測試包的測試。

已知的間接子類

藝術G測試

gTest的基底類

概括

領域
`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`

公共構造函數
`GTestBase ()`

公共方法
`void`	`addAllExcludeFilters ( filters)` `addAllExcludeFilters ( filters)` 新增要排除的測試的過濾器的`ERROR(/Set)` 。
`void`	`addAllIncludeFilters ( filters)` `addAllIncludeFilters ( filters)` 新增要包含的測試的過濾器的`ERROR(/Set)` 。
`void`	`addExcludeFilter (String filter)` 新增要排除的測試的過濾器。
`void`	`addIncludeFilter (String filter)` 新增要包含的測試的過濾器。
`String`	`cleanFilter (String filter)`
`void`	`clearExcludeFilters ()` 刪除目前追蹤的所有排除過濾器。
`void`	`clearIncludeFilters ()` 刪除目前追蹤的所有包含過濾器。
`IAbi`	`getAbi ()`
	`getAfterTestCmd ()` 取得在 GTest 之後運行的 shell 命令。
	`getBeforeTestCmd ()` 取得在 GTest 之前執行的 shell 命令。
	`getExcludeFilters ()` 傳回排除過濾器的目前`ERROR(/Set)` 。
	`getFileExclusionFilterRegex ()` 取得正規表示式以排除某些文件的執行。
	`getGTestFlags ()` 取得要傳遞給本機測試的 shell 指令的其他標誌值。
	`getIncludeFilters ()` 傳回包含篩選器的目前`ERROR(/Set)` 。
`long`	`getMaxTestTimeMs ()` 取得 gtest 運行的最長時間。
`String`	`getModuleName ()` 取得要運行的 Android 本機測試模組。
`boolean`	`getRunDisabledTests ()` 取得 GTest 是否應該執行已停用的測試。
`long`	`getRuntimeHint ()` 傳回測試的預期運行時間（以毫秒為單位）。
`int`	`getShardCount ()` 返回當前分片計數。
`int`	`getShardIndex ()` 取得本次測試的分片索引。
`String`	`getTestFilterKey ()` 取得測試過濾器金鑰。
`String`	`getTestModule ()` 取得模組名稱。
`boolean`	`isCollectTestsOnly ()` 僅取得呼叫測試二進位檔案來收集適用測試案例的清單。
`boolean`	`isEnableXmlOutput ()` 取得是否使用 gtest xml 輸出來取得測試結果。
`boolean`	`isSharded ()` 取得 isSharded 標誌。
`void`	`notifyTestExecution (boolean incompleteTestFound, failedTests)` `notifyTestExecution (boolean incompleteTestFound, failedTests)` 通知父級測試執行，以便可以正確處理重試嘗試的包含/排除過濾器。
`void`	`setAbi ( IAbi abi)`
`void`	`setCollectTestsOnly (boolean shouldCollectTest)` 啟用或停用測試收集模式
`void`	`setConfiguration ( IConfiguration configuration)` 注入正在使用的`IConfiguration` 。
`void`	`setModuleName (String moduleName)` 設定Android本機測試模組運作。
`void`	`setShardCount (int shardCount)` 設定此測試的分片計數。
`void`	`setShardIndex (int shardIndex)` 設定本次測試的分片索引。
	`split (int shardCountHint)` `split()`的替代版本還提供嘗試運行的 shardCount。

受保護的方法
`String`	`createFlagFile (String filter)` 建立一個包含將通過 --gtest_flagfile 使用的過濾器的文件，以避免 args 大小的任何作業系統限制。
`void`	`erasePrependedFileName ( filters, String filename)` `erasePrependedFileName ( filters, String filename)`
`String`	`getAllGTestFlags (String path)` 幫助程式取得所有 GTest 標誌以傳遞到 adb shell 命令中。
`IConfiguration`	`getConfiguration ()` 返回測試配置。
`String`	`getExceptionMessage (Exception e)` 盡最大努力嘗試為給定的`Exception`有意義的簡短描述性訊息
`String`	`getGTestCmdLine (String fullPath, String flags)` 建立要執行的 gtest 命令的幫助程式方法。
`String`	`getGTestCmdLineWrapper (String fullPath, String flags)` 幫助器，允許衍生類別將 gtest 指令包裝在其他工具（chroot、strace、gdb 等）下。
`String`	`getGTestFilters (String path)` 幫助程式讓測試的 g-test 過濾器運作。
`ITestInvocationListener`	`getGTestListener ( ITestInvocationListener listener)` 傳回提供額外偵錯資訊的 GTestListener，例如在 mDisabledDuplicateCheck 為 false 時檢測並報告重複測試。
`abstract String`	`loadFilter (String path)` 定義獲取過濾器方法。
`void`	`setRunDisabled (boolean runDisabled)` 設定 GTest 是否應執行已停用的測試。

領域

過濾器擴展

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_輸出

protected static final String GTEST_XML_OUTPUT

公共構造函數

測試庫

public GTestBase ()

公共方法

新增所有排除過濾器

public void addAllExcludeFilters ( filters)

新增要排除的測試的過濾器的ERROR(/Set) 。

參數
`filters`

添加所有包含過濾器

public void addAllIncludeFilters ( filters)

新增要包含的測試的過濾器的ERROR(/Set) 。

參數
`filters`

新增排除過濾器

public void addExcludeFilter (String filter)

新增要排除的測試的過濾器。

參數
`filter`	`String`

新增包含過濾器

public void addIncludeFilter (String filter)

新增要包含的測試的過濾器。

參數
`filter`	`String`

清潔過濾器

public String cleanFilter (String filter)

參數
`filter`	`String`

退貨
`String`

清除排除過濾器

public void clearExcludeFilters ()

刪除目前追蹤的所有排除過濾器。

清除包含過濾器

public void clearIncludeFilters ()

刪除目前追蹤的所有包含過濾器。

獲取阿比

public IAbi getAbi ()

退貨
`IAbi`

取得測試後命令

public  getAfterTestCmd ()

取得在 GTest 之後運行的 shell 命令。

退貨

取得測試前命令

public  getBeforeTestCmd ()

取得在 GTest 之前執行的 shell 命令。

退貨

取得排除過濾器

public  getExcludeFilters ()

傳回排除過濾器的目前ERROR(/Set) 。

退貨

取得檔案排除過濾器正規表示式

public  getFileExclusionFilterRegex ()

取得正規表示式以排除某些文件的執行。

退貨

取得GTestFlags

public  getGTestFlags ()

取得要傳遞給本機測試的 shell 指令的其他標誌值。

退貨

取得包含過濾器

public  getIncludeFilters ()

傳回包含篩選器的目前ERROR(/Set) 。

退貨

取得最大測試時間毫秒

public long getMaxTestTimeMs ()

取得 gtest 運行的最長時間。

退貨
`long`

取得模組名稱

public String getModuleName ()

取得要運行的 Android 本機測試模組。

退貨
`String`	要執行的本機測試模組的名稱，如果未設定則為 null

取得運行禁用測試

public boolean getRunDisabledTests ()

取得 GTest 是否應該執行已停用的測試。

退貨
`boolean`	如果應執行停用的測試，則為 true，否則為 false

取得運行時提示

public long getRuntimeHint ()

傳回測試的預期運行時間（以毫秒為單位）。此時間用於負載平衡分片執行

退貨
`long`

取得分片計數

public int getShardCount ()

返回當前分片計數。

退貨
`int`

取得分片索引

public int getShardIndex ()

取得本次測試的分片索引。

退貨
`int`

取得測試過濾器金鑰

public String getTestFilterKey ()

取得測試過濾器金鑰。

退貨
`String`

取得測試模組

public String getTestModule ()

取得模組名稱。

退貨
`String`

僅收集測試

public boolean isCollectTestsOnly ()

僅取得呼叫測試二進位檔案來收集適用測試案例的清單。

退貨
`boolean`

isEnableXmlOutput

public boolean isEnableXmlOutput ()

取得是否使用 gtest xml 輸出來取得測試結果。

退貨
`boolean`

已分片

public boolean isSharded ()

取得 isSharded 標誌。

退貨
`boolean`

通知測試執行

public void notifyTestExecution (boolean incompleteTestFound, 
                 failedTests)

通知父級測試執行，以便可以正確處理重試嘗試的包含/排除過濾器。

參數
`incompleteTestFound`	`boolean`
`failedTests`

設定阿比

public void setAbi (IAbi abi)

參數
`abi`	`IAbi`

僅設定收集測試

public void setCollectTestsOnly (boolean shouldCollectTest)

啟用或停用測試收集模式

設定配置

public void setConfiguration (IConfiguration configuration)

注入正在使用的IConfiguration 。

參數
`configuration`	`IConfiguration`

設定模組名稱

public void setModuleName (String moduleName)

設定Android本機測試模組運作。

參數
`moduleName`	`String` ：要執行的本機測試模組的名稱

設定分片數量

public void setShardCount (int shardCount)

設定此測試的分片計數。

參數
`shardCount`	`int`

設定分片索引

public void setShardIndex (int shardIndex)

設定本次測試的分片索引。

參數
`shardIndex`	`int`

分裂

public  split (int shardCountHint)

split()的替代版本還提供嘗試運行的 shardCount。這對於某些有時無法隨意決定的測試運行者很有用。

參數
`shardCountHint`	`int` ：嘗試的分片計數。

退貨
	要單獨執行的子測試的集合，如果測試目前不可分片，則為`null`

受保護的方法

建立標誌文件

protected String createFlagFile (String filter)

建立一個包含將通過 --gtest_flagfile 使用的過濾器的文件，以避免 args 大小的任何作業系統限制。

參數
`filter`	`String` : 過濾字串

退貨
`String`	包含過濾器的檔案的路徑。

投擲
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

擦除前置檔案名

protected void erasePrependedFileName ( filters, 
                String filename)

參數
`filters`
`filename`	`String`

取得所有GTestFlags

protected String getAllGTestFlags (String path)

幫助程式取得所有 GTest 標誌以傳遞到 adb shell 命令中。

參數
`path`	`String` ：裝置上二進位檔案的完整路徑。

退貨
`String`	應傳遞給 GTest 的所有 GTest 標誌的`String`

投擲
`DeviceNotAvailableException`

取得配置

protected IConfiguration getConfiguration ()

返回測試配置。

退貨
`IConfiguration`	一個 IConfiguration

獲取異常訊息

protected String getExceptionMessage (Exception e)

盡最大努力嘗試為給定的Exception有意義的簡短描述性訊息

參數
`e`	`Exception` ： `Exception`

退貨
`String`	一則簡訊

取得GTestCmdLine

protected String getGTestCmdLine (String fullPath, 
                String flags)

建立要執行的 gtest 命令的幫助程式方法。

參數
`fullPath`	`String` : 裝置上 gtest 二進位檔案的絕對檔案系統路徑
`flags`	`String` : gtest 執行標誌

退貨
`String`	為 gtest 運行的 shell 命令列

取得GTestCmdLineWrapper

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

幫助器，允許衍生類別將 gtest 指令包裝在其他工具（chroot、strace、gdb 等）下。

參數
`fullPath`	`String`
`flags`	`String`

退貨
`String`

取得GTestFilters

protected String getGTestFilters (String path)

幫助程式讓測試的 g-test 過濾器運作。

請注意，過濾器僅過濾函數名稱（例如：Google Test“Test”）；所有 Google 測試「測試用例」都會被考慮。

參數
`path`	`String` ：裝置上二進位檔案的完整路徑。

退貨
`String`	要傳遞給 g-test 的完整過濾器標誌，如果未指定，則為空字串

投擲
`DeviceNotAvailableException`

取得GTestListener

protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)

傳回提供額外偵錯資訊的 GTestListener，例如在 mDisabledDuplicateCheck 為 false 時檢測並報告重複測試。否則，返回傳入的偵聽器。

參數
`listener`	`ITestInvocationListener`

退貨
`ITestInvocationListener`

載入過濾器

protected abstract String loadFilter (String path)

定義獲取過濾器方法。

子類別必須實作如何取得自己的過濾器。

參數
`path`	`String` ：過濾器檔案的完整路徑。

退貨
`String`	過濾字串。

投擲
`DeviceNotAvailableException`

設定運行禁用

protected void setRunDisabled (boolean runDisabled)

設定 GTest 是否應執行已停用的測試。

參數
`runDisabled`	`boolean`