自 2026 年起，为了与我们的主干稳定开发模型保持一致，并确保生态系统的平台稳定性，我们将在第 2 季度和第 4 季度将源代码发布到 AOSP。对于构建 AOSP 和向 AOSP 贡献代码，我们建议使用 android-latest-release 而不是 aosp-main。android-latest-release 清单分支将始终引用推送到 AOSP 的最新版本。如需了解详情，请参阅 AOSP 变更。

SearchArtifactUtil

public class SearchArtifactUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.SearchArtifactUtil

可用于搜索测试制品的实用工具类。

摘要

字段
`public static SearchArtifactUtil`	`singleton`

公共构造函数
`SearchArtifactUtil()`

公共方法
`static File`	`findModuleDir(String moduleName, boolean targetFirst)` 查找与指定模块名称匹配的模块目录
`static File`	`getModuleDirFromConfig(IInvocationContext moduleContext)`
`static File`	`getModuleDirFromConfig()` 如果在模块范围内调用，则返回模块目录（如果存在）。
`static File`	`getModuleDirFromConfig(ConfigurationDescriptor descriptor)`
`static File`	`searchFile(String fileName, boolean targetFirst)` 从测试目录中搜索测试制品/依赖项文件。
`static File`	`searchFile(String fileName, boolean targetFirst, IAbi abi)` 从测试目录中搜索测试制品/依赖项文件。
`static File`	`searchFile(String fileName, boolean targetFirst, TestInformation testInfo)` 从测试目录中搜索测试制品/依赖项文件。
`static File`	`searchFile(String fileName, boolean targetFirst, IAbi abi, altDirs, AltDirBehavior altDirBehavior, TestInformation testInfo, boolean includeDirectory)` 从测试目录中搜索测试制品/依赖项文件。
`static File`	`searchFile(String fileName, boolean targetFirst, IAbi abi, altDirs, AltDirBehavior altDirBehavior, TestInformation testInfo)` 从测试目录中搜索测试制品/依赖项文件。
`static File`	`searchFile(String fileName, boolean targetFirst, altDirs, AltDirBehavior altDirBehavior)` 从测试目录中搜索测试制品/依赖项文件。
`static File`	`searchFile(String fileName, boolean targetFirst, IAbi abi, altDirs, AltDirBehavior altDirBehavior, TestInformation testInfo, IBuildInfo buildInfo, boolean includeDirectory)` 从测试目录中搜索测试制品/依赖项文件。

字段

单例

public static SearchArtifactUtil singleton

公共构造函数

SearchArtifactUtil

public SearchArtifactUtil ()

公共方法

findModuleDir

public static File findModuleDir (String moduleName, 
                boolean targetFirst)

查找与指定模块名称匹配的模块目录

参数
`moduleName`	`String`：模块的名称。
`targetFirst`	`boolean`：在搜索时，我们是偏向目标端还是主机端。

返回
`File`	模块目录。可以为 null。

getModuleDirFromConfig

public static File getModuleDirFromConfig (IInvocationContext moduleContext)

参数
`moduleContext`	`IInvocationContext`

返回
`File`

getModuleDirFromConfig

public static File getModuleDirFromConfig ()

如果在模块范围内调用，则返回模块目录（如果存在）。

返回
`File`

getModuleDirFromConfig

public static File getModuleDirFromConfig (ConfigurationDescriptor descriptor)

参数
`descriptor`	`ConfigurationDescriptor`

返回
`File`

searchFile

public static File searchFile (String fileName, 
                boolean targetFirst)

从测试目录中搜索测试制品/依赖项文件。

参数
`fileName`	`String`：要查找的文件的名称。
`targetFirst`	`boolean`：在搜索时，我们是倾向于使用目标设备端文件还是主机端文件。

返回
`File`	找到的制品文件，如果没有则为 null。

searchFile

public static File searchFile (String fileName, 
                boolean targetFirst, 
                IAbi abi)

从测试目录中搜索测试制品/依赖项文件。

参数
`fileName`	`String`：要查找的文件的名称。
`targetFirst`	`boolean`：在搜索时，我们是倾向于使用目标设备端文件还是主机端文件。
`abi`	`IAbi`：要匹配文件的 `IAbi`。

