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

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

IDisableable

public interface IDisableable

com.android.tradefed.util.IDisableable

已知間接子類別

AdbStopServerPreparer、AggregatePostProcessor、AllTestAppsInstallSetup、AoaTargetPreparer、AppSetup、ArtChrootPreparer、AtraceCollector、AtraceRunMetricCollector、AveragePostProcessor、BaseDeviceMetricCollector、BaseEmulatorPreparer、BaseMultiTargetPreparer、BasePostProcessor、BaseTargetPreparer、BluetoothConnectionLatencyCollector 和其他 136 個。

AdbStopServerPreparer	指定準備工具，在執行 ADB 測試前後停止主機上的 ADB 伺服器。
AggregatePostProcessor	指標匯總工具，可針對在多次迭代測試執行期間收集到的數值指標，提供最小值、最大值、平均值、變異數、標準差、總數、計數，以及選用的百分位數，並將這些值視為雙精度浮點值。
AllTestAppsInstallSetup	將 `IDeviceBuildInfo.getTestsDir()` 資料夾中的所有應用程式安裝到裝置上的 `ITargetPreparer`。
AoaTargetPreparer	`ITargetPreparer`，可使用 Android Open Accessory (AOAv2) 通訊協定執行一系列動作 (例如點擊和滑動)。
AppSetup	用於安裝 APK 及其測試的 `ITargetPreparer`。
ArtChrootPreparer	為 ART 測試建立 chroot 目錄。
AtraceCollector	`IMetricCollector` 會在測試期間執行 atrace，並收集結果並記錄至叫用作業。
AtraceRunMetricCollector	從測試裝置的特定目錄下收集所有測試目錄的追蹤記錄，記錄測試目錄，並對測試目錄下方的追蹤記錄檔案進行後置處理，然後匯總指標。
AveragePostProcessor	實作後置處理器，計算指標清單的平均值。
BaseDeviceMetricCollector	`IMetricCollector` 的基本實作項目，可在 `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)` 和 `ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))` 上開始及停止收集。
BaseEmulatorPreparer	用於啟動本機模擬器的通用準備工具。
BaseMultiTargetPreparer	可停用物件的 `IMultiTargetPreparer` 基本實作項目。
BasePostProcessor	每個實作項目都應擴充的基本 `IPostProcessor`。
BaseTargetPreparer	`ITargetPreparer` 的基本實作類別，可用於控制物件是否已停用。
BluetoothConnectionLatencyCollector	收集器會將預先定義的 statsd 持續時間指標設定推送至裝置，並收集每個設定檔的藍牙連線時間。
BluetoothConnectionStateCollector	這個收集器會收集 BluetoothConnectionStateChanged 指標，並記錄每個設定檔的連線狀態編號。
BluetoothConnectionSuccessRatePostProcessor	實作後置處理器，計算藍牙設定檔的成功率使用「metric-key-match」指定指標，這些指標會在數值陣列中包含藍牙連線狀態，範例為 [0, 1, 2, 3, 0, 1, 2, 3]。
BluetoothHciSnoopLogCollector	收集器，可在 DUT 上啟用藍牙 HCI 窺探記錄，並收集每項測試的記錄。
BugreportzOnFailureCollector	在測試案例失敗時收集錯誤報告。
BugreportzOnTestCaseFailureCollector	在執行期間收集測試案例失敗的錯誤報告。
BuildInfoRecorder	`ITargetPreparer`，可將建構資訊中繼資料寫入指定檔案。
CheckPairingPreparer	用於驗證主要裝置和隨附裝置之間的 BT 連結的 `CompanionAwarePreparer`
ClangCodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 Clang 涵蓋率測量資料，並將其記錄為測試構件。
CodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 Java 和原生涵蓋率評估結果，並將其記錄為測試構件。
收集 TestListener	用於收集所有測試結果的 `ITestInvocationListener`。
CompanionAllocator	負責分配及釋出隨附裝置的基本類別 `getCompanionDeviceSelectionOptions()` 應實作，以說明分配伴隨裝置所需的條件
CompanionAwarePreparer	`ITargetPreparer` 會封裝取得已指派的夥伴裝置的邏輯。
CompanionRunCommandTargetPreparer	在指派的隨附裝置上執行指定指令的 `ITargetPreparer`
CompanionTestAppInstallSetup	`ITargetPreparer`，可將 `IDeviceBuildInfo.getTestsDir()` 資料夾中的一或多個應用程式安裝到已指派的隨附裝置。
CompileBootImageWithSpeedTargetPreparer	使用編譯器篩選器「speed」重新編譯啟動 classpath 和系統伺服器。
CountTestCasesCollector	計算並回報指定 `IRemoteTest` 的測試案例數量。
CpuThrottlingWaiter	`ITargetPreparer` 會等到所有核心的最高頻率都還原為可用的最高層級
CreateAvdPreparer
CreateUserPreparer	建立使用者並在最後清理使用者的目標準備工具。
DebugHostLogOnFailureCollector	當測試案例失敗時，這個收集器會收集並記錄主機端記錄。
DeviceActionTargetPreparer	用於執行裝置動作的 `ITargetPreparer`。
DeviceBuildInfoBootStrapper	`ITargetPreparer` 會將建構資訊欄位替換為從裝置讀取的屬性這項功能可用於測試裝置，並使用從外部來源產生的版本 (例如
DeviceBuildInfoInjector	將 `DeviceBuildDescriptor` 中繼資料插入 `IBuildInfo` 的 `ITargetPreparer`。
DeviceCleaner	在測試後執行重新啟動或格式化作業，並視需要關閉螢幕
DeviceFlashPreparer	在實體 Android 硬體上刷新映像檔的 `ITargetPreparer`。
DeviceImageZipFlashingTargetPreparer	目標準備工具，可使用透過特定格式提供的裝置映像檔刷新裝置。
DeviceOwnerTargetPreparer	設定裝置管理員元件的 `ITargetPreparer`。
DeviceSetup	`ITargetPreparer` 會根據提供的 `Option` 設定測試裝置。
DeviceStorageFiller	讓目標準備工具填滿儲存空間，以便釋出一些可用空間。
DeviceStringPusher	指定準備工具將字串寫入檔案。
DeviceTraceCollector	在測試執行開始時啟動 Perfetto 追蹤，並在結束時記錄追蹤檔案的收集器。
DeviceUpdateTargetPreparer	抽象 `ITargetPreparer`，可處理使用外部來源 (而非建構服務) 的裝置映像檔檔案，更新裝置的常用步驟。
DeviceWiper	用於清除使用者資料的 `ITargetPreparer`
DisableSELinuxTargetPreparer	目標準備工具，可在啟用時停用 SELinux。
DynamicSystemPreparer	使用動態系統更新，在裝置版本上設定系統映像檔的 `ITargetPreparer`。
EraseUserDataPreparer	用於抹除裝置上使用者資料的 `ITargetPreparer`。
FastbootCommandPreparer	會觸發 fastboot 並傳送 fastboot 指令的目標準備工具。
FastbootUpdateBootstrapPreparer	這個 `ITargetPreparer` 會將指定檔案 (bootloader、radio、裝置映像檔 ZIP) 分派至 `IDeviceBuildInfo`，以便讓裝置透過 `FastbootDeviceFlasher` 進行閃燈作業，然後將開機後的裝置屬性插入建構資訊，以便回報結果。
FeatureFlagTargetPreparer	更新 DeviceConfig (由遠端服務調整的功能旗標)。
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` 會監聽來自裝置的評估指標鍵，並將這些指標以檔案形式從裝置中提取。
FilePullerLogCollector	裝置端回報的檔案記錄器。
FoldableModePreparer	可切換裝置折疊式狀態的目標準備工具。
FolderSaver	`ITargetPreparer` 會從裝置中提取目錄，並將壓縮後的資料儲存到記錄後端。
FormattedGeneratorReporter	可讓您以特定格式產生報表的報表工具。
GcovCodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 gcov 涵蓋率測量結果，並將其記錄為測試構件。
GcovKernelCodeCoverageCollector	`BaseDeviceMetricCollector` 會從 debugfs 和裝置中提取 gcov 核心涵蓋率測量值，然後將這些值記錄為測試構件。
GkiDeviceFlashPreparer	使用 Android 通用核心一般映像檔，對裝置進行刷機的目標準備工具。
GsiDeviceFlashPreparer	使用 Android 一般系統映像檔刷新裝置的目標準備工具。
HelloWorldMultiTargetPreparer	`IMultiTargetPreparer` 的實作範例。
HostStatsdMetricCollector	`IMetricCollector` 會使用 StatsD 公用程式指令，從主機端收集 StatsD 指標。
ILabPreparer	實驗室準備人員的標記介面如需這些介面的用途說明，請參閱 `ITargetPreparer`。
IMetricCollector	在回報測試結果時，系統會將此介面新增為修飾符，以便收集相符的指標。
IMultiTargetPreparer	為多部裝置一起準備測試環境。
IPostProcessor	後置處理器是 Trade Federation 物件，可在測試完成後及結果回報前處理指標和記錄。
ITargetCleaner	此介面已淘汰。 tearDown 已移至基本 ITargetPreparer 介面。
ITargetPreparer	為測試執行作業準備測試環境。
InstallAllTestZipAppsSetup	用於安裝測試 ZIP 檔案中所有應用程式的 `ITargetPreparer`。
InstallApexModuleTargetPreparer
InstallApkSetup	`ITargetPreparer` 會安裝位於檔案系統中一或多個 APK。
InstallBuildEnvApkSetup	`ITargetPreparer` 會從 Android 平台建構環境安裝一或多個測試 APK。
InstallKernelModulePreparer	安裝核心模組的目標準備工具。
InstrumentationPreparer	執行檢測的 `ITargetPreparer`
JavaCodeCoverageCollector	`BaseDeviceMetricCollector` 會從裝置中提取 Java 涵蓋率評估結果，並將其記錄為測試構件。
JsonHttpTestResultReporter	結果回報器，可將測試指標結果和分支、裝置資訊編碼為 JSON，並將其 POST 至 HTTP 服務端點
KillExistingEmulatorPreparer	關閉執行中的模擬器的 `ITargetPreparer`。
KnownFailurePreparer	指定準備器略過重試已知失敗的情況。
LUCIResultReporter	結果回報器，可將 ResultDB 和 LUCI 所需的測試結果儲存為 JSON 格式 (go/result-sink)，並在主控台記錄檔案位置。
LocalEmulatorLaunch	從 Android 建構環境在本機啟動模擬器的 TargetPreparer。
LocalEmulatorSnapshot	TargetPreparer 是用於從 Android 建構/開發環境產生簡潔模擬器快照
LogcatOnFailureCollector	收集器，可在測試案例失敗時擷取並記錄 Logcat。
LogcatTimingMetricCollector	指標收集器，可在一次或多次重複測試期間，使用指定的規則運算式，從 logcat 行剖析事件的開始和結束信號，收集時間資訊 (例如使用者切換時間)。
MergeMultiBuildTargetPreparer	`IMultiTargetPreparer` 可讓您指定名稱和檔案索引鍵，以便將資訊從一個版本傳遞至另一個版本。
MetricFilePostProcessor	用於上傳在測試和執行層級收集的指標記錄檔案。
MetricsXMLResultReporter	MetricsXMLResultReporter 會在測試的 invocationEnded 階段，將測試指標和執行指標寫入由 metrics-folder 參數指定的資料夾中 XML 檔案。
MixImageZipPreparer	在裝置版本中混合系統版本映像檔的 `IMultiTargetPreparer`。
MixKernelTargetPreparer	可將核心映像檔與裝置映像檔混合的 `ITargetPreparer`。
ModuleListener	監聽器會附加至每個模組的每個 `IRemoteTest`，以便收集結果清單。
ModuleLogcatCollector	Logcat 收集器的版本，但適用於模組。
ModuleOemTargetPreparer
NativeLeakCollector	執行「dumpsys meminfo --unreachable -a」的 `ITargetPreparer`，用於識別目前由各個程序保留的不可到達原生記憶體。
NoApkTestSkipper	特殊準備器，可在沒有要測試的 APK 時，完全略過叫用 (準備和測試)。
PairingMultiTargetPreparer	多目標準備工具可協助兩部裝置之間進行藍牙配對 (和連線)。
PerfettoGenericPostProcessor	後置處理器會以遞迴方式展開 proto 訊息和字串值欄位，直到遇到數值欄位為止，藉此將文字/二進位指標 perfetto proto 檔案處理成鍵/值組合。
PerfettoPreparer	Perfetto 準備工具會將設定檔推送至 Perfetto 可存取的標準位置。
PerfettoPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本實作項目，可從裝置中提取 Perfetto 檔案，並收集相關指標。
ProfileTargetPreparer	為任何設定檔使用者 `android.os.usertype.profile.XXX` 設定目標準備工具的基礎類別。
PushFileInvoker	這個類別已淘汰。改用 `PushFilePreparer`
PushFilePreparer	`ITargetPreparer` 會嘗試將任意數量的檔案從任何主機路徑推送至任何裝置路徑。
PythonVirtualenvPreparer	在主機上設定 Python 虛擬環境並安裝套件。
RebootReasonCollector	收集器會在測試執行期間收集裝置重新啟動情形，並依據原因和計數回報。
RebootTargetPreparer	重新啟動裝置的目標準備工具。
RecoveryLogPreparer	在復原前用來收集記錄的目標準備工具。
RemoveSystemAppPreparer	在測試執行前，從系統分區移除 APK 的 `ITargetPreparer`。
ReportPassedTests	在檔案中回報可能的篩選器，以便排除已通過測試的項目。
RestartSystemServerTargetPreparer	目標準備工具，可在不重新啟動裝置的情況下重新啟動系統伺服器。
ResultAggregator	特殊轉送器，可根據採用的重試策略，在需要時匯總結果。
RootTargetPreparer	根據「force-root」選項執行「adb root」或「adb unroot」的目標準備工具。
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	指定準備工具，在執行測試前後執行任意主機指令。
RunHostScriptTargetPreparer	在執行測試前執行指令碼的目標準備工具。
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	`ITargetPreparer` 標記，用於標示測試應在 SDK 沙箱中執行。
RunOnSecondaryUserTargetPreparer	`ITargetPreparer`，可確保測試以次要使用者身分執行。
RunOnSystemUserTargetPreparer	`ITargetPreparer`：標示應在使用者 (而非目前使用者) 上執行的測試。
RunOnWorkProfileTargetPreparer	在設定中建立工作資料夾的 `ITargetPreparer`，並標示應在該使用者中執行的測試。
RuntimeRestartCollector	收集器會在測試執行期間收集執行階段重新啟動 (系統伺服器當機) 的時間戳記 (如有)。
ScreenshotOnFailureCollector	在測試案例失敗時，會擷取並記錄螢幕截圖的收集器。
SemaphoreTokenTargetPreparer	這是用於使用權杖，在 tradefed 主機中序列化測試執行作業的準備工具。
ShardListener	`ITestInvocationListener` 會收集呼叫分割作業 (也就是在多個資源上並行執行的呼叫分割作業) 的結果，並將結果轉送至其他事件監聽器。
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本實作項目，可從裝置中提取 showmap 檔案，並收集相關指標。
SideloadOtaTargetPreparer	目標準備工具會執行指定 OTA 套件的側載作業、套用套件、等待裝置啟動，並插入裝置建構屬性，以做為建構資訊使用這個目標準備工具會假設裝置在啟動時處於一般 ADB 模式，並確保裝置會以相同模式退出，但會套用較新的版本。
SkipManager	跳過管理工具可根據各種條件，決定在不同層級 (叫用、模組和測試) 應跳過哪些內容。
StatsdBeforeAfterGaugeMetricPostProcessor	後續處理器會處理以「前後」方式收集的評估指標，也就是
StatsdEventMetricPostProcessor	後置處理器，可使用處理器上指定的格式化工具，將 statsd 報表中的事件指標轉換為鍵/值組合。
StatsdGenericPostProcessor	後置處理器，可將二進位值 Proto 統計資料報表處理為鍵/值組合，方法是將報表展開為樹狀結構。
StopServicesSetup	停止裝置服務的 `ITargetPreparer`。
StubMultiTargetPreparer	`IMultiTargetPreparer` 的預留位置空白實作。
StubTargetPreparer	`ITargetPreparer` 的預留位置空白實作。
SuiteApkInstaller	為套裝組合設定安裝指定的 APK：從 $ANDROID_TARGET_OUT_TESTCASES 變數或建構資訊中的 ROOT_DIR。
SuiteResultReporter	收集整個套件叫用作業的測試結果，並輸出最終結果。
SwitchUserTargetPreparer	在 setUp 中切換至指定使用者類型的 `ITargetPreparer`。
TearDownPassThroughPreparer	允許對設定中以物件形式納入的準備程序執行 tearDown。
TemperatureThrottlingWaiter	`ITargetPreparer` 會等待裝置溫度降至目標溫度
TestAppInstallSetup	`ITargetPreparer`：將一或多個應用程式從 `IDeviceBuildInfo.getTestsDir()` 資料夾安裝到裝置上。
TestFilePushSetup	將一或多個檔案/目錄從 `IDeviceBuildInfo.getTestsDir()` 資料夾推送至裝置的 `ITargetPreparer`。
TestSystemAppInstallSetup	`ITargetPreparer` 會將一或多個應用程式從 `IDeviceBuildInfo.getTestsDir()` 資料夾安裝到裝置的 /system 分區。
TimeWaster	簡單的目標準備器會浪費時間，甚至可能重新啟動裝置。
TraceCmdCollector	`IMetricCollector` 會在測試期間使用 trace-cmd 收集追蹤記錄，並將這些記錄記錄到叫用作業中。
UserCleaner	在解除安裝時移除次要使用者的 `ITargetPreparer`。
VisibleBackgroundUserPreparer	在背景中啟動的使用者可見狀態下，用於執行測試的目標準備工具。
WaitForDeviceDatetimePreparer	`ITargetPreparer` 會等待裝置設定日期時間如果在逾時前未設定日期時間，這個預備程序可選擇強制執行 `TargetSetupError`。
WifiPreparer	`ITargetPreparer`，視需要在裝置上設定 Wi-Fi。
XmlFormattedGeneratorReporter	實作 `FormattedGeneratorReporter`，以 XML 格式格式化套裝軟體結果。
XmlResultReporter	以與 Ant 的 XMLJUnitResultFormatter 一致的格式，將 JUnit 結果寫入 XML 檔案。

介面：說明可停用的 Tradefed 物件。系統會略過已停用的物件，完全不會呼叫該物件。

摘要

公用方法
`default boolean`	`isDisabled()` 如果整個物件已停用 (略過設定和拆卸)，則傳回 True。
`default boolean`	`isTearDownDisabled()` 如果只應略過解構作業，則傳回 True。
`default void`	`setDisable(boolean isDisabled)` 設定是否應停用物件。
`default void`	`setDisableTearDown(boolean isDisabled)` 設定是否應略過物件中的解構步驟。

公用方法

isDisabled

public boolean isDisabled ()

如果整個物件已停用 (略過設定和拆卸)，則傳回 True。否則為 False。

傳回
`boolean`

isTearDownDisabled

public boolean isTearDownDisabled ()

如果只應略過解構作業，則傳回 True。否則為 False。

傳回
`boolean`

setDisable

public void setDisable (boolean isDisabled)

設定是否應停用物件。停用表示應略過設定和拆卸步驟。可用於在預設建構函式中，讓物件預設為停用。

參數
`isDisabled`	`boolean`：物件應放置的狀態。

setDisableTearDown

public void setDisableTearDown (boolean isDisabled)

設定是否應略過物件中的解構步驟。設定步驟仍會完成。

參數
`isDisabled`	`boolean`：物件應放置的狀態。