本頁面由 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 , CompanionTestAppIn stallSetup 、 CompileBootImageWithSpeedTargetPreparer 、 CpuThrottlingWaiter和其他 72 個。

AdbStopServerPreparer	目標準備器在運行 adb 測試之前和之後停止主機上的 adb 服務器。
所有測試應用程序安裝設置	將`IDeviceBuildInfo#getTestsDir()`文件夾中的所有應用程序安裝到設備上的`ITargetPreparer` 。
Aoa目標準備器	`ITargetPreparer`使用 Android Open Accessory (AOAv2) 協議執行一系列操作（例如點擊和滑動）。
應用設置	安裝 apk 及其測試的`ITargetPreparer` 。
ArtChrootPreparer	為 ART 測試創建 chroot 目錄。
BaseEmulatorPreparer	用於啟動本地模擬器的通用準備器。
基礎目標準備者	`ITargetPreparer`的基本實現類，允許控制對像是否被禁用。
構建信息記錄器	將構建信息元數據寫入指定文件的`ITargetPreparer` 。
檢查配對準備器	一個`CompanionAwarePreparer` ，用於驗證主要設備和配套設備之間的 BT 綁定
同伴分配器	負責分配和釋放配套設備的基類應該實施`getCompanionDeviceSelectionOptions()`來描述分配配套設備所需的標準
CompanionAware準備者	一個`ITargetPreparer` ，它封裝了獲取已分配的配套設備的邏輯。
CompanionRunCommandTargetPreparer	在分配的配套設備上運行指定命令的`ITargetPreparer`
CompanionTestAppInstallSetup	一個`ITargetPreparer` ，它將`IDeviceBuildInfo#getTestsDir()`文件夾中的一個或多個應用程序安裝到分配的配套設備上。
CompileBootImageWithSpeedTargetPreparer	使用編譯器過濾器“speed”重新編譯引導類路徑和系統服務器。
CpuThrottlingWaiter	`ITargetPreparer`等待所有內核的最大頻率恢復到可用的最高級別
創建AvdPreparer
創建用戶準備者	用於創建用戶並在最後清理它的目標準備器。
DeviceBuildInfoBootStrapper	用從設備讀取的屬性替換構建信息字段的`ITargetPreparer` 這對於測試具有從外部源生成的構建的設備很有用（例如
DeviceBuildInfoInjector	將`DeviceBuildDescriptor`元數據插入`IBuildInfo` `ITargetPreparer` 。
設備清理器	在測試後執行重啟或格式化作為清理操作，並可選擇關閉屏幕
DeviceFlashPreparer	在物理 Android 硬件上閃爍圖像的`ITargetPreparer` 。
DeviceImageZipFlashingTargetPreparer	一個目標準備器，它使用通過特定格式提供的設備映像刷新設備。
設備所有者目標準備者	設置設備所有者組件的`ITargetPreparer` 。
設備設置	一個`ITargetPreparer` ，它根據提供的`Option`配置設備進行測試。
設備存儲填充器	目標準備器填滿存儲空間，以便有一些可用空間可用。
設備字符串推送器	目標準備器將字符串寫入文件。
設備更新目標準備器	一個抽象的`ITargetPreparer` ，它負責使用來自外部源（與構建服務相對）的設備映像文件更新設備的常見步驟。
設備刮水器	擦除用戶數據的`ITargetPreparer`
禁用 SELinuxTargetPreparer	如果啟用，則禁用 SELinux 的目標準備器。
動態系統準備器	一個`ITargetPreparer` ，它在使用動態系統更新構建的設備之上設置系統映像。
擦除用戶數據準備者	擦除設備上的用戶數據的`ITargetPreparer` 。
FastbootCommandPreparer	觸發 fastboot 並發送 fastboot 命令的目標準備器。
FastbootUpdateBootstrapPreparer	一個`ITargetPreparer`將指定文件（引導加載程序、無線電、設備映像 zip）暫存到`IDeviceBuildInfo`中以使用`FastbootDeviceFlasher`刷新設備，然後將啟動後設備屬性注入構建信息以用於結果報告目的。
FeatureFlagTargetPreparer	更新 DeviceConfig（由遠程服務調整的功能標誌）。
可折疊模式準備器	可以切換設備折疊狀態的目標準備器。
文件夾保護程序	一個`ITargetPreparer` ，它從設備中提取目錄，壓縮並將其保存到日誌記錄後端。
GkiDeviceFlashPreparer	使用 android 通用內核通用映像刷新設備的目標準備器。
GsiDeviceFlashPreparer	使用 android 通用系統映像刷新設備的目標準備器。
ILab準備者	實驗室準備者的標記界面有關這些接口的用途的說明，請參閱`ITargetPreparer` 。
ITargetCleaner	此接口已棄用。 tearDown 已移至基礎 ITargetPreparer 接口。
InstallAllTestZipAppsSetup	在測試 zip 中安裝所有應用程序的`ITargetPreparer` 。
安裝 ApexModuleTargetPreparer
安裝ApkSetup	一個`ITargetPreparer` ，用於安裝位於文件系統上的一個或多個 apk。
安裝BuildEnvApkSetup	從 Android 平台構建環境安裝一個或多個測試 apk 的`ITargetPreparer` 。
InstrumentationPreparer工具	運行檢測的`ITargetPreparer`
KillExistingEmulatorPreparer	關閉正在運行的模擬器的`ITargetPreparer` 。
已知故障準備者	目標準備程序跳過重試已知失敗。
本地模擬器啟動	從 android 構建環境本地啟動模擬器的 TargetPreparer。
本地模擬器快照	用於從 android 構建/開發環境生成乾淨的模擬器快照的 TargetPreparer
MixKernelTargetPreparer	允許將內核映像與設備映像混合的`ITargetPreparer` 。
模塊OemTargetPreparer
NativeLeakCollector	運行“dumpsys meminfo --unreachable -a”的`ITargetPreparer`來識別每個進程當前持有的無法訪問的本機內存。
NoApkTestSkipper	如果沒有要測試的 apk，允許完全跳過調用（準備和測試）的特殊準備器。
完美準備者	Perfetto 準備器將配置文件推送到設備中 perfetto 有權訪問的標準位置。
簡介目標準備者	為任何配置文件用戶`android.os.usertype.profile.XXX`設置目標準備器的基類。
PushFileInvoker	此類已棄用。改為使用`PushFilePreparer`
推送文件準備器	一個`ITargetPreparer` ，它試圖將任意數量的文件從任意主機路徑推送到任意設備路徑。
PythonVirtualenvPreparer	在主機上設置 Python virtualenv 並安裝包。
RebootTargetPreparer	重新啟動設備的目標準備器。
恢復日誌準備器	用於在恢復之前收集日誌的目標準備器。
刪除SystemAppPreparer	用於在測試運行之前從系統分區中刪除 apk 的`ITargetPreparer` 。
RestartSystemServerTargetPreparer	在不重啟設備的情況下重啟系統服務器的目標準備器。
根目標準備器	基於選項“force-root”執行“adb root”或“adb unroot”的目標準備器。
RunCommandTargetPreparer
RunHostCommandTargetPreparer	目標準備器在運行測試之前和之後運行任意主機命令。
RunHostScriptTargetPreparer	在運行測試之前執行腳本的目標準備器。
RunOnCloneProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	一個`ITargetPreparer`來標記測試應該在 sdk 沙箱中運行。
RunOnSecondaryUserTargetPreparer	一個`ITargetPreparer` ，它在設置中創建一個輔助用戶，並標記應該在該用戶中運行的測試。
RunOnSystemUserTargetPreparer	標記應在用戶（而不是當前用戶）上運行測試的`ITargetPreparer` 。
RunOnWorkProfileTargetPreparer	一個`ITargetPreparer` ，它在設置中創建一個工作配置文件，並標記應該在該用戶中運行的測試。
信號量令牌目標準備器	這是一個準備程序，用於使用令牌在 tradefed 主機中序列化測試執行。
側載OtaTargetPreparer	執行指定 OTA 包的側載、應用包、等待設備啟動並註入設備構建屬性以用作構建信息的目標準備器此目標準備器假定設備在啟動時將處於常規 adb 模式，並將確保設備以相同模式退出但應用了較新的構建。
停止服務設置	停止設備上的服務的`ITargetPreparer` 。
StubTargetPreparer	`ITargetPreparer`的佔位符空實現。
SuiteApk安裝程序	為套件配置安裝指定的 APK：來自 $ANDROID_TARGET_OUT_TESTCASES 變量或構建信息中的 ROOT_DIR。
SwitchUserTargetPreparer	在 setUp 中切換到指定用戶種類的`ITargetPreparer` 。
TearDownPassThroughPreparer	允許在作為對象包含在配置中的準備器上運行 tearDown。
TemperatureThrottlingWaiter	`ITargetPreparer`等待設備溫度降至目標值
測試應用程序安裝設置	一個`ITargetPreparer` ，用於將`IDeviceBuildInfo.getTestsDir()`文件夾中的一個或多個應用程序安裝到設備上。
測試文件推送設置	將一個或多個文件/目錄從`IDeviceBuildInfo.getTestsDir()`文件夾推送到設備上的`ITargetPreparer` 。
測試系統AppInstallSetup	一個`ITargetPreparer` ，它將`IDeviceBuildInfo.getTestsDir()`文件夾中的一個或多個應用程序安裝到設備上的 /system 分區。
浪費時間的人	一個簡單的目標準備器會浪費時間並可能重新啟動設備。
用戶清理器	在拆卸時刪除次要用戶的`ITargetPreparer` 。
VisibleBackgroundUserPreparer	Target 準備器用於在後台可見的用戶中運行測試。
WaitForDeviceDatetimePreparer	等待在設備上設置日期時間的`ITargetPreparer` 如果 datetime 未在超時內設置，則此準備程序可以選擇強制`TargetSetupError` ，或者強制主機 datetime 到設備上，
Wifi準備器	必要時在設備上配置 wifi 的`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`	如果設備變得無響應