ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

已知間接子類別 在 AdbStopServerPreparer 指定準備工具，在執行 ADB 測試前後停止主機上的 ADB 伺服器。  AllTestAppsInstallSetup ITargetPreparer，可將 IDeviceBuildInfo#getTestsDir() 資料夾中的所有應用程式安裝到裝置上。  AoaTargetPreparer ITargetPreparer 會使用 Android Open Accessory (AOAv2) 通訊協定執行一系列動作 (例如點擊和滑動)。  AppSetup 用於安裝 APK 及其測試的 ITargetPreparer。  ArtChrootPreparer 為 ART 測試建立 chroot 目錄。  BaseEmulatorPreparer 用於啟動本機模擬器的通用準備工具。  BaseTargetPreparer ITargetPreparer 的基本實作類別，可控制物件是否停用。  BuildInfoRecorder 將建構資訊中繼資料寫入指定檔案的 ITargetPreparer。  檢查配對準備工具 用於驗證主要和配對裝置之間的 BT 繫結的 CompanionAwarePreparer CompanionAllocator 負責配置和釋出隨附裝置的基礎類別 應實作 getCompanionDeviceSelectionOptions()，以說明分配隨附裝置所需的條件 CompanionAwarePreparer ITargetPreparer，用於封裝取得已分配的隨附裝置的邏輯。  CompanionRunCommandTargetPreparer 在指派的隨附裝置上執行指定指令的 ITargetPreparer CompanionTestAppInstallSetup ITargetPreparer，可從 IDeviceBuildInfo#getTestsDir() 資料夾安裝一或多個應用程式到已分配的隨附裝置。  CompileBootImageWithSpeedTargetPreparer 使用編譯器篩選器「speed」重新編譯啟動 classpath 和系統伺服器。  CpuThrottlingWaiter 等待所有核心達到最高頻率的 ITargetPreparer 會還原為最高級別 CreateAvdPreparer   CreateUserPreparer 指定準備工具來建立使用者，並在最後清理。  DeviceActionTargetPreparer 用於執行裝置動作的 ITargetPreparer。  DeviceBuildInfoBootStrapper ITargetPreparer 會將建構資訊欄位替換為從裝置讀取的屬性 這項功能可用於測試裝置，並使用外部來源產生的版本 (例如 DeviceBuildInfoInjector 將 DeviceBuildDescriptor 中繼資料插入 IBuildInfo 的 ITargetPreparer。  DeviceCleaner 測試後重新啟動或格式化為清理動作，並視需要關閉螢幕 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   InstallApkSetup ITargetPreparer 會安裝位於檔案系統的一或多個 APK。  InstallBuildEnvApkSetup ITargetPreparer 會從 Android 平台建構環境安裝一或多個測試 APK。  InstallKernelModulePreparer 用於安裝核心模組的目標準備工具。  檢測準備工具 執行檢測的 ITargetPreparer KillExistingEmulatorPreparer 關閉執行中模擬器的 ITargetPreparer。  KnownFailurePreparer 目標準備工具可略過已知錯誤重試作業。  LocalEmulator 啟動 從 Android 建構環境在本機啟動模擬器的 TargetPreparer。  LocalEmulatorSnapshot TargetPreparer 旨在從 Android 建構/開發環境產生簡潔的模擬器快照 MixKernelTargetPreparer 可將核心映像檔與裝置映像檔混合的 ITargetPreparer。  ModuleOemTargetPreparer   NativeLeakCollector 執行「dumpsys meminfo --unavailable -a」的 ITargetPreparer，以識別每個程序目前持有的無法連線原生記憶體。  NoApkTestSkipper 特殊的準備工具，可在沒有可測試的 APK 時，完全略過叫用 (準備和測試)。  PerfettoPreparer Perfetto 準備工具會將設定檔推送至 Perfetto 可存取的標準位置。  ProfileTargetPreparer 為任何設定檔使用者 android.os.usertype.profile.XXX 設定目標準備工具的基礎類別。  PushFileInvoker 這個類別已淘汰。 請改用 PushFilePreparer PushFilePreparer ITargetPreparer 會嘗試將任意數量的檔案從任何主機路徑推送至任何裝置路徑。  PythonVirtualenvPreparer 在主機上設定 Python virtualenv，並安裝套件。  RebootTargetPreparer 重新啟動裝置的目標準備工具。  RecoveryLogPreparer 在復原前收集記錄的目標準備工具。  移除 SystemAppPreparer 在測試執行前，從系統分區移除 APK 的 ITargetPreparer。  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 在 setUp 中切換至指定使用者類型的 ITargetPreparer。  TearDownPassThroughPreparer 允許對設定中以物件形式納入的準備器執行 tearDown。  TemperatureThrottlingWaiter ITargetPreparer 會等待裝置溫度降至目標溫度 TestAppInstallSetup ITargetPreparer，可將一或多個應用程式從 IDeviceBuildInfo.getTestsDir() 資料夾安裝到裝置上。  TestFilePushSetup 將一或多個檔案/目錄從 IDeviceBuildInfo.getTestsDir() 資料夾推送至裝置的 ITargetPreparer。  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)

公用方法

設定

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

This method is deprecated.
請改用 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)

This method is deprecated.
請改用 tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

在測試後執行目標清除/拆除作業。

參數
device	ITestDevice：要準備的 ITestDevice。
buildInfo	IBuildInfo：測試中版本的資料。
e	Throwable：如果叫用因例外狀況而結束，這就是在叫用層級所擷取的例外狀況。否則，將為 null。

擲回
DeviceNotAvailableException	裝置沒有回應時