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

執行檔 BaseTest

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

java.lang.Object
↳	com.android.tradefed.testtype.binary.ExecutableBaseTest

已知直接子類別

ExecutableHostTest、ExecutableTargetTest

ExecutableHostTest	測試在主機上執行的執行檔的執行器。
ExecutableTargetTest	針對在目標上執行的執行檔測試執行器。

已知間接子類別

KUnitModuleTest、KernelTargetTest

KUnitModuleTest	測試執行器，用於在裝置上執行 KUnit 測試模組。
KernelTargetTest	執行可執行檔於目標的測試執行器，並剖析核心測試。

測試可執行樣式的基礎類別。例如：二進位檔、殼層指令碼。

摘要

欄位
`public static final String`	`NO_BINARY_ERROR`

公用建構函式
`ExecutableBaseTest()`

公用方法
`void`	`addAllExcludeFilters( filters)` 新增要排除測試的篩選器 `ERROR(/Set)`。
`void`	`addAllIncludeFilters( filters)` 新增要納入測試的篩選器 `ERROR(/Set)`。
`void`	`addExcludeFilter(String filter)` 新增篩選器，篩選出要排除的測試。
`void`	`addIncludeFilter(String filter)` 新增篩選器，選取要納入的測試。
`void`	`clearExcludeFilters()` 刪除目前追蹤的所有「排除」篩選器。
`void`	`clearIncludeFilters()` 刪除目前追蹤的所有「包含」篩選器。
`abstract String`	`findBinary(String binary)` 搜尋要執行該二進位檔的二進位檔。
`IAbi`	`getAbi()`
`boolean`	`getCollectTestsOnly()`
	`getExcludeFilters()` 傳回目前 `ERROR(/Set)` 的「排除」篩選器。
	`getIncludeFilters()` 傳回「包含」篩選器的目前 `ERROR(/Set)`。
`final long`	`getRuntimeHint()` 傳回測試的預期執行階段，毫秒。
	`reportDependencies()`
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` 執行測試，並將結果回報給事件監聽器。
`abstract void`	`runBinary(String binaryPath, ITestInvocationListener listener, TestDescription description)` 確實在指定路徑執行二進位檔。
`final void`	`setAbi(IAbi abi)`
`final void`	`setCollectTestsOnly(boolean shouldCollectTest)` 啟用或停用測試收集模式
`void`	`setConfiguration(IConfiguration configuration)` 插入使用中的 `IConfiguration`。
`final`	`split(int shardHint)` `split()` 的替代版本，該版本也提供要嘗試的 shardCount 要在哪個 Pod 執行

保護方法
`boolean`	`doesRunBinaryGenerateTestResults()`
`IConfiguration`	`getConfiguration()` 傳回測試設定。
`TestDescription[]`	`getFilterDescriptions( testCommands)`
`String`	`getModuleId(IInvocationContext context)`
`long`	`getTimeoutPerBinaryMs()`

欄位

NO_BINARY_ERROR

public static final String NO_BINARY_ERROR

公用建構函式

執行檔 BaseTest

public ExecutableBaseTest ()

公用方法

加入所有排除篩選器

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

刪除目前追蹤的所有「排除」篩選器。

ClearIncludeFilters

public void clearIncludeFilters ()

刪除目前追蹤的所有「包含」篩選器。

尋找二進位檔

public abstract String findBinary (String binary)

搜尋要執行該二進位檔的二進位檔。

參數
`binary`	`String`：二進位檔的路徑或單純的二進位檔名稱。

傳回
`String`	二進位檔的路徑；如果找不到，則傳回空值。

擲回
`DeviceNotAvailableException`

getAbi

public IAbi getAbi ()

傳回
`IAbi`

getCollectTestsOnly

public boolean getCollectTestsOnly ()

傳回
`boolean`

取得排除篩選器

public  getExcludeFilters ()

傳回目前 ERROR(/Set) 的「排除」篩選器。

傳回

getIncludeFilters

public  getIncludeFilters ()

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

傳回

getRuntimeHint

public final long getRuntimeHint ()

傳回測試的預期執行階段，毫秒。這個時間可用來平衡資料分割執行作業

傳回
`long`

reportDependencies

public  reportDependencies ()

傳回

得分

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

執行測試，並將結果回報給事件監聽器。

參數
`testInfo`	`TestInformation`：`TestInformation` 物件，包含可執行的實用資訊測試。
`listener`	`ITestInvocationListener`：測試結果的 `ITestInvocationListener`

擲回
`DeviceNotAvailableException`

執行二進位檔

public abstract void runBinary (String binaryPath, 
                ITestInvocationListener listener, 
                TestDescription description)

確實在指定路徑執行二進位檔。

參數
`binaryPath`	`String`：二進位檔的路徑。
`listener`	`ITestInvocationListener`：要回報結果的事件監聽器。
`description`	`TestDescription`：測試中。

擲回
`DeviceNotAvailableException`

SetAbi

public final void setAbi (IAbi abi)

參數
`abi`	`IAbi`

setCollectTestsOnly

public final void setCollectTestsOnly (boolean shouldCollectTest)

啟用或停用測試收集模式

setConfiguration

public void setConfiguration (IConfiguration configuration)

插入使用中的 IConfiguration。

參數
`configuration`	`IConfiguration`

分割

public final  split (int shardHint)

split() 的替代版本，該版本也提供要嘗試的 shardCount 要在哪個 Pod 執行這對於某些無法任意決定的測試執行器而言很實用。

參數
`shardHint`	`int`：嘗試的資料分割數量。

傳回
	一組要單獨執行的子測試，如為測試，則傳回 `null` 目前無法分割

保護方法

doRunBinaryGenerateTestResults

protected boolean doesRunBinaryGenerateTestResults ()

傳回
`boolean`

getConfiguration

protected IConfiguration getConfiguration ()

傳回測試設定。

傳回
`IConfiguration`	一個 IConfiguration

getFilterDescriptions

protected TestDescription[] getFilterDescriptions ( testCommands)

參數
`testCommands`

傳回
`TestDescription[]`

getModuleId

protected String getModuleId (IInvocationContext context)

參數
`context`	`IInvocationContext`

傳回
`String`

getTimeoutPerBinaryMs

protected long getTimeoutPerBinaryMs ()

傳回
`long`	針對每個二進位檔執行的時間限制。