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

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

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

已知間接子類別

AdbStopServerPreparer、AllTestAppsInstallSetup、AoaTargetPreparer、AppSetup、ArtChrootPreparer、BaseEmulatorPreparer、BaseTargetPreparer、BuildInfoRecorder、CheckPairingPreparer、CompanionAllocator、CompanionAwarePreparer、CompanionRunCommandTargetPreparer、CompanionTestAppInstallSetup、CompileBootImageWithSpeedTargetPreparer、CpuThrottlingWaiter 等 79 個項目。

AdbStopServerPreparer	目標準備工具會在執行 ADB 測試前後，停止主機上的 ADB 伺服器。
AllTestAppsInstallSetup	`ITargetPreparer`，可將 `IDeviceBuildInfo.getTestsDir()` 資料夾中的所有應用程式安裝到裝置上。
AoaTargetPreparer	`ITargetPreparer`，可使用 Android Open Accessory (AOAv2) 通訊協定執行一系列動作 (例如點按和滑動)。
AppSetup	安裝 APK 及其測試的 `ITargetPreparer`。
ArtChrootPreparer	為 ART 測試建立 chroot 目錄。
BaseEmulatorPreparer	啟動本機模擬器的常見準備程序。
BaseTargetPreparer	`ITargetPreparer` 的基本實作類別，可控制物件是否已停用。
BuildInfoRecorder	`ITargetPreparer`，可將建構資訊中繼資料寫入指定檔案。
CheckPairingPreparer	`CompanionAwarePreparer`，用於驗證主要裝置和隨附裝置之間的藍牙配對
CompanionAllocator	負責分配及釋放隨附裝置的基礎類別應實作 `getCompanionDeviceSelectionOptions()`，說明分配隨附裝置所需的條件
CompanionAwarePreparer	`ITargetPreparer`：封裝取得已分配的同伴裝置邏輯。
CompanionRunCommandTargetPreparer	`ITargetPreparer`，可在已分配的隨附裝置上執行指定指令
CompanionTestAppInstallSetup	`ITargetPreparer`，可將一或多個應用程式從 `IDeviceBuildInfo.getTestsDir()` 資料夾安裝到已分配的隨附裝置。
CompileBootImageWithSpeedTargetPreparer	使用編譯器篩選器「speed」重新編譯開機類路徑和系統伺服器。
CpuThrottlingWaiter	`ITargetPreparer`：等待所有核心的最高頻率恢復到最高可用等級
CreateAvdPreparer
CreateUserPreparer	目標準備人員，負責建立使用者，並在最後清除使用者。
DeviceActionTargetPreparer	`ITargetPreparer` 執行裝置動作。
DeviceBuildInfoBootStrapper	`ITargetPreparer`，可將建構資訊欄位替換為從裝置讀取的屬性這項功能適用於測試裝置，並使用從外部來源產生的建構版本 (例如
DeviceBuildInfoInjector	`ITargetPreparer`，可將 `DeviceBuildDescriptor` 中繼資料插入 `IBuildInfo`。
DeviceCleaner	在測試後執行重新啟動或格式化作業，做為清除動作，並視需要關閉螢幕
DeviceFlashPreparer	`ITargetPreparer`，可將映像檔刷新至實體 Android 硬體。
DeviceImageZipFlashingTargetPreparer	目標準備工具，可透過特定格式提供的裝置映像檔刷新裝置。
DeviceOwnerTargetPreparer	用來設定裝置擁有者元件的 `ITargetPreparer`。
DeviceSetup	`ITargetPreparer`：根據提供的 `Option` 設定裝置以進行測試。
DeviceStorageFiller	目標是填滿儲存空間，但仍保留一些可用空間。
DeviceStringPusher	目標準備工具，可將字串寫入檔案。
DeviceUpdateTargetPreparer	抽象 `ITargetPreparer`，負責處理從外部來源 (而非建構服務) 使用裝置映像檔檔案更新裝置的常見步驟。
DeviceWiper	可清除使用者資料的 `ITargetPreparer`
DisableSELinuxTargetPreparer	目標準備工具，可停用已啟用的 SELinux。
DynamicSystemPreparer	`ITargetPreparer`，可透過動態系統更新在裝置建構版本上設定系統映像檔。
EraseUserDataPreparer	`ITargetPreparer`，可抹除裝置上的使用者資料。
FastbootCommandPreparer	目標準備器，可觸發 Fastboot 並傳送 Fastboot 指令。
FastbootUpdateBootstrapPreparer	`ITargetPreparer` 會將指定檔案 (系統啟動載入程式、無線電、裝置映像檔 ZIP) 暫存到 `IDeviceBuildInfo`，以便使用 `FastbootDeviceFlasher` 刷入裝置，然後將開機後裝置屬性插入建構資訊，用於回報結果。
FeatureFlagTargetPreparer	更新 DeviceConfig (由遠端服務調整的功能旗標)。
FoldableModePreparer	目標準備工具，可切換裝置的折疊狀態。
FolderSaver	`ITargetPreparer`：從裝置中提取目錄、壓縮並儲存到記錄後端。
FutilityCommandPreparer	準備執行無效指令。
GkiDeviceFlashPreparer	目標準備工具，可使用 Android 通用核心一般映像檔刷寫裝置。
GoogleAccountPreparer	支援設定 Google 帳戶的 `ITargetPreparer`。
GsiDeviceFlashPreparer	目標準備工具，可使用 Android 一般系統映像檔刷新裝置。
ILabPreparer	實驗室準備人員的標記介面如要瞭解這些介面的用途，請參閱 `ITargetPreparer`。
ITargetCleaner	這個介面已淘汰。 tearDown 已移至基礎 ITargetPreparer 介面。
InstallAllTestZipAppsSetup	`ITargetPreparer`，可安裝測試 ZIP 檔案中的所有應用程式。
InstallApexModuleTargetPreparer
InstallApkSetup	`ITargetPreparer`，可安裝檔案系統中的一或多個 APK。
InstallBuildEnvApkSetup	`ITargetPreparer`：從 Android 平台建構環境安裝一或多個測試 APK。
InstallKernelModulePreparer	安裝核心模組的目標準備工具。
InstrumentationPreparer	執行檢測設備的 `ITargetPreparer`
KillExistingEmulatorPreparer	`ITargetPreparer`：關閉執行中的模擬器。
KnownFailurePreparer	目標準備者會略過重試已知失敗。
LocalEmulatorLaunch	TargetPreparer，可從 Android 建構環境在本機啟動模擬器。
LocalEmulatorSnapshot	TargetPreparer 適用於從 Android 建構/開發環境產生乾淨的模擬器快照
MixKernelTargetPreparer	`ITargetPreparer`：可將核心映像檔與裝置映像檔混合。
MixRadioTargetPreparer	`ITargetPreparer`，可將無線電圖片與裝置圖片混合。
ModuleOemTargetPreparer
NativeLeakCollector	執行「dumpsys meminfo --unreachable -a」的 `ITargetPreparer`，可找出每個程序目前持有的無法存取原生記憶體。
NoApkTestSkipper	特殊準備工具，可完全略過叫用 (準備和測試)，前提是沒有要測試的 APK。
PerfettoPreparer	Perfetto 準備工具會將設定檔推送到裝置的標準位置，Perfetto 可存取該位置。
ProfileTargetPreparer	設定任何設定檔使用者 `android.os.usertype.profile.XXX` 的目標準備工具的基礎類別。
PushFileInvoker	這個類別已淘汰。請改用 `PushFilePreparer`
PushFilePreparer	`ITargetPreparer`，可嘗試將任意數量的檔案從任何主機路徑推送至任何裝置路徑。
PythonVirtualenvPreparer	在主機上設定 Python virtualenv 並安裝套件。
RebootTargetPreparer	目標準備人員重新啟動裝置。
RecoveryLogPreparer	目標準備人員先前曾收集記錄。
RemoveSystemAppPreparer	`ITargetPreparer`，以便在測試執行前從系統分割區移除 APK。
RestartSystemServerTargetPreparer	目標準備人員，負責重新啟動系統伺服器，但不會重新啟動裝置。
RootTargetPreparer	目標準備人員會根據「force-root」選項執行「adb root」或「adb unroot」。
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	目標準備工具，可在執行測試前後執行任意主機指令。
RunHostScriptTargetPreparer	目標準備工具，會在執行測試前執行指令碼。
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	`ITargetPreparer`，標記測試應在 SDK 沙箱中執行。
RunOnSecondaryUserTargetPreparer	`ITargetPreparer`，確保測試以次要使用者身分執行。
RunOnSystemUserTargetPreparer	`ITargetPreparer`，表示應對使用者 (而非目前使用者) 執行測試。
RunOnWorkProfileTargetPreparer	`ITargetPreparer`：在設定中建立工作資料夾，並標記應在該使用者中執行的測試。
SemaphoreTokenTargetPreparer	這是用來在 Tradefed 主機中，使用權杖序列化測試執行的準備工具。
SideloadOtaTargetPreparer	目標準備工具，可執行指定 OTA 套件的側載作業、套用套件、等待裝置啟動，並插入裝置建構屬性，做為建構資訊使用。這個目標準備工具假設裝置會在啟動時處於一般 adb 模式，並確保裝置會以相同模式結束，但會套用較新的建構版本。
StopServicesSetup	`ITargetPreparer`，停止裝置上的服務。
StubTargetPreparer	`ITargetPreparer` 的空白實作預留位置。
SuiteApkInstaller	安裝套件設定的指定 APK：來自 $ANDROID_TARGET_OUT_TESTCASES 變數或建構資訊中的 ROOT_DIR。
SwitchUserTargetPreparer	在 setUp 中切換至指定使用者類型的 `ITargetPreparer`。
TearDownPassThroughPreparer	允許對以物件形式納入設定中的準備工具執行 tearDown。
TemperatureThrottlingWaiter	`ITargetPreparer`：等待裝置溫度降至目標溫度。
TestAppInstallSetup	`ITargetPreparer`：從 `IDeviceBuildInfo.getTestsDir()` 資料夾將一或多個應用程式安裝到裝置上。
TestFilePushSetup	`ITargetPreparer`，可將一或多個檔案/目錄從 `IDeviceBuildInfo.getTestsDir()` 資料夾推送至裝置。
TestSystemAppInstallSetup	`ITargetPreparer`，可將一或多個應用程式從 `IDeviceBuildInfo.getTestsDir()` 資料夾安裝到裝置的 /system 分區。
TimeWaster	這個簡單的目標準備工具會浪費時間，而且可能會重新啟動裝置。
UserCleaner	`ITargetPreparer`，在拆除時移除次要使用者。
VisibleBackgroundUserPreparer	目標準備工具，用於在背景啟動的使用者中執行測試。
WaitForDeviceDatetimePreparer	`ITargetPreparer`，等待裝置設定日期時間如果未在逾時時間內設定日期時間，這個準備者可以選擇強制執行 `TargetSetupError`。
WifiPreparer	視需要設定裝置的 Wi-Fi `ITargetPreparer`。

為測試執行準備測試環境。

例如安裝軟體、調整測試環境設定、啟動目標等。

請注意，設定中可以指定多個 ITargetPreparer。建議每個 ITargetPreparer 清楚記錄預期的環境預先設定和設定後狀態。舉例來說，設定裝置以進行測試的 ITargetPreparer 必須在安裝軟體的 ITargetPreparer 之後執行。

摘要

公用方法
`default void`	`setUp(ITestDevice device, IBuildInfo buildInfo)` 這個方法已淘汰。請改用 `setUp(com.android.tradefed.invoker.TestInformation)`
`default void`	`setUp(TestInformation testInformation)` 執行測試的目標設定。
`default void`	`tearDown(TestInformation testInformation, Throwable e)` 測試完成後，請執行目標清除/拆除作業。
`default void`	`tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e)` 這個方法已淘汰。請改用 `tearDown(com.android.tradefed.invoker.TestInformation, Throwable)`

公用方法

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

這個方法已淘汰。
請改用 setUp(com.android.tradefed.invoker.TestInformation)

執行測試的目標設定。

參數
`device`	`ITestDevice`：要準備的 `ITestDevice`。
`buildInfo`	`IBuildInfo`：受測建構版本的相關資料。

擲回
`TargetSetupError`	如果設定環境時發生嚴重錯誤
`BuildError`	如果發生與 BuildInfo 相關的錯誤
`DeviceNotAvailableException`	如果裝置沒有回應

setUp

public void setUp (TestInformation testInformation)

執行測試的目標設定。

參數
`testInformation`	`TestInformation`：叫用的 `TestInformation`。

擲回
`TargetSetupError`	如果設定環境時發生嚴重錯誤
`BuildError`	如果準備建構作業時發生錯誤
`DeviceNotAvailableException`	如果裝置沒有回應

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

測試完成後，請執行目標清理/拆除作業。

參數
`testInformation`	`TestInformation`：叫用的 `TestInformation`。
`e`	`Throwable`：如果呼叫以例外狀況結束，這會是在呼叫層級擷取的例外狀況。否則為 `null`。

擲回
`DeviceNotAvailableException`	如果裝置沒有回應

tearDown

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

這個方法已淘汰。
請改用 tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

測試完成後，請執行目標清理/拆除作業。

參數
`device`	`ITestDevice`：要準備的 `ITestDevice`。
`buildInfo`	`IBuildInfo`：受測建構版本的相關資料。
`e`	`Throwable`：如果呼叫作業以例外狀況結束，這會是在呼叫層級擷取的例外狀況。否則為 `null`。

擲回
`DeviceNotAvailableException`	如果裝置沒有回應