自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

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

DeviceTestCase

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()` 刪除目前追蹤的所有包含註解。
`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)` 插入測試中的裝置。

欄位

mExcludeAnnotation

protected  mExcludeAnnotation

要執行的測試的排除註解

mExcludeFilters

protected  mExcludeFilters

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

mIncludeAnnotation

protected  mIncludeAnnotation

要執行的測試的註解

mIncludeFilters

protected  mIncludeFilters

要執行的測試名稱的納入篩選器

公用建構函式

DeviceTestCase

public DeviceTestCase ()

DeviceTestCase

public DeviceTestCase (String name)

參數
`name`	`String`

公用方法

addAllExcludeAnnotation

public void addAllExcludeAnnotation ( notAnnotations)

新增 ERROR(/Set) 註解，以便在測試標示為排除時使用。

參數
`notAnnotations`

addAllExcludeFilters

public void addAllExcludeFilters ( filters)

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

參數
`filters`

addAllIncludeAnnotation

public void addAllIncludeAnnotation ( annotations)

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

參數
`annotations`

addAllIncludeFilters

public void addAllIncludeFilters ( filters)

新增篩選器的 ERROR(/Set)，用於指定要納入哪些測試。

參數
`filters`

addExcludeAnnotation

public void addExcludeAnnotation (String notAnnotation)

新增註解，用於排除標示為此註解的測試。

參數
`notAnnotation`	`String`

addExcludeFilter

public void addExcludeFilter (String filter)

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

參數
`filter`	`String`

addIncludeAnnotation

public void addIncludeAnnotation (String annotation)

新增註解，用於在測試標記為此註解時加入。

參數
`annotation`	`String`

addIncludeFilter

public void addIncludeFilter (String filter)

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

參數
`filter`	`String`

clearExcludeAnnotations

public void clearExcludeAnnotations ()

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

clearExcludeFilters

public void clearExcludeFilters ()

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

clearIncludeAnnotations

public void clearIncludeAnnotations ()

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

clearIncludeFilters

public void clearIncludeFilters ()

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

countTestCases

public int countTestCases ()

傳回
`int`

getDevice

public ITestDevice getDevice ()

取得測試裝置。

傳回
`ITestDevice`	`ITestDevice`

getExcludeAnnotations

public  getExcludeAnnotations ()

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

傳回

getExcludeFilters

public  getExcludeFilters ()

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

傳回

getIncludeAnnotations

public  getIncludeAnnotations ()

傳回要納入的註解目前的 ERROR(/Set)。

傳回

getIncludeFilters

public  getIncludeFilters ()

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

傳回

得分

public void run (TestResult result)

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

JUnit 架構僅支援在 TestSuite 中包裝 TestCase，以便執行 TestCase 中的所有測試。不幸的是，使用這個機制時，呼叫端無法控制自身測試案例的生命週期，因此無法執行像是讓 tradefed 設定架構將選項插入測試案例的操作。

參數
`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`