返回
`File`	找到的制品文件，如果没有则为 null。

searchFile

public static File searchFile (String fileName, 
                boolean targetFirst, 
                TestInformation testInfo)

从测试目录中搜索测试制品/依赖项文件。

参数
`fileName`	`String`：要查找的文件的名称。
`targetFirst`	`boolean`：在搜索时，我们是倾向于使用目标设备端文件还是主机端文件。
`testInfo`	`TestInformation`：当前测试的 `TestInformation`（如果可用）。

返回
`File`	找到的制品文件，如果没有则为 null。

searchFile

public static File searchFile (String fileName, 
                boolean targetFirst, 
                IAbi abi, 
                 altDirs, 
                AltDirBehavior altDirBehavior, 
                TestInformation testInfo, 
                boolean includeDirectory)

从测试目录中搜索测试制品/依赖项文件。

参数
`fileName`	`String`：要查找的文件的名称。
`targetFirst`	`boolean`：在搜索时，我们是倾向于使用目标设备端文件还是主机端文件。
`abi`	`IAbi`：要匹配文件的 `IAbi`。
`altDirs`	：除了默认搜索路径之外的其他搜索路径。
`altDirBehavior`	`AltDirBehavior`：如何针对默认路径使用替代搜索路径：作为回退或作为替换；如果未指定，将使用回退
`testInfo`	`TestInformation`：当前测试的 `TestInformation`（如果可用）。
`includeDirectory`	`boolean`：是否在搜索结果中包含目录。

返回
`File`	找到的制品文件，如果没有则为 null。

searchFile

public static File searchFile (String fileName, 
                boolean targetFirst, 
                IAbi abi, 
                 altDirs, 
                AltDirBehavior altDirBehavior, 
                TestInformation testInfo)

从测试目录中搜索测试制品/依赖项文件。

参数
`fileName`	`String`：要查找的文件的名称。
`targetFirst`	`boolean`：在搜索时，我们是倾向于使用目标设备端文件还是主机端文件。
`abi`	`IAbi`：要匹配文件的 `IAbi`。
`altDirs`	：除了默认搜索路径之外的其他搜索路径。
`altDirBehavior`	`AltDirBehavior`：如何针对默认路径使用替代搜索路径：作为回退或作为替换；如果未指定，将使用回退
`testInfo`	`TestInformation`：当前测试的 `TestInformation`（如果可用）。

返回
`File`	找到的制品文件，如果没有则为 null。

searchFile

public static File searchFile (String fileName, 
                boolean targetFirst, 
                 altDirs, 
                AltDirBehavior altDirBehavior)

从测试目录中搜索测试制品/依赖项文件。

参数
`fileName`	`String`：要查找的文件的名称。
`targetFirst`	`boolean`：在搜索时，我们是倾向于使用目标设备端文件还是主机端文件。
`altDirs`	：除了默认搜索路径之外的其他搜索路径。
`altDirBehavior`	`AltDirBehavior`：如何针对默认路径使用替代搜索路径：作为回退或作为替换；如果未指定，将使用回退

返回
`File`	找到的制品文件，如果没有则为 null。

searchFile

public static File searchFile (String fileName, 
                boolean targetFirst, 
                IAbi abi, 
                 altDirs, 
                AltDirBehavior altDirBehavior, 
                TestInformation testInfo, 
                IBuildInfo buildInfo, 
                boolean includeDirectory)

从测试目录中搜索测试制品/依赖项文件。

参数
`fileName`	`String`：要查找的文件的名称。
`targetFirst`	`boolean`：在搜索时，我们是倾向于使用目标设备端文件还是主机端文件。
`abi`	`IAbi`：要匹配文件的 `IAbi`。
`altDirs`	：除了默认搜索路径之外的其他搜索路径。
`altDirBehavior`	`AltDirBehavior`：如何针对默认路径使用替代搜索路径：作为回退或作为替换；如果未指定，将使用回退
`testInfo`	`TestInformation`：当前测试的 `TestInformation`（如果可用）。
`buildInfo`	`IBuildInfo`：当前测试的 `IBuildInfo`（如果可用）。
`includeDirectory`	`boolean`：是否在搜索结果中包含目录。

返回
`File`	找到的制品文件，如果没有则为 null。