自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

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

TestMapping

public class TestMapping
extends Object

java.lang.Object
↳	com.android.tradefed.util.testmapping.TestMapping

用於載入 TEST_MAPPING 檔案的類別。

摘要

欄位
`public static final Pattern`	`MAINLINE_REGEX`
`public static final String`	`TEST_MAPPINGS_ZIP`
`public static final String`	`TEST_SOURCES`

公用建構函式
`TestMapping()` 用於初始化空白 `TestMapping` 物件的建構函式。
`TestMapping( testMappingRelativePaths, boolean ignoreTestMappingImports)` 用來建立 `TestMapping` 物件的建構函式。

公用方法
`static File`	`extractTestMappingsZip(File testMappingsZip)` 解壓縮 ZIP 檔案，並傳回包含已解壓縮檔案內容的目錄。
	`getAllTests(File testMappingsDir)` 輔助程式可從指定目錄中尋找 TEST_MAPPING 檔案中的所有測試。
`static Matcher`	`getMainlineTestModuleName(TestInfo info)` 取得參數化主線測試的比對工具的輔助程式。
	`getTests(IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords)` 根據裝置版本中的構件，在所有 TEST_MAPPING 檔案中尋找所有測試的輔助工具。
	`getTests(IBuildInfo buildInfo, String testGroup, boolean hostOnly, keywords, ignoreKeywords, extraZipNames, matchedPatternPaths)` 根據指定的構件，在所有 TEST_MAPPING 檔案中尋找所有測試的輔助程式。
`void`	`listTestMappingFiles(Path testMappingDir, Path testMappingsRootDir, filePaths)` 輔助程式可列出所有測試對應檔案，並尋找所有父目錄和相關匯入路徑。

欄位

MAINLINE_REGEX

public static final Pattern MAINLINE_REGEX

TEST_MAPPINGS_ZIP

public static final String TEST_MAPPINGS_ZIP

TEST_SOURCES

public static final String TEST_SOURCES

公用建構函式

TestMapping

public TestMapping ()

用於初始化空白 TestMapping 物件的建構函式。

TestMapping

public TestMapping ( testMappingRelativePaths, 
                boolean ignoreTestMappingImports)

用於建立 TestMapping 物件的建構函式。

參數
`testMappingRelativePaths`	：TEST_MAPPING 檔案路徑的 `ERROR(/List)`。
`ignoreTestMappingImports`	`boolean`：要忽略匯入作業的 `ERROR(/boolean)`。

公用方法

extractTestMappingsZip

public static File extractTestMappingsZip (File testMappingsZip)

解壓縮 ZIP 檔案，並傳回包含已解壓縮檔案內容的目錄。

參數
`testMappingsZip`	`File`：要擷取的測試對應項目 ZIP 檔案的 `ERROR(/File)`。

傳回
`File`	`ERROR(/File)` 指向測試對應項目 ZIP 檔案的暫存目錄。

getAllTests

public  getAllTests (File testMappingsDir)

輔助程式，用於從指定目錄中尋找 TEST_MAPPING 檔案中的所有測試。

參數
`testMappingsDir`	`File`：`ERROR(/File)` 是包含所有測試對應檔案的目錄。

傳回
	指定目錄及其子目錄中的測試 `Map<String, Set<TestInfo>>`。

getMainlineTestModuleName

public static Matcher getMainlineTestModuleName (TestInfo info)

取得參數化主線測試的比對工具的輔助程式。

參數
`info`	`TestInfo`

傳回
`Matcher`	用於參數化主線測試的 `ERROR(/Matcher)`。

擲回
`ConfigurationException`

getTests

public  getTests (IBuildInfo buildInfo, 
                String testGroup, 
                boolean hostOnly, 
                 keywords, 
                 ignoreKeywords)

輔助程式可根據裝置版本中的構件，在所有 TEST_MAPPING 檔案中尋找所有測試。

參數
`buildInfo`	`IBuildInfo`：描述建構作業的 `IBuildInfo`。
`testGroup`	`String`：測試組的 `String`。
`hostOnly`	`boolean`：如果只應傳回在主機上執行且不需要裝置的測試，請傳回 true。如果要傳回需要裝置才能執行的測試，請傳回 false。
`keywords`	：在測試對應套件中篩選要執行的測試時，要比對的一組 `String`。
`ignoreKeywords`	：一組要忽略的 `String` 關鍵字。

傳回
	在建構構件 test_mappings.zip 中設定的測試 `Set<TestInfo>`。

getTests

public  getTests (IBuildInfo buildInfo, 
                String testGroup, 
                boolean hostOnly, 
                 keywords, 
                 ignoreKeywords, 
                 extraZipNames, 
                 matchedPatternPaths)

根據指定的構件，在所有 TEST_MAPPING 檔案中尋找所有測試的輔助程式。當套件執行作業需要針對特定群組 (例如提交前) 執行 TEST_MAPPING 檔案中的所有測試時，就需要使用此選項。

參數
`buildInfo`	`IBuildInfo`：描述建構作業的 `IBuildInfo`。
`testGroup`	`String`：測試組的 `String`。
`hostOnly`	`boolean`：如果只應傳回在主機上執行且不需要裝置的測試，請傳回 true。如果要傳回需要裝置才能執行的測試，請傳回 false。
`keywords`	：在測試對應套件中篩選要執行的測試時，要比對的一組 `String`。
`ignoreKeywords`	：一組要忽略的 `String` 關鍵字。
`extraZipNames`	：一組 `String`，用於指定要合併的其他 test_mappings.zip 檔案名稱。
`matchedPatternPaths`	：`ERROR(/Set)` 與檔案路徑相符的模式。

傳回
	在建構構件 test_mappings.zip 中設定的測試 `Set<TestInfo>`。

listTestMappingFiles

public void listTestMappingFiles (Path testMappingDir, 
                Path testMappingsRootDir, 
                 filePaths)

輔助程式可列出所有測試對應檔案，並尋找所有父目錄和相關匯入路徑。

參數
`testMappingDir`	`Path`：指向 TEST_MAPPING 檔案父目錄的 `ERROR(/Path)`。
`testMappingsRootDir`	`Path`：建構作業的所有 TEST_MAPPING 檔案的資料夾 `ERROR(/Path)`。
`filePaths`	：用於儲存所有 TEST_MAPPING 路徑的 `ERROR(/Set)`。