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

裝置測試案例

public class DeviceTestCase
extends MetricTestCase implements IDeviceTest, IRemoteTest, ITestAnnotationFilterReceiver, ITestCollector, ITestFilterReceiver

java.lang.Object
↳	junit.framework.Assert
	↳	junit.framework.TestCase
		↳	com.android.tradefed.testtype.MetricTestCase
			↳	com.android.tradefed.testtype.DeviceTestCase

提供 IRemoteTest 和 IDeviceTest 服務的輔助 JUnit 測試案例。

如要執行遵循定義測試的 JUnit 模式的測試，這個方法就很實用。且仍可完整支援其他換購功能，例如 Option

摘要

欄位
`protected`	`mExcludeAnnotation` 要執行的測試排除註解
`protected`	`mExcludeFilters` 要執行的測試名稱排除篩選器
`protected`	`mIncludeAnnotation` 包含要執行的測試註解
`protected`	`mIncludeFilters` 要執行的測試名稱「包含」篩選器

公用建構函式
`DeviceTestCase()`
`DeviceTestCase(String name)`

公用方法
`void`	`addAllExcludeAnnotation( notAnnotations)` 新增註解的 `ERROR(/Set)`，如果測試有標記的話，將其排除。
`void`	`addAllExcludeFilters( filters)` 新增要排除測試的篩選器 `ERROR(/Set)`。
`void`	`addAllIncludeAnnotation( annotations)` 新增註解的 `ERROR(/Set)`，如果測試有標記的話，則會納入註解。
`void`	`addAllIncludeFilters( filters)` 新增要納入測試的篩選器 `ERROR(/Set)`。
`void`	`addExcludeAnnotation(String notAnnotation)` 如果測試有標記，新增註解以排除。
`void`	`addExcludeFilter(String filter)` 新增篩選器，篩選出要排除的測試。
`void`	`addIncludeAnnotation(String annotation)` 如果測試有標記，則新增註解，並納入該註解。
`void`	`addIncludeFilter(String filter)` 新增篩選器，選取要納入的測試。
`void`	`clearExcludeAnnotations()` 刪除目前追蹤的所有排除註解。
`void`	`clearExcludeFilters()` 刪除目前追蹤的所有「排除」篩選器。
`void`	`clearIncludeAnnotations()` 刪除目前追蹤的所有 include 註解。
`void`	`clearIncludeFilters()` 刪除目前追蹤的所有「包含」篩選器。
`int`	`countTestCases()`
`ITestDevice`	`getDevice()` 取得要測試的裝置。
	`getExcludeAnnotations()` 傳回要排除的註解目前 `ERROR(/Set)`。
	`getExcludeFilters()` 傳回目前 `ERROR(/Set)` 的「排除」篩選器。
	`getIncludeAnnotations()` 傳回要包含的註解目前 `ERROR(/Set)`。
	`getIncludeFilters()` 傳回「包含」篩選器的目前 `ERROR(/Set)`。
`void`	`run(TestResult result)` 如果執行的測試方法為空值，覆寫父項方法來執行所有測試方法。
`void`	`run(TestInformation testInfo, ITestInvocationListener listener)` 執行測試，並將結果回報給事件監聽器。
`void`	`setCollectTestsOnly(boolean shouldCollectTest)` 啟用或停用測試收集模式
`void`	`setDevice(ITestDevice device)` 插入要測試的裝置。

欄位

mExclude 註解

protected  mExcludeAnnotation

要執行的測試排除註解

排除篩選器

protected  mExcludeFilters

要執行的測試名稱排除篩選器

mIncludeAnnotation

protected  mIncludeAnnotation

包含要執行的測試註解

mInclude 篩選器

protected  mIncludeFilters

要執行的測試名稱「包含」篩選器

公用建構函式

裝置測試案例

public DeviceTestCase ()

裝置測試案例

public DeviceTestCase (String name)

參數
`name`	`String`

公用方法

新增所有排除註解

public void addAllExcludeAnnotation ( notAnnotations)

新增註解的 ERROR(/Set)，如果測試有標記的話，將其排除。

參數
`notAnnotations`

加入所有排除篩選器

public void addAllExcludeFilters ( filters)

新增要排除測試的篩選器 ERROR(/Set)。

參數
`filters`

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

新增註解的 ERROR(/Set)，如果測試有標記的話，則會納入註解。

參數
`annotations`

加入所有篩選器

public void addAllIncludeFilters ( filters)

新增要納入測試的篩選器 ERROR(/Set)。

參數
`filters`

新增排除註解

public void addExcludeAnnotation (String notAnnotation)

如果測試有標記，新增註解以排除。

參數
`notAnnotation`	`String`

新增排除篩選器

public void addExcludeFilter (String filter)

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

參數
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

如果測試有標記，則新增註解，並納入該註解。

參數
`annotation`	`String`

加入篩選器

public void addIncludeFilter (String filter)

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

參數
`filter`	`String`

ClearExcludeAnnotations (明確排除註解)

public void clearExcludeAnnotations ()

刪除目前追蹤的所有排除註解。

清除排除篩選器

public void clearExcludeFilters ()

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

ClearIncludeAnnotation

public void clearIncludeAnnotations ()

刪除目前追蹤的所有 include 註解。

ClearIncludeFilters

public void clearIncludeFilters ()

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

計數測試案例

public int countTestCases ()

傳回
`int`

getDevice

public ITestDevice getDevice ()

取得要測試的裝置。

傳回
`ITestDevice`	`ITestDevice`

getExcludeAnnotations (排除註解)

public  getExcludeAnnotations ()

傳回要排除的註解目前 ERROR(/Set)。

傳回

取得排除篩選器

public  getExcludeFilters ()

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

傳回

getIncludeAnnotations

public  getIncludeAnnotations ()

傳回要包含的註解目前 ERROR(/Set)。

傳回

getIncludeFilters

public  getIncludeFilters ()

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

傳回

得分

public void run (TestResult result)

如果執行的測試方法為空值，覆寫父項方法來執行所有測試方法。

JUnit 架構只能用來在 TestCase 內執行所有測試，方法是將其納入 TestSuite：遺憾的是，這個機制呼叫端無法控制因此無法完成交易設定或測試案例將選項插入測試案例

參數
`result`	`TestResult`

得分

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

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

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

擲回
`DeviceNotAvailableException`

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

啟用或停用測試收集模式

setDevice

public void setDevice (ITestDevice device)

插入要測試的裝置。

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