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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

IDisableable

public interface IDisableable

com.android.tradefed.util.IDisableable

已知間接子類別

AFlagsTargetPreparer、AdbStopServerPreparer、AggregatePostProcessor、AllTestAppsInstallSetup、AndroidBuildResultReporter、AoaTargetPreparer、AppSetup、ArtChrootPreparer、AtraceCollector、AtraceRunMetricCollector、AveragePostProcessor、BaseDeviceMetricCollector、BaseEmulatorPreparer、BaseMultiTargetPreparer、BasePostProcessor 等 161 個項目。

AFlagsTargetPreparer	在執行測試前，使用 `aflags` 覆寫旗標。
AdbStopServerPreparer	目標準備工具會在執行 ADB 測試前後，停止主機上的 ADB 伺服器。
AggregatePostProcessor	指標匯總工具，可提供多次疊代測試執行期間收集的數值指標的最小值、最大值、平均值、變異數、標準差、總計、計數，以及 (選用) 百分位數，並將這些指標視為雙精度浮點數。
AllTestAppsInstallSetup	`ITargetPreparer`，可將 `IDeviceBuildInfo.getTestsDir()` 資料夾中的所有應用程式安裝到裝置上。
AndroidBuildResultReporter	向 Android Build API 報告測試結果。
AoaTargetPreparer	`ITargetPreparer`，可使用 Android Open Accessory (AOAv2) 通訊協定執行一系列動作 (例如點按和滑動)。
AppSetup	安裝 APK 及其測試的 `ITargetPreparer`。
ArtChrootPreparer	為 ART 測試建立 chroot 目錄。
AtraceCollector	`IMetricCollector`：在測試期間執行追蹤，並收集結果和記錄到呼叫中。
AtraceRunMetricCollector	從測試裝置收集指定目錄下所有測試目錄的追蹤記錄、記錄測試目錄，並後續處理測試目錄下的追蹤記錄檔案，以及匯總指標。
AveragePostProcessor	實作後處理器，計算指標清單的平均值。
BaseDeviceMetricCollector	`IMetricCollector` 的基本實作，可讓您在 `onTestRunStart(DeviceMetricData)` 和 `onTestRunEnd(DeviceMetricData,Map)` 上開始及停止收集資料。
BaseEmulatorPreparer	啟動本機模擬器的常見準備工作。
BaseMultiTargetPreparer	`IMultiTargetPreparer` 的基本實作，可停用物件。
BasePostProcessor	所有實作項目都應擴充的基礎 `IPostProcessor`。
BaseSwitchUserTargetPreparer	在 setUp 中切換至指定使用者類型的 `ITargetPreparer`。
BaseSystemTestEnvPreparer	重新啟動至基本系統測試環境
BaseTargetPreparer	`ITargetPreparer` 的基本實作類別，可控制物件是否停用。
BluetoothConnectionLatencyCollector	收集器會將預先定義的 statsd 持續時間指標設定推送至裝置，並收集每個設定檔的藍牙連線持續時間。
BluetoothConnectionStateCollector	這個收集器會收集 BluetoothConnectionStateChanged 指標，並記錄每個設定檔的連線狀態編號。
BluetoothConnectionSuccessRatePostProcessor	實作後處理器，計算藍牙設定檔的成功率使用「metric-key-match」指定包含藍牙連線狀態的指標 (以數字陣列表示)，例如 [0, 1, 2, 3, 0, 1, 2, 3]。
BluetoothHciSnoopLogCollector	收集器，用於在 DUT 上啟用藍牙 HCI 窺探記錄，並收集各項測試的記錄。
BugreportzOnFailureCollector	測試案例失敗時，收集 bugreportz。
BugreportzOnTestCaseFailureCollector	在執行測試案例時，如果發生失敗情形，請收集錯誤報告。
BuildInfoRecorder	`ITargetPreparer`，可將建構資訊中繼資料寫入指定檔案。
CheckPairingPreparer	`CompanionAwarePreparer`，用於驗證主要裝置和隨附裝置之間的藍牙配對
ClangCodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 Clang 涵蓋範圍測量結果，並將其記錄為測試構件。
CodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 Java 和原生涵蓋範圍測量結果，並將其記錄為測試構件。
CollectingTestListener	`ITestInvocationListener`，用於收集所有測試結果。
CompanionAllocator	負責分配及釋出配對裝置的基礎類別應實作 `getCompanionDeviceSelectionOptions()`，說明分配配對裝置所需的條件
CompanionAwarePreparer	`ITargetPreparer`：封裝取得已分配的同伴裝置邏輯。
CompanionRunCommandTargetPreparer	`ITargetPreparer`，可在已分配的配對裝置上執行指定指令
CompanionTestAppInstallSetup	`ITargetPreparer`：從 `IDeviceBuildInfo.getTestsDir()` 資料夾將一或多個應用程式安裝到已分配的配對裝置。
CompatTargetPreparer	`ITargetPreparer`，可準備裝置執行相容性測試。
CompileBootImageWithSpeedTargetPreparer	使用編譯器篩選器「speed」重新編譯開機類路徑和系統伺服器。
CountTestCasesCollector	計算並回報指定 `IRemoteTest` 的測試案例數量。
CpuThrottlingWaiter	`ITargetPreparer`：等待所有核心的最高頻率恢復至最高可用等級
CreateAvdPreparer
CreateUserPreparer	目標準備工具，用於建立次要使用者，並在最後清除。
CrosDutTopologyPreparer	執行 dt-converter 工具的準備人員，負責產生測試設定和測試參數。
CrosLsNexusPreparer	啟動及停止 ChromeOS 裝置的 LSNexus 服務。
CtsSettingsSetup	`ITargetPreparer`：設定裝置，準備執行 CTS 測試。
DebugHostLogOnFailureCollector	收集器會在測試案例失敗時收集並記錄主機端記錄。
DeviceActionTargetPreparer	`ITargetPreparer` 執行裝置動作。
DeviceBuildInfoBootStrapper	`ITargetPreparer`：以從裝置讀取的屬性取代建構資訊欄位這項功能適用於測試從外部來源產生的建構版本 (例如
DeviceBuildInfoInjector	`ITargetPreparer`，可將 `DeviceBuildDescriptor` 中繼資料插入 `IBuildInfo`。
DeviceCleaner	在測試後執行重新啟動或格式化，做為清除動作，並視需要關閉螢幕
DeviceFlashPreparer	`ITargetPreparer`，可將映像檔刷新至實體 Android 硬體。
DeviceImageZipFlashingTargetPreparer	目標準備工具，可透過特定格式提供的裝置映像檔刷新裝置。
DeviceOwnerTargetPreparer	設定裝置擁有者元件的 `ITargetPreparer`。
DeviceSetup	`ITargetPreparer`，可根據提供的 `Option` 設定裝置以進行測試。
DeviceStorageFiller	請目標準備人員填滿儲存空間，釋出部分可用空間。
DeviceStringPusher	目標準備工具，可將字串寫入檔案。
DeviceTraceCollector	這個收集器會在測試執行開始時啟動 Perfetto 追蹤記錄，並在結束時記錄追蹤記錄檔。
DeviceUpdateTargetPreparer	抽象 `ITargetPreparer`，負責處理從外部來源 (而非建構服務) 使用裝置映像檔更新裝置的常見步驟。
DeviceWiper	A `ITargetPreparer`，可抹除使用者資料
DexMetadataExtractor	為指定 APK 安裝 Dex 中繼資料檔案。
DisableSELinuxTargetPreparer	目標準備工具，可停用已啟用的 SELinux。
DynamicSystemPreparer	`ITargetPreparer`，可透過動態系統更新在裝置建構版本上設定系統映像檔。
EhideTargetPreparer	啟動 ehide，從 Android 網路堆疊隱藏乙太網路介面。
EraseUserDataPreparer	`ITargetPreparer`，可抹除裝置上的使用者資料。
FastbootCommandPreparer	目標準備器，可觸發 Fastboot 並傳送 Fastboot 指令。
FastbootUpdateBootstrapPreparer	`ITargetPreparer` 會將指定檔案 (系統啟動載入程式、無線電、裝置映像檔 ZIP) 暫存到 `IDeviceBuildInfo`，以便使用 `FastbootDeviceFlasher` 刷入裝置，然後將開機後裝置屬性插入建構資訊，用於回報結果。
FeatureFlagTargetPreparer	這個類別已淘汰。請改用 `AFlagsTargetPreparer`。
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector`，可監聽裝置傳來的指標金鑰，並從裝置中擷取這些金鑰做為檔案。
FilePullerLogCollector	記錄裝置端回報的檔案。
FoldableModePreparer	目標準備工具，可切換裝置的折疊狀態。
FolderSaver	`ITargetPreparer`：從裝置中提取目錄、壓縮，並儲存到記錄後端。
FormattedGeneratorReporter	可產生特定格式報表的 Reporter。
FutilityCommandPreparer	準備執行無效指令。
GcovCodeCoverageCollector	`BaseDeviceMetricCollector`，可從裝置中提取 gcov 涵蓋範圍測量結果，並將其記錄為測試構件。
GcovKernelCodeCoverageCollector	這項工具會從 debugfs 和裝置中提取 gcov 核心涵蓋範圍測量結果，然後將這些結果記錄為測試構件。`BaseDeviceMetricCollector`
GeminiDebuggingPostProcessor	後續處理器會建立提示查詢，以偵錯錯誤。
GkiDeviceFlashPreparer	目標準備工具，可使用 Android 通用核心一般映像檔刷寫裝置。
GoogleAccountPreparer	支援設定 Google 帳戶的 `ITargetPreparer`。
GoogleAppsSetup	支援各種 Google 應用程式設定選項的 `ITargetPreparer` 注意：裝置必須先設定帳戶，請參閱 `GoogleAccountPreparer`。
GoogleDeviceFlashPreparer	這項特化功能支援刷入 Google 裝置所需的自訂步驟。`DeviceFlashPreparer`
GoogleDeviceSetup	`DeviceSetup` 的擴充功能，可設定其他 Google 專屬屬性。
GsiDeviceFlashPreparer	目標準備工具，可使用 Android 一般系統映像檔刷新裝置。
HelloWorldMultiTargetPreparer	`IMultiTargetPreparer` 的實作範例。
HostStatsdMetricCollector	`IMetricCollector`：使用 statsd 公用程式指令從主機端收集 statsd 指標。
HsumBootStrategyPreparer
ILabPreparer	實驗室準備人員的標記介面如要瞭解這些介面的用途，請參閱 `ITargetPreparer`。
IMetricCollector	回報測試結果時，這個介面會以裝飾器形式新增，以便收集相符的指標。
IMultiTargetPreparer	為多部裝置準備測試環境。
IPostProcessor	後續處理器是 Trade Federation 物件，用於在測試後和結果回報前處理指標和記錄。
ITargetCleaner	這個介面已淘汰。 tearDown 已移至基本 ITargetPreparer 介面。
ITargetPreparer	為測試執行準備測試環境。
InstallAllTestZipAppsSetup	`ITargetPreparer`：安裝測試 ZIP 檔案中的所有應用程式。
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	TargetPreparer，可從 Android 建構環境在本機啟動模擬器。
LocalEmulatorSnapshot	TargetPreparer 適用於從 Android 建構/開發環境產生乾淨的模擬器快照
LogcatOnFailureCollector	收集器：在測試案例或測試執行失敗時擷取並記錄 logcat。
LogcatTimingMetricCollector	指標收集器，可使用指定的 regex 模式剖析 logcat 行中的事件開始和結束信號，在一次或多次重複測試期間，從 logcat 收集時間資訊 (例如使用者切換時間)。
MergeMultiBuildTargetPreparer	`IMultiTargetPreparer`：可命名建構作業，並指定要複製到其他建構作業的檔案金鑰，藉此在建構作業之間傳遞資訊。
MetricFilePostProcessor	用於上傳在測試和執行層級收集的指標記錄檔。
MetricsXMLResultReporter	在測試的 invocationEnded 階段，MetricsXMLResultReporter 會將測試指標和執行指標寫入 metrics-folder 參數指定的資料夾中的 XML 檔案。
MixImageZipPreparer	`IMultiTargetPreparer`，可將系統建構的映像檔混合到裝置建構中。
MixKernelTargetPreparer	`ITargetPreparer`，可將核心映像檔與裝置映像檔混合。
MixRadioTargetPreparer	`ITargetPreparer`：可將無線電映像檔與裝置映像檔混合。
ModuleListener	附加至每個模組的每個 `IRemoteTest` 的監聽器，用於收集結果清單。
ModuleLogcatCollector	Logcat 收集器版本，但適用於模組。
ModuleOemTargetPreparer
ModulePerfettoCollector	這個收集器會在測試模組啟動/結束時和裝置重新啟動時，啟動 perfetto 追蹤。
NativeLeakCollector	執行「dumpsys meminfo --unreachable -a」的 `ITargetPreparer`，可找出每個程序目前持有的無法存取原生記憶體。
NoApkTestSkipper	特殊準備工具，可完全略過叫用 (準備和測試)，前提是沒有要測試的 APK。
PairingMultiTargetPreparer	多目標準備器可協助在兩部裝置之間進行藍牙配對 (和連線)。
PerfettoFilePullerCollector	收集器會從裝置提取 Perfetto 追蹤記錄檔案，並視需要壓縮檔案，然後將檔案新增至測試記錄。
PerfettoGenericPostProcessor	後續處理器：遞迴展開具有字串值的 proto 訊息和欄位，直到遇到具有數值的欄位為止，將文字/二進位指標 perfetto proto 檔案處理為鍵/值組合。
PerfettoPreparer	Perfetto 準備工具會將設定檔推送至裝置的標準位置，Perfetto 可存取該位置。
PerfettoPullerMetricCollector	這個類別已淘汰。請改用 `PerfettoFilePullerCollector` 和 `ERROR(/PerfettoTracePostProcessor)`。
PerfettoTracePostProcessor	後處理器：從測試記錄中擷取 perfetto 追蹤記錄檔案，並對這些檔案執行追蹤記錄處理器，以產生 perfetto 指標 proto。
ProfileTargetPreparer	設定任何設定檔使用者目標準備工具的基礎類別 `android.os.usertype.profile.XXX`。
PushFileInvoker	這個類別已淘汰。請改用 `PushFilePreparer`
PushFilePreparer	`ITargetPreparer`，可嘗試將任意數量的檔案從任何主機路徑推送至任何裝置路徑。
PythonVirtualenvPreparer	在主機上設定 Python virtualenv 並安裝套件。
RamdumpPreparer	啟用 Ramdump。
RebootReasonCollector	收集測試執行期間裝置重新啟動的次數，並依據原因和次數回報。
RebootTargetPreparer	目標準備人員重新啟動裝置。
RecoveryLogPreparer	目標準備人員會在復原前收集記錄。
RemoveSystemAppPreparer	`ITargetPreparer`：在測試執行前，從系統分割區移除 APK。
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	收集器，用於收集測試執行期間的執行階段重新啟動時間戳記 (系統伺服器當機)，如有。
ScreenRecordOnFailureCollector	收集器會在測試案例失敗時擷取並記錄螢幕錄影。
ScreenshotOnFailureCollector	收集器，會在測試案例失敗時擷取並記錄螢幕截圖。
SemaphoreTokenTargetPreparer	這是用來在 Tradefed 主機中，使用權杖序列化測試執行的準備工具。
設定設定	`ITargetPreparer`：透過 SettingsUtil.apk 的插樁設定裝置設定。
ShardListener	這個類別會從呼叫分片收集結果 (也就是呼叫分割，以便在多個資源上平行執行)，並將結果轉送至另一個接聽程式。`ITestInvocationListener`
ShowmapPullerMetricCollector	`FilePullerDeviceMetricCollector` 的基本實作，可從裝置中提取 showmap 檔案，並從中收集指標。
SideloadOtaTargetPreparer	目標準備工具，可執行指定 OTA 套件的側載作業、套用套件、等待裝置啟動，以及插入裝置建構屬性，做為建構資訊使用。這個目標準備工具會假設裝置在啟動時處於一般 adb 模式，並確保裝置在退出時處於相同模式，但已套用較新的建構版本。
SimpleperfProfilePostProcessor	後續處理器，可找出 simpleperf 分析資料並產生 pprof 設定檔。
SkipManager	根據各種條件，略過管理工具可協助決定在不同層級 (叫用、模組和測試) 應略過哪些項目。
StatsdBeforeAfterGaugeMetricPostProcessor	後續處理器，會以「前後」方法處理收集到的計量表指標，也就是：
StatsdEventMetricPostProcessor	後置處理器：使用處理器上指定的格式化工具，將 statsd 報表中的事件指標處理為鍵/值組合。
StatsdGenericPostProcessor	後續處理器：將二進位 proto statsd 報表處理為鍵/值組合，方法是將報表展開為樹狀結構。
StopServicesSetup	`ITargetPreparer`，停止裝置上的服務。
StubMultiTargetPreparer	`IMultiTargetPreparer` 的空白實作預留位置。
StubTargetPreparer	`ITargetPreparer` 的空白實作預留位置。
SuiteApkInstaller	安裝 Suite 設定的指定 APK：來自 $ANDROID_TARGET_OUT_TESTCASES 變數或建構資訊中的 ROOT_DIR。
SuiteResultReporter	收集整個套件調用的測試結果，並輸出最終結果。
SwitchUserTargetPreparer	`BaseSwitchUserTargetPreparer` 的預設實作 - 請參閱該類別的 Javadoc，瞭解更多資訊。
TearDownPassThroughPreparer	允許對設定中以物件形式納入的準備工具執行 tearDown。
TemperatureThrottlingWaiter	`ITargetPreparer`：等待裝置溫度降至目標溫度。
TestAppInstallSetup	`ITargetPreparer`：從 `IDeviceBuildInfo.getTestsDir()` 資料夾將一或多個應用程式安裝到裝置上。
TestFilePushSetup	`ITargetPreparer`，可將一或多個檔案/目錄從 `IDeviceBuildInfo.getTestsDir()` 資料夾推送至裝置。
TestSystemAppInstallSetup	`ITargetPreparer`：從 `IDeviceBuildInfo.getTestsDir()` 資料夾將一或多個應用程式安裝到裝置的 /system 分區。
TimeWaster	簡單的目標準備工具，可浪費時間並可能重新啟動裝置。
TraceCmdCollector	`IMetricCollector`：使用 trace-cmd 在測試期間收集追蹤記錄，並將記錄寫入呼叫。
UserCleaner	`ITargetPreparer`，在拆除時移除次要使用者。
VisibleBackgroundUserPreparer	目標準備工具，可在背景啟動的使用者中執行測試。
WaitForDeviceDatetimePreparer	`ITargetPreparer`，等待裝置設定日期時間如果未在逾時時間內設定日期時間，這個準備者可以選擇強制執行 `TargetSetupError`。
WifiPreparer	視需要設定裝置的 Wi-Fi `ITargetPreparer`。
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)

設定是否應停用物件。如果設為「Disabled」，表示應略過設定和拆除步驟。可用於在預設建構函式中，預設停用物件。

參數
`isDisabled`	`boolean`：物件應處於的狀態。

setDisableTearDown

public void setDisableTearDown (boolean isDisabled)

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

參數
`isDisabled`	`boolean`：物件應處於的狀態。