為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將自 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，請使用 android-latest-release。android-latest-release 資訊清單分支版本一律會參照推送至 Android 開放原始碼計畫的最新版本。詳情請參閱「Android 開放原始碼計畫變更」。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

BaseModuleController

public abstract class BaseModuleController
extends Object implements IModuleController

java.lang.Object
↳	com.android.tradefed.testtype.suite.module.BaseModuleController

已知的直接子類別

ArchModuleController、CarModuleController、CommandSuccessModuleController、DeviceFeatureModuleController、KernelTestModuleController、MainlineTestModuleController、MaxSdkModuleController、MinApiLevelModuleController、MinSdkModuleController、NativeBridgeModuleController、PackageInstalledModuleController、ShippingApiLevelModuleController、SkipHWASanModuleController、TestFailureModuleController

ArchModuleController	模組控制器，在不符合任何指定架構時，不會執行測試。
CarModuleController	這個控制器可防止在非車輛裝置上執行測試案例。
CommandSuccessModuleController	模組控制器的基底類別，可根據 Shell 指令失敗略過測試模組。
DeviceFeatureModuleController	模組控制器，可在不支援特定功能時不執行測試。
KernelTestModuleController	模組控制器的基礎類別，不符合架構時不會執行測試。
MainlineTestModuleController	模組控制器的基底類別，可根據受測裝置上預先載入的主線模組執行測試。
MaxSdkModuleController	模組控制器的基礎類別，不會在指定 SDK 版本號碼以上的版本執行測試。
MinApiLevelModuleController	模組控制器的基礎類別，可在低於指定 API 級別時不執行測試。
MinSdkModuleController	模組控制器的基礎類別，不會在低於指定 SDK 版本號碼的版本上執行測試。
NativeBridgeModuleController	模組控制器，用於檢查裝置是否支援原生橋接。
PackageInstalledModuleController	如果裝置未安裝指定套件，模組控制器就不會執行測試。
ShippingApiLevelModuleController	如果裝置符合下列條件，請執行測試：如果已定義 `min-api-level`：裝置出廠時搭載 `min-api-level` 以上版本。
SkipHWASanModuleController	模組控制器的基礎類別，不會在 HWASan 建構版本上執行測試。
TestFailureModuleController	模組的控制器，可單純調整測試失敗記錄的收集方式。

已知間接子類別

Sdk28ModuleController、Sdk29ModuleController、Sdk30ModuleController、Sdk31ModuleController、Sdk32ModuleController、Sdk33ModuleController、Sdk34ModuleController、Sdk35ModuleController、Sdk36ModuleController、Sdk37ModuleController

Sdk28ModuleController	模組控制器，用於檢查裝置是否搭載 SDK 28 (Android 9) 以上版本。
Sdk29ModuleController	只有在受測裝置的 SDK 版本為 29 以上時，才執行測試。
Sdk30ModuleController	只有在受測裝置的 SDK 版本為 30 以上時，才執行測試。
Sdk31ModuleController	只有在受測裝置的 SDK 版本為 31 以上時，才執行測試。
Sdk32ModuleController	只有在受測裝置的 SDK 版本為 32 以上時，才執行測試。
Sdk33ModuleController	只有在受測裝置的 SDK 版本為 33 以上時，才執行測試。
Sdk34ModuleController	只有在受測裝置的 SDK 版本為 34 以上時，才執行測試。
Sdk35ModuleController	只有在受測裝置的 SDK 版本為 35 以上時，才執行測試。
Sdk36ModuleController	只有在受測裝置的 SDK 版本為 36 以上時，才執行測試。
Sdk37ModuleController	只有在受測裝置的 SDK 版本為 37 以上時，才執行測試。

IModuleController 的基本實作，應實作此方法來檢查模組是否應執行。

摘要

公用建構函式
`BaseModuleController()`

公用方法
`final IAbi`	`getModuleAbi()` 輔助方法，用於取得模組 ABI。
`final String`	`getModuleName()` 輔助方法，用於取得模組名稱。
`final boolean`	`shouldCaptureBugreport()` 傳回模組是否要在測試失敗時擷取錯誤報告。
`final boolean`	`shouldCaptureLogcat()` 傳回模組是否要在測試失敗時擷取 logcat。
`final boolean`	`shouldCaptureScreenshot()` Returns whether of not the module wants to capture the screenshot on test failure.
`abstract IModuleController.RunStrategy`	`shouldRun(IInvocationContext context)` 決定是否應執行模組的方法。
`final IModuleController.RunStrategy`	`shouldRunModule(IInvocationContext context)` 判斷模組是否應執行的方法。

公用建構函式

BaseModuleController

public BaseModuleController ()

公用方法

getModuleAbi

public final IAbi getModuleAbi ()

取得模組 ABI 的輔助方法。

傳回
`IAbi`

getModuleName

public final String getModuleName ()

取得模組名稱的輔助方法。

傳回
`String`

shouldCaptureBugreport

public final boolean shouldCaptureBugreport ()

傳回模組是否要在測試失敗時擷取錯誤報告。

傳回
`boolean`

shouldCaptureLogcat

public final boolean shouldCaptureLogcat ()

傳回模組是否要在測試失敗時擷取 logcat。

傳回
`boolean`

shouldCaptureScreenshot

public final boolean shouldCaptureScreenshot ()

Returns whether of not the module wants to capture the screenshot on test failure.

傳回
`boolean`

shouldRun

public abstract IModuleController.RunStrategy shouldRun (IInvocationContext context)

決定是否應執行模組的方法。

參數
`context`	`IInvocationContext`：模組的 `IInvocationContext`

傳回
`IModuleController.RunStrategy`	如果應執行模組，則為 True，否則為 False。

擲回
`DeviceNotAvailableException`

shouldRunModule

public final IModuleController.RunStrategy shouldRunModule (IInvocationContext context)

判斷模組是否應執行的相關方法。

參數
`context`	`IInvocationContext`：模組的 `IInvocationContext`。

傳回
`IModuleController.RunStrategy`	如果應執行模組，則為 True，否則為 False。

擲回
`DeviceNotAvailableException`