com.android.tradefed.targetprep

介面

FlashingResourcesParser.Constraint 篩選介面，可讓 FlashingResourcesParser 忽略某些可能使用的資源。
IDeviceFlasher 在裝置上顯示裝置圖片。 
IFlashingResourcesParser 介面：提供刷寫裝置所需的輔助映像檔版本。 
IFlashingResourcesRetriever 用於擷取輔助圖片檔案的介面，必須先擷取這些檔案才能刷寫裝置。 
IHostCleaner 測試執行完畢後，清除主機。 
ILabPreparer 實驗室準備人員的標記介面

如要瞭解這些介面的用途，請參閱 ITargetPreparer。 

ITargetCleaner 這個介面已淘汰。 tearDown 已移至基礎 ITargetPreparer 介面。 
ITargetPreparer 為測試執行準備測試環境。 
ITestsZipInstaller 在裝置上安裝測試 (來自建構系統輸出的測試 ZIP 檔案)。 

類別

AllTestAppsInstallSetup ITargetPreparer，可將 IDeviceBuildInfo.getTestsDir() 資料夾中的所有應用程式安裝到裝置上。 
AoaTargetPreparer ITargetPreparer，可使用 Android Open Accessory (AOAv2) 通訊協定執行一系列動作 (例如點按和滑動)。 
AppSetup 安裝 APK 及其測試的 ITargetPreparer。 
ArtChrootPreparer 為 ART 測試建立 chroot 目錄。 
BaseEmulatorPreparer 啟動本機模擬器的常見準備程序。 
BaseTargetPreparer ITargetPreparer 的基本實作類別，可控制物件是否已停用。 
BuildError 如果提供的建構作業無法執行，就會擲回這個例外狀況。 
BuildInfoRecorder ITargetPreparer，可將建構資訊中繼資料寫入指定檔案。 
CdmaDeviceFlasher 這個類別會在搭載 CDMA 無線電的實體 Android 裝置上刷新映像檔。 
CompileBootImageWithSpeedTargetPreparer 使用編譯器篩選器「speed」重新編譯開機類路徑和系統伺服器。 
CpuThrottlingWaiter ITargetPreparer：等待所有核心的最高頻率恢復到最高可用等級
CreateAvdPreparer  
CreateUserPreparer 目標準備人員，負責建立使用者，並在最後清除使用者。 
DefaultTestsZipInstaller 測試 zip 安裝程式的預設實作方式。 
DeviceActionTargetPreparer ITargetPreparer 執行裝置動作。 
DeviceBuildInfoBootStrapper ITargetPreparer，可將建構資訊欄位替換為從裝置讀取的屬性

