為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將自 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，請使用 android-latest-release。android-latest-release 資訊清單分支版本一律會參照推送至 Android 開放原始碼計畫的最新版本。詳情請參閱「Android 開放原始碼計畫變更」。

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

MoblyBinaryHostTest

public class MoblyBinaryHostTest
extends Object implements IBuildReceiver, IDeviceTest, IRemoteTest, IShardableTest, ITestFilterReceiver

java.lang.Object
↳	com.android.tradefed.testtype.mobly.MoblyBinaryHostTest

主機測試：從 Android 建構系統 (Soong) 執行 mobly python 二進位檔案

摘要

公用建構函式
`MoblyBinaryHostTest()`

公用方法
`void`	`addAllExcludeFilters(Set<String> filters)` 新增要排除的測試篩選器 `Set`。
`void`	`addAllIncludeFilters(Set<String> filters)` 新增要納入測試的篩選器 `Set`。
`void`	`addExcludeFilter(String filter)` 新增要排除的測試篩選器。
`void`	`addIncludeFilter(String filter)` 新增要納入的測試篩選器。
`void`	`clearExcludeFilters()` 刪除目前追蹤的所有排除篩選器。
`void`	`clearIncludeFilters()` 刪除目前追蹤的所有納入篩選器。
`ITestDevice`	`getDevice()` 取得受測裝置。
`Set<String>`	`getExcludeFilters()` 傳回排除篩選器的目前 `Set`。
`Set<String>`	`getIncludeFilters()` 傳回包含篩選器的目前 `Set`。
`final void`	`run(TestInformation testInfo, ITestInvocationListener listener)` Runs the tests, and reports result to the listener.
`void`	`setBuild(IBuildInfo buildInfo)`
`void`	`setDevice(ITestDevice device)` 注入受測裝置。
`Collection<IRemoteTest>`	`split(int shardCountHint)` `split()` 的替代版本，也會提供嘗試執行的 shardCount。

受保護的方法
`String[]`	`buildCommandLineArray(String filePath, String configPath, List<String> tests)`
`String[]`	`buildCommandLineArray(String filePath, String configPath)`
`String[]`	`buildCommandLineForListTests(String filePath)`
`Optional<Pair<List<String>, List<String>>>`	`filterTests(String[] testListLines, String runName, ITestInvocationListener listener)`
`MoblyArtifactReporter`	`getArtifactReporter()`
`String`	`getLogDirAbsolutePath()`
`File`	`getLogDirFile()`
`boolean`	`processYamlTestResults(InputStream inputStream, MoblyYamlResultParser parser, ITestInvocationListener listener, String runName)` Parses Mobly test results and does result reporting.
`void`	`updateConfigFile(InputStream configInputStream, Writer writer)`

公用建構函式

MoblyBinaryHostTest

public MoblyBinaryHostTest ()

公用方法

addAllExcludeFilters

public void addAllExcludeFilters (Set<String> filters)

新增要排除的測試篩選器 Set。

參數
`filters`	`Set`

addAllIncludeFilters

public void addAllIncludeFilters (Set<String> filters)

新增要納入測試的篩選器Set。

參數
`filters`	`Set`

addExcludeFilter

public void addExcludeFilter (String filter)

新增要排除的測試篩選器。

參數
`filter`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

新增要納入的測試篩選條件。

參數
`filter`	`String`

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeFilters

public void clearIncludeFilters ()

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

getDevice

public ITestDevice getDevice ()

取得受測裝置。

傳回
`ITestDevice`	`ITestDevice`

getExcludeFilters

public Set<String> getExcludeFilters ()

傳回排除篩選器的目前 Set。

傳回
`Set<String>`

getIncludeFilters

public Set<String> getIncludeFilters ()

傳回包含篩選器的目前 Set。

傳回
`Set<String>`

得分

public final void run (TestInformation testInfo, 
                ITestInvocationListener listener)

執行測試，並向接聽程式回報結果。

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

setBuild

public void setBuild (IBuildInfo buildInfo)

參數
`buildInfo`	`IBuildInfo`

setDevice

public void setDevice (ITestDevice device)

注入測試裝置。

參數
`device`	`ITestDevice`：要使用的 `ITestDevice`

拆分

public Collection<IRemoteTest> split (int shardCountHint)

split() 的替代版本，也會提供嘗試執行的 shardCount。這項功能適用於有時無法任意決定的測試執行器。

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

傳回
`Collection<IRemoteTest>`	要個別執行的子測試集合，或 `null` 如果測試目前無法分片

受保護的方法

buildCommandLineArray

protected String[] buildCommandLineArray (String filePath, 
                String configPath, 
                List<String> tests)

參數
`filePath`	`String`
`configPath`	`String`
`tests`	`List`

傳回
`String[]`

buildCommandLineArray

protected String[] buildCommandLineArray (String filePath, 
                String configPath)

參數
`filePath`	`String`
`configPath`	`String`

傳回
`String[]`

buildCommandLineForListTests

protected String[] buildCommandLineForListTests (String filePath)

參數
`filePath`	`String`

傳回
`String[]`

filterTests

protected Optional<Pair<List<String>, List<String>>> filterTests (String[] testListLines, 
                String runName, 
                ITestInvocationListener listener)

參數
`testListLines`	`String`
`runName`	`String`
`listener`	`ITestInvocationListener`

傳回
`Optional<Pair<List<String>, List<String>>>`

getArtifactReporter

protected MoblyArtifactReporter getArtifactReporter ()

傳回
`MoblyArtifactReporter`

getLogDirAbsolutePath

protected String getLogDirAbsolutePath ()

傳回
`String`

getLogDirFile

protected File getLogDirFile ()

傳回
`File`

processYamlTestResults

protected boolean processYamlTestResults (InputStream inputStream, 
                MoblyYamlResultParser parser, 
                ITestInvocationListener listener, 
                String runName)

剖析 Mobly 測試結果，並回報結果。

參數
`inputStream`	`InputStream`：讀取 Mobly 測試結果檔案的 InputStream 物件。
`parser`	`MoblyYamlResultParser`：處理 Mobly 測試結果的 MoblyYamlResultParser 物件。
`listener`	`ITestInvocationListener`：ITestInvocationListener 執行個體，可執行各種報表作業。
`runName`	`String`：str，執行的 Mobly 測試二進位檔名稱。

傳回
`boolean`

updateConfigFile

protected void updateConfigFile (InputStream configInputStream, 
                Writer writer)

參數
`configInputStream`	`InputStream`
`writer`	`Writer`

擲回
`HarnessRuntimeException`