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

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

已知的間接子類

BaseEmulatorPreparer 、 BaseTargetPreparer 、 BuildInfoRecorder 、 CreateAvdPreparer 、 CreateUserPreparer 、 DeviceBuildInfoBootStrapper 、 DeviceBuildInfoInjector 、 DeviceCleaner 、 DeviceFlashPreparer 、 DeviceImageZipFlashingTargetPreparer 、 DeviceSetup 、 DeviceUpdateTargetPreparer 、 FastbootUpdateBootstrapPreparer 、 FoldableModePreparer 、 GkiDeviceFlashPreparer等。

BaseEmulatorPreparer	用於啟動本地模擬器的通用準備器。
BaseTargetPreparer	`ITargetPreparer`的基本實現類，允許控制對像是否被禁用。
構建信息記錄器	將構建信息元數據寫入指定文件的`ITargetPreparer` 。
CreateAvdPreparer
創建用戶準備者	目標準備者，用於創建用戶並在最後清理它。
DeviceBuildInfoBootStrapper	用從設備讀取的屬性替換構建信息字段的`ITargetPreparer` 這對於使用從外部源生成的構建測試設備很有用（例如
DeviceBuildInfoInjector	將`ITargetPreparer`元數據插入`DeviceBuildDescriptor`的`IBuildInfo` 。
設備清潔器	測試後執行重新啟動或格式化為清理操作，並可選擇關閉屏幕
DeviceFlashPreparer	在物理 Android 硬件上閃爍圖像的`ITargetPreparer` 。
DeviceImageZipFlashingTargetPreparer	一個目標準備器，它使用通過特定格式提供的設備圖像來刷新設備。
設備設置	一個`ITargetPreparer` ，它根據提供的`Option`配置設備進行測試。
DeviceUpdateTargetPreparer	一個抽象的`ITargetPreparer` ，它負責使用來自外部源的設備映像文件（而不是構建服務）更新設備的常見步驟。
FastbootUpdateBootstrapPreparer	一個`ITargetPreparer`將指定文件（引導加載程序、無線電、設備映像 zip）暫存到`IDeviceBuildInfo`以使用`FastbootDeviceFlasher`刷新設備，然後將啟動後設備屬性注入構建信息以用於結果報告目的。
FoldableModePreparer	可以切換設備可折疊狀態的目標準備器。
GkiDeviceFlashPreparer	使用 android 通用內核通用映像刷新設備的目標準備器。
GsiDeviceFlashPreparer	使用 android 通用系統映像刷新設備的目標準備器。
ITargetCleaner	此接口已棄用。 tearDown 已移至基本 ITargetPreparer 接口。
安裝 ApexModuleTargetPreparer
KillExistingEmulatorPreparer	關閉正在運行的模擬器的`ITargetPreparer` 。
本地模擬器啟動	從 android 構建環境本地啟動模擬器的 TargetPreparer。
LocalEmulatorSnapshot	TargetPreparer 用於從 android 構建/開發環境生成乾淨的模擬器快照
ModuleOemTargetPreparer
恢復日誌準備器	用於在恢復之前收集日誌的目標準備器。
RunCommandTargetPreparer
RunOnSecondaryUserTargetPreparer	一個`ITargetPreparer` ，它在 setup 中創建輔助用戶，並標記應在該用戶中運行測試。
RunOnSystemUserTargetPreparer	一個`ITargetPreparer`標記測試應該在用戶（而不是當前用戶）上運行。
RunOnWorkProfileTargetPreparer	一個`ITargetPreparer` ，它在 setup 中創建一個工作配置文件，並標記應該在該用戶中運行測試。
StubTargetPreparer	佔位符空實現`ITargetPreparer` 。
SuiteApk安裝程序	為套件配置安裝指定的 APK：來自 $ANDROID_TARGET_OUT_TESTCASES 變量或構建信息中的 ROOT_DIR。
TestAppInstallSetup	將`ITargetPreparer` `IDeviceBuildInfo.getTestsDir()`文件夾中的一個或多個應用程序安裝到設備上的 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)`

公共方法

設置

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

此方法已棄用。
改用setUp(com.android.tradefed.invoker.TestInformation)

執行目標設置以進行測試。

參數
`device`	`ITestDevice` ：要準備的`ITestDevice` 。
`buildInfo`	`IBuildInfo` ：關於被測構建的數據。

投擲
`TargetSetupError`	如果設置環境發生致命錯誤
`BuildError`	如果發生與 BuildInfo 相關的錯誤
`DeviceNotAvailableException`	如果設備變得無響應

設置

public void setUp (TestInformation testInformation)

執行目標設置以進行測試。

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

投擲
`TargetSetupError`	如果設置環境發生致命錯誤
`BuildError`	如果由於正在準備構建而發生錯誤
`DeviceNotAvailableException`	如果設備變得無響應

拆除

public void tearDown (TestInformation testInformation, 
                Throwable e)

測試後執行目標清理/拆卸。

參數
`testInformation`	`TestInformation` ：調用的`TestInformation` 。
`e`	`Throwable` ：如果調用以異常結束，這將是在調用級別捕獲的異常。否則，將為`null` 。

投擲
`DeviceNotAvailableException`	如果設備變得無響應

拆除

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`	如果設備變得無響應