這項功能適用於測試裝置，並使用從外部來源產生的建構版本 (例如 

DeviceBuildInfoInjector ITargetPreparer，可將 DeviceBuildDescriptor 中繼資料插入 IBuildInfo。 
DeviceCleaner 在測試後執行重新啟動或格式化作業，做為清除動作，並視需要關閉螢幕 
DeviceFailedToBootError 如果裝置在刷入版本後無法啟動，就會擲回這個例外狀況。 
DeviceFlashPreparer ITargetPreparer，可將映像檔刷新至實體 Android 硬體。 
DeviceImageZipFlashingTargetPreparer 目標準備工具，可透過特定格式提供的裝置映像檔刷新裝置。 
DeviceOwnerTargetPreparer 用來設定裝置擁有者元件的 ITargetPreparer。 
DeviceSetup ITargetPreparer：根據提供的 Option 設定裝置以進行測試。 
DeviceStorageFiller 目標是填滿儲存空間，但仍保留一些可用空間。 
DeviceStringPusher 目標準備工具，可將字串寫入檔案。 
DeviceUpdateTargetPreparer 抽象 ITargetPreparer，負責處理從外部來源 (而非建構服務) 使用裝置映像檔檔案更新裝置的常見步驟。 
DeviceWiper 可清除使用者資料的 ITargetPreparer
DisableSELinuxTargetPreparer 目標準備工具，可停用已啟用的 SELinux。 
DynamicSystemPreparer ITargetPreparer，可透過動態系統更新在裝置建構版本上設定系統映像檔。 
EraseUserDataPreparer ITargetPreparer，可抹除裝置上的使用者資料。 
FastbootCommandPreparer 目標準備器，可觸發 Fastboot 並傳送 Fastboot 指令。 
FastbootDeviceFlasher 這個類別會使用 Fastboot 在實體 Android 硬體上刷入映像檔。 
FastbootUpdateBootstrapPreparer ITargetPreparer 會將指定檔案 (系統啟動載入程式、無線電、裝置映像檔 ZIP) 暫存到 IDeviceBuildInfo，以便使用 FastbootDeviceFlasher 刷入裝置，然後將開機後裝置屬性插入建構資訊，用於回報結果。 
FeatureFlagTargetPreparer 更新 DeviceConfig (由遠端服務調整的功能旗標)。 
FlashingResourcesParser 這個類別會剖析刷寫裝置所需的輔助映像檔版本。 
FlashingResourcesParser.AndroidInfo Map<String, MultiMap<String, String>> 的 typedef。 
FolderSaver ITargetPreparer：從裝置中提取目錄、壓縮並儲存到記錄後端。 
FutilityCommandPreparer 準備執行無效指令。 
GkiDeviceFlashPreparer 目標準備工具，可使用 Android 通用核心一般映像檔刷寫裝置。 
GsiDeviceFlashPreparer 目標準備工具，可使用 Android 一般系統映像檔刷新裝置。 
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  
ModulePusher  
ModulePusher.ModulePushError 推送 Mainline 模組時發生嚴重錯誤。 
NativeLeakCollector 執行「dumpsys meminfo --unreachable -a」的 ITargetPreparer，可找出每個程序目前持有的無法存取原生記憶體。 
OtaUpdateDeviceFlasher 裝置刷機工具，可使用完整或增量 OTA 套件觸發 system/update_engine/scripts/update_device.py 指令碼，以更新裝置映像檔。 
PerfettoPreparer Perfetto 準備工具會將設定檔推送到裝置的標準位置，Perfetto 可存取該位置。 
ProfileTargetPreparer 設定任何設定檔使用者 android.os.usertype.profile.XXX 的目標準備工具的基礎類別。 
PushFileInvoker 這個類別已淘汰。 請改用 PushFilePreparer 
PushFilePreparer ITargetPreparer，可嘗試將任意數量的檔案從任何主機路徑推送至任何裝置路徑。 
PythonVirtualenvPreparer 在主機上設定 Python virtualenv 並安裝套件。 
RebootTargetPreparer 目標準備人員重新啟動裝置。 
RecoveryLogPreparer 目標準備人員先前曾收集記錄。 
RemoveSystemAppPreparer ITargetPreparer，以便在測試執行前從系統分割區移除 APK。 
RestartSystemServerTargetPreparer 目標準備人員，負責重新啟動系統伺服器，但不會重新啟動裝置。 
RootcanalForwarderPreparer  
RootTargetPreparer 目標準備人員會根據「force-root」選項執行「adb root」或「adb unroot」。 
RunCommandTargetPreparer  
RunHostCommandTargetPreparer 目標準備工具，可在執行測試前後執行任意主機指令。 
RunHostScriptTargetPreparer 目標準備工具，會在執行測試前執行指令碼。 
RunOnCloneProfileTargetPreparer  
RunOnPrivateProfileTargetPreparer  
RunOnSdkSandboxTargetPreparer ITargetPreparer，標記測試應在 SDK 沙箱中執行。 
RunOnSecondaryUserTargetPreparer ITargetPreparer，確保測試以次要使用者身分執行。 
RunOnSystemUserTargetPreparer ITargetPreparer，表示應對使用者 (而非目前使用者) 執行測試。 
RunOnWorkProfileTargetPreparer ITargetPreparer：在設定中建立工作資料夾，並標記應在該使用者中執行的測試。 
SemaphoreTokenTargetPreparer 這是用來在 Tradefed 主機中，使用權杖序列化測試執行的準備工具。 
SideloadOtaTargetPreparer 目標準備工具，可執行指定 OTA 套件的側載作業、套用套件、等待裝置啟動，並插入裝置建構屬性，做為建構資訊使用。

這個目標準備工具假設裝置會在啟動時處於一般 adb 模式，並確保裝置會以相同模式結束，但會套用較新的建構版本。 

StopServicesSetup ITargetPreparer，停止裝置上的服務。 
StubTargetPreparer ITargetPreparer 的空白實作預留位置。 
SwitchUserTargetPreparer 在 setUp 中切換至指定使用者類型的 ITargetPreparer。 
SystemUpdaterDeviceFlasher IDeviceFlasher：依賴系統更新程式安裝 OTA 更新套件中隨附的系統映像檔。 
TargetSetupError 準備測試目標時發生嚴重錯誤。 
TearDownPassThroughPreparer 允許對以物件形式納入設定中的準備工具執行 tearDown。 
TemperatureThrottlingWaiter ITargetPreparer：等待裝置溫度降至目標溫度。
TestAppInstallSetup ITargetPreparer：從 IDeviceBuildInfo.getTestsDir() 資料夾將一或多個應用程式安裝到裝置上。 
TestFilePushSetup ITargetPreparer，可將一或多個檔案/目錄從 IDeviceBuildInfo.getTestsDir() 資料夾推送至裝置。 
TestSystemAppInstallSetup ITargetPreparer，可將一或多個應用程式從 IDeviceBuildInfo.getTestsDir() 資料夾安裝到裝置的 /system 分區。 
TimeWaster 這個簡單的目標準備工具會浪費時間，而且可能會重新啟動裝置。 
UserCleaner ITargetPreparer，在拆除時移除次要使用者。 
UserHelper  
VisibleBackgroundUserPreparer 目標準備工具，用於在背景啟動的使用者中執行測試。 
WaitForDeviceDatetimePreparer ITargetPreparer，等待裝置設定日期時間

如果未在逾時時間內設定日期時間，這個準備者可以選擇強制執行 TargetSetupError。 

WifiPreparer 視需要設定裝置的 Wi-Fi ITargetPreparer。 

列舉

AltDirBehavior 列舉，用於定義各種測試構件安裝程式/推送程式的替代目錄行為

 

DeviceCleaner.CleanupAction  
DeviceCleaner.PostCleanupAction  
FlashingMethod 列舉，用於說明測試裝置的刷機方法 
IDeviceFlasher.UserDataFlashOption 用於處理 userdata 映像檔的選項列舉