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

ITargetPreparer (目標準備工具)

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

已知間接子類別

在

AdbStopServerPreparer	指定準備工具，在執行 ADB 測試前後停止主機上的 ADB 伺服器。
AllTestAppsInstallSetup	`ITargetPreparer`，可將 `IDeviceBuildInfo#getTestsDir()` 資料夾中的所有應用程式安裝到裝置上。
AoaTargetPreparer	`ITargetPreparer` 會使用 Android Open Accessory (AOAv2) 通訊協定執行一系列動作 (例如點擊和滑動)。
應用程式設定	安裝 APK 及其測試的 `ITargetPreparer`。
ArtChrootPreparer	為 ART 測試建立 chroot 目錄。
BaseEmulatorPreparer	啟動本機模擬器的常見準備工具。
BaseTargetPreparer	`ITargetPreparer` 的基本實作類別，可控制物件是否停用。
BuildInfoRecorder	將建構資訊中繼資料寫入指定檔案的 `ITargetPreparer`。
檢查配對準備工具	用於驗證主要和配對裝置之間的 BT 繫結的 `CompanionAwarePreparer`
CompanionAllocator	負責配置和釋出隨附裝置的基礎類別應實作 `getCompanionDeviceSelectionOptions()`，以說明分配隨附裝置所需的條件
CompanionAwarePreparer	`ITargetPreparer`，用於封裝取得已分配的隨附裝置的邏輯。
CompanionRunCommandTargetPreparer	`ITargetPreparer`，會在已分配的隨附裝置上執行指定指令
CompanionTestAppInstallSetup	`ITargetPreparer`，可從 `IDeviceBuildInfo#getTestsDir()` 資料夾安裝一或多個應用程式到已分配的隨附裝置。
CompileBootImageWithSpeedTargetPreparer	使用編譯器篩選器「speed」重新編譯開機類別路徑和系統伺服器。
CpuThrottlingWaiter	等待所有核心達到最高頻率的 `ITargetPreparer` 會還原為最高級別
CreateAvdPreparer
CreateUserPreparer	指定準備工具來建立使用者，並在最後清理。
DeviceActionTargetPreparer	用於執行裝置動作的 `ITargetPreparer`。
DeviceBuildInfoBootStrapper	`ITargetPreparer` 將建構資訊欄位取代為從裝置讀取的屬性如要測試使用外部來源 (例如
DeviceBuildInfoInjector	將 `DeviceBuildDescriptor` 中繼資料插入 `IBuildInfo` 的 `ITargetPreparer`。
裝置清理工具	測試後重新啟動或格式化為清理動作，並視需要關閉螢幕
DeviceFlashPreparer	`ITargetPreparer` 在實體 Android 硬體上刷新映像檔。
DeviceImageZipFlashingTargetPreparer	利用特定格式提供的裝置映像檔，來刷新裝置的目標準備工具。
DeviceOwnerTargetPreparer	設定裝置擁有者元件的 `ITargetPreparer`。
裝置設定	`ITargetPreparer` 可依據提供的 `Option` 設定要測試的裝置。
DeviceStorageFiller	目標準備工具填滿儲存空間，以便為您提供一些可用空間。
DeviceStringPusher	目標準備工具，將字串寫入檔案。
DeviceUpdateTargetPreparer	抽象的 `ITargetPreparer`，負責處理使用外部來源 (而非建構服務) 的裝置映像檔更新裝置的常見步驟。
DeviceWiper	會抹除使用者資料的 `ITargetPreparer`
停用 SELinuxTargetPreparer	停用 SELinux 的目標準備工具 (如果已啟用)。
DynamicSystemPreparer	`ITargetPreparer`，可在透過動態系統更新的裝置版本上方設定系統映像檔。
清除使用者資料準備工具	會抹除裝置上的使用者資料 `ITargetPreparer`。
FastbootCommandPreparer	觸發 Quickboot 並傳送 Fastboot 指令的目標準備工具。
FastbootUpdateBootstrapPreparer	此 `ITargetPreparer` 會將指定檔案 (系統啟動載入程式、無線電、裝置映像檔 ZIP) 暫存至 `IDeviceBuildInfo`，以便將裝置透過 `FastbootDeviceFlasher` 刷新，然後將啟動後裝置屬性插入版本資訊，以便產生結果報表。
FeatureFlagTargetPreparer	更新 DeviceConfig (由遠端服務調整的功能旗標)。
FoldableModePreparer	可切換裝置的摺疊式裝置狀態的目標準備工具。
資料夾儲存工具	`ITargetPreparer` 可從裝置中提取目錄、壓縮檔案並將其儲存至記錄後端。
GkiDeviceFlashPreparer	使用 Android 通用核心映像檔刷新裝置的目標準備工具。
GsiDeviceFlashPreparer	利用 Android 通用系統映像檔刷新裝置的目標準備工具。
ILabPreparer	實驗室準備者的標記介面請參閱 `ITargetPreparer` 以瞭解這些介面的用途。
ITargetCleaner	這個介面已淘汰。 tearDown 已移至基本 ITargetPreparer 介面。
InstallAllTestZipAppsSetup	會在測試 ZIP 中安裝所有應用程式的 `ITargetPreparer`。
InstallApexModuleTargetPreparer
InstallApk 設定	可在檔案系統中安裝一或多個 APK 的 `ITargetPreparer`。
InstallBuildEnvApkSetup	可從 Android 平台建構環境安裝一或多個測試 APK 的 `ITargetPreparer`。
檢測準備工具	執行檢測的 `ITargetPreparer`
KillExistingEmulatorPreparer	關閉執行中模擬器的 `ITargetPreparer`。
KnownFailurePreparer	目標準備工具可略過已知錯誤重試作業。
LocalEmulator 啟動	可從 Android 建構環境在本機啟動模擬器的 TargetPreparer。
LocalEmulatorSnapshot	TargetPreparer 用於從 Android 建構/開發環境產生簡潔的模擬器快照
MixKernelTargetPreparer	允許將核心映像檔與裝置映像檔混用的 `ITargetPreparer`。
ModuleOemTargetPreparer
NativeLeakCollector	執行「dumpsys meminfo --unavailable -a」的 `ITargetPreparer`，以識別每個程序目前持有的無法連線原生記憶體。
NoApkTestSkipper	特殊的準備工具，可在沒有可測試的 APK 時完全略過叫用 (準備和測試)。
PerfettoPreparer	Perfetto 準備工具會將設定檔推送至裝置，讓每個網路都能存取標準位置。
ProfileTargetPreparer	為任何設定檔使用者 `android.os.usertype.profile.XXX` 設定目標準備工具的基礎類別。
PushFileInvoker	這個類別已淘汰。請改用 `PushFilePreparer`
PushFilePreparer	嘗試從任何主機路徑將任意數量的檔案推送至任何裝置路徑的 `ITargetPreparer`。
PythonVirtualenvPreparer	在主機上設定 Python virtualenv，並安裝套件。
RebootTargetPreparer	用於重新啟動裝置的準備工具。
RecoveryLogPreparer	用來在復原前收集記錄的目標準備器。
移除 SystemAppPreparer	這個 `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	這是使用權杖的準備工具，可將交易主機中的測試執行序列化作業。
SideloadOtaTargetPreparer	目標準備工具會執行指定 OTA 套件的側載、套用套件、等待裝置啟動，以及插入要做為建構資訊的裝置版本屬性這個目標準備工具假設裝置在啟動時會處於一般 ADB 模式，且會確保裝置以相同模式結束，但已套用新版版本。
StopServicesSetup	在裝置上停用服務的 `ITargetPreparer`。
StubTargetPreparer	`ITargetPreparer` 的預留位置實作空白。
SuiteApkInstaller	安裝用於設定套件的指定 APK：透過 $ANDROID_TARGET_OUT_TESTCASES 變數或建構資訊中的 ROOT_DIR。
SwitchUserTargetPreparer	`ITargetPreparer`，可在 setUp 切換至指定使用者種類。
TearDownPassThroughPreparer	允許在設定中做為物件執行 TearDown。
溫度調節等待器	會等到裝置溫度下降達標的 `ITargetPreparer`
TestAppInstallSetup	`ITargetPreparer`，可將一或多個應用程式從 `IDeviceBuildInfo.getTestsDir()` 資料夾安裝到裝置上。
TestFilePushSetup	`ITargetPreparer`，可將一或多個檔案/目錄從 `IDeviceBuildInfo.getTestsDir()` 資料夾推送到裝置上。
TestSystemAppInstallSetup	`ITargetPreparer`，可將一或多個應用程式從 `IDeviceBuildInfo.getTestsDir()` 資料夾安裝到裝置上的 /system 分區。
TimeWaster	利用簡單的目標準備工具來浪費時間，甚至可能重新啟動裝置。
使用者清理工具	`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)`

公用方法

設定

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`	裝置沒有回應時

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`	裝置沒有回應時