此页面由 Cloud Translation API 翻译。

构建信息

public class BuildInfo
extends Object implements IBuildInfo

java.lang.Object
↳	com.android.tradefed.build.BuildInfo

已知的直接子类

AppBuildInfo 、 DeviceBuildInfo 、 FolderBuildInfo 、 OtatoolsBuildInfo

应用程序构建信息	表示 Android 应用程序及其测试包的`IBuildInfo` 。
设备构建信息	表示完整 Android 设备构建及其（可选）测试的`IBuildInfo` 。
文件夹构建信息	`IFolderBuildInfo`的具体实现。
Otatools构建信息	包含 otatools 工件的`IBuildInfo` 。

已知的间接子类

AppDeviceBuildInfo 、 ClusterBuildInfo 、 DeviceFolderBuildInfo 、 OtaDeviceBuildInfo

应用程序设备构建信息	该类已被弃用。直接使用`IDeviceBuildInfo` 。
集群构建信息	用于从 TFC 管道传输的构建的`IBuildInfo`类。
设备文件夹构建信息	`IDeviceBuildInfo`还包含本地文件系统上的目录中包含的其他构建工件。
OtaDeviceBuildInfo	用于无线更新测试的`IDeviceBuildInfo` 。

应与ITestDevice关联的IBuildInfo的通用实现。

概括

公共构造函数
`BuildInfo ()` 使用默认属性值创建`BuildInfo` 。
`BuildInfo (String buildId, String buildTargetName)` 创建`BuildInfo`

公共方法
`void`	`addAppPackageFile (File appPackageFile, String version)` 添加本地 apk 文件及其关联版本。
`void`	`addBuildAttribute (String attributeName, String attributeValue)` 添加构建属性。
`void`	`addBuildAttributes ( buildAttributes)` `addBuildAttributes ( buildAttributes)` 添加构建属性
`void`	`cleanUp ()` 清理所有临时构建文件
`void`	`cleanUp ( doNotClean)` `cleanUp ( doNotClean)` `cleanUp()`的版本，其中某些文件不会被删除。
`IBuildInfo`	`clone ()`
`final void`	`copyAllFileFrom ( BuildInfo build)` 将给定版本中的所有`VersionedFile`复制到此版本。
`boolean`	`equals (Object obj)`
`static IBuildInfo`	`fromProto (BuildInformation.BuildInfo protoBuild)` `toProto()`的逆操作以获取实例。
	`getAppPackageFiles ()` 获取本地应用程序 apk 文件集及其版本的副本。
	`getBuildAttributes ()` 获取一组描述构建的附加属性的名称/值对。
`String`	`getBuildBranch ()` 返回生成正在测试的版本的源代码控制分支的可选方法。
`String`	`getBuildFlavor ()` 返回正在测试的构建类型的可选方法。
`String`	`getBuildId ()` 返回被测版本的唯一标识符。
`String`	`getBuildTargetName ()` 返回正在测试的构建的完整名称。
`String`	`getDeviceSerial ()`
`File`	`getFile (String name)` 用于检索具有给定名称的文件的帮助程序方法。
`File`	`getFile ( BuildInfoKey.BuildInfoFileKey key)` 使用给定的`BuildInfoFileKey`检索文件的帮助程序方法。
	`getFiles ()` 返回此`BuildInfo`中存储的所有`VersionedFile` 。
	`getProperties ()` 返回当前在`IBuildInfo`上设置的属性的副本。
	`getRemoteFiles ()` 获取延迟下载的构建工件的路径。
`String`	`getTestTag ()` 返回正在运行的测试的唯一名称。
`String`	`getVersion ( BuildInfoKey.BuildInfoFileKey key)` 使用给定的`BuildInfoFileKey`检索文件版本的帮助程序方法。
`String`	`getVersion (String name)` 用于检索具有给定名称的文件版本的帮助程序方法。
`VersionedFile`	`getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)` 使用给定的`BuildInfoFileKey`检索`VersionedFile`帮助程序方法。
`final VersionedFile`	`getVersionedFile (String name)` 用于检索具有给定名称的`VersionedFile`帮助程序方法。
	`getVersionedFileKeys ()` 返回可用于通过`getFile(BuildInfoFileKey)`查询`VersionedFile`键集。
`final`	`getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)` 用于检索与给定`BuildInfoFileKey`关联的`VersionedFile`列表的帮助程序方法。
`int`	`hashCode ()`
`void`	`removeBuildAttribute (String attributeName)` 从跟踪中删除给定的 attributeName。
`void`	`setBuildBranch (String branch)` 设置构建分支
`void`	`setBuildFlavor (String buildFlavor)` 设置构建风格。
`void`	`setBuildId (String buildId)` 设置被测版本的唯一标识符。
`void`	`setDeviceSerial (String serial)` 设置与此构建关联的`ITestDevice`序列号。
`void`	`setFile (String name, File file, String version)` 在此构建信息中存储具有给定名称的文件。
`void`	`setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version)` 在此构建信息中存储给定`BuildInfoFileKey`文件。
`void`	`setProperties ( BuildInfoProperties... properties)` 设置`IBuildInfo`实例的`BuildInfoProperties` 。
`void`	`setTestTag (String testTag)` 设置正在运行的测试的唯一名称。
`File`	`stageRemoteFile (String fileName, File workingDir)` 将属于构建信息根目录中远程文件一部分的文件暂存。
`BuildInformation.BuildInfo`	`toProto ()` 将 BuildInfo 实例序列化到 protobuf 中。
`String`	`toString ()`

受保护的方法
`void`	`addAllBuildAttributes ( BuildInfo build)` 从其他构建复制构建属性、分支和风格的辅助方法。
`void`	`addAllFiles ( BuildInfo build)` 从其他版本复制所有文件的帮助程序方法。
`boolean`	`applyBuildProperties ( VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)` 允许应用一些`IBuildInfo.BuildInfoProperties`并可能进行不同的处理。
`MultiMap <String, String>`	`getAttributesMultiMap ()`
	`getVersionedFileMap ()`
`MultiMap <String, VersionedFile >`	`getVersionedFileMapFull ()`

公共构造函数

构建信息

public BuildInfo ()

使用默认属性值创建BuildInfo 。

构建信息

public BuildInfo (String buildId, 
                String buildTargetName)

创建BuildInfo

参数
`buildId`	`String` : 构建 ID
`buildTargetName`	`String` : 构建目标名称

公共方法

添加应用程序包文件

public void addAppPackageFile (File appPackageFile, 
                String version)

添加本地 apk 文件及其关联版本。请注意，apk 将从getAppPackageFiles()返回，按照此方法添加的顺序。

参数
`appPackageFile`	`File`
`version`	`String`

添加构建属性

public void addBuildAttribute (String attributeName, 
                String attributeValue)

添加构建属性。这不允许覆盖现有的 attributeName。

参数
`attributeName`	`String` : 唯一的属性名称
`attributeValue`	`String` : 属性值

添加构建属性

public void addBuildAttributes ( buildAttributes)

添加构建属性

参数
`buildAttributes`	：要添加的属性图

清理

public void cleanUp ()

清理所有临时构建文件

清理

public void cleanUp ( doNotClean)

cleanUp()的版本，其中某些文件不会被删除。

参数
`doNotClean`

克隆

public IBuildInfo clone ()

退货
`IBuildInfo`

复制所有文件自

public final void copyAllFileFrom (BuildInfo build)

将给定版本中的所有VersionedFile复制到此版本。

参数
`build`	`BuildInfo`

等于

public boolean equals (Object obj)

参数
`obj`	`Object`

退货
`boolean`

来自原型

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

toProto()的逆操作以获取实例。

参数
`protoBuild`	`BuildInformation.BuildInfo`

退货
`IBuildInfo`

获取应用程序包文件

public  getAppPackageFiles ()

获取本地应用程序 apk 文件集及其版本的副本。返回的顺序与将 apk 添加到IAppBuildInfo顺序匹配。

退货

获取构建属性

public  getBuildAttributes ()

获取一组描述构建的附加属性的名称/值对。

退货
	构建属性的`ERROR(/Map)` 。不会为`null` ，但可能为空。

获取构建分支

public String getBuildBranch ()

返回生成正在测试的版本的源代码控制分支的可选方法。

退货
`String`	构建分支或`null`如果未设置/不适用

获取BuildFlavor

public String getBuildFlavor ()

返回正在测试的构建类型的可选方法。

Android 平台构建的常见实现是返回（构建产品）-（构建操作系统）-（构建变体）。即通用-linux-userdebug

退货
`String`	构建风格或`null`如果未设置/不适用

获取构建ID

public String getBuildId ()

返回被测版本的唯一标识符。永远不应该为空。默认为UNKNOWN_BUILD_ID 。

退货
`String`

获取构建目标名称

public String getBuildTargetName ()

返回正在测试的构建的完整名称。

常见的实现是根据构建风格和分支名称的组合来构造构建目标名称。 [即（分支名称）-（构建风味）]

退货
`String`

获取设备序列号

public String getDeviceSerial ()

退货
`String`

获取文件

public File getFile (String name)

用于检索具有给定名称的文件的帮助程序方法。

退货
`File`	图像文件，如果未找到则为`null`

获取文件

public File getFile (BuildInfoKey.BuildInfoFileKey key)

使用给定的BuildInfoFileKey检索文件的帮助程序方法。

参数
`key`	`BuildInfoKey.BuildInfoFileKey` ：请求的`BuildInfoFileKey` 。

退货
`File`	图像文件，如果未找到则为`null`

获取文件

public  getFiles ()

返回此BuildInfo中存储的所有VersionedFile 。

退货

获取属性

public  getProperties ()

返回当前在IBuildInfo上设置的属性的副本。

退货

获取远程文件

public  getRemoteFiles ()

获取延迟下载的构建工件的路径。

退货

获取测试标签

public String getTestTag ()

返回正在运行的测试的唯一名称。

退货
`String`

获取版本号

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

使用给定的BuildInfoFileKey检索文件版本的帮助程序方法。

参数
`key`	`BuildInfoKey.BuildInfoFileKey` ：请求的`BuildInfoFileKey` 。

退货
`String`	图像版本或`null`如果未找到

获取版本号

public String getVersion (String name)

用于检索具有给定名称的文件版本的帮助程序方法。

退货
`String`	图像版本或`null`如果未找到

获取版本化文件

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

使用给定的BuildInfoFileKey检索VersionedFile帮助程序方法。

参数
`key`	`BuildInfoKey.BuildInfoFileKey` ：请求的`BuildInfoFileKey` 。

退货
`VersionedFile`	版本控制文件，如果未找到则为`null`

获取版本化文件

public final VersionedFile getVersionedFile (String name)

用于检索具有给定名称的VersionedFile帮助程序方法。

退货
`VersionedFile`	版本控制文件，如果未找到则为`null`

获取版本化文件密钥

public  getVersionedFileKeys ()

返回可用于通过getFile(BuildInfoFileKey)查询VersionedFile键集。

退货

获取版本化文件

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

用于检索与给定BuildInfoFileKey关联的VersionedFile列表的帮助程序方法。如果该键允许存储列表。

参数
`key`	`BuildInfoKey.BuildInfoFileKey` ：请求的`BuildInfoFileKey` 。

退货
	版本控制文件，如果未找到则为`null`

哈希码

public int hashCode ()

退货
`int`

删除构建属性

public void removeBuildAttribute (String attributeName)

从跟踪中删除给定的 attributeName。

参数
`attributeName`	`String` : 停止跟踪的属性

设置构建分支

public void setBuildBranch (String branch)

设置构建分支

参数
`branch`	`String` : 分支名称

设置构建风格

public void setBuildFlavor (String buildFlavor)

设置构建风格。

设置构建ID

public void setBuildId (String buildId)

设置被测版本的唯一标识符。永远不应该为空。

参数
`buildId`	`String`

设置设备序列号

public void setDeviceSerial (String serial)

设置与此构建关联的ITestDevice序列号。

参数
`serial`	`String` ：执行此构建的`ITestDevice`的序列号。

设置文件

public void setFile (String name, 
                File file, 
                String version)

在此构建信息中存储具有给定名称的文件。

参数
`name`	`String` : 文件的唯一名称
`file`	`File` ：本地`ERROR(/File)`
`version`	`String` ：文件版本

设置文件

public void setFile (BuildInfoKey.BuildInfoFileKey key, 
                File file, 
                String version)

在此构建信息中存储给定BuildInfoFileKey文件。

参数
`key`	`BuildInfoKey.BuildInfoFileKey` ：基于`BuildInfoFileKey`文件的唯一名称。
`file`	`File` ：本地`ERROR(/File)`
`version`	`String` ：文件版本

设置属性

public void setProperties (BuildInfoProperties... properties)

设置IBuildInfo实例的BuildInfoProperties 。覆盖之前设置的任何现有属性。

参数
`properties`	`BuildInfoProperties` ：要添加的属性列表。

设置测试标签

public void setTestTag (String testTag)

设置正在运行的测试的唯一名称。

参数
`testTag`	`String`

阶段远程文件

public File stageRemoteFile (String fileName, 
                File workingDir)

将属于构建信息根目录中远程文件一部分的文件暂存。

TODO(b/138416078)：当可以正确构建测试所需的模块并输出到测试模块的目录本身时，删除此接口及其调用者。

参数
`fileName`	`String` ：要位于远程文件中的文件的名称。
`workingDir`	`File` ：用于暂存文件的目录的`ERROR(/File)`对象。

退货
`File`	本地工作目录中暂存的文件的`ERROR(/File)`对象。

原型

public BuildInformation.BuildInfo toProto ()

将 BuildInfo 实例序列化到 protobuf 中。

退货
`BuildInformation.BuildInfo`

到字符串

public String toString ()

退货
`String`

受保护的方法

添加所有构建属性

protected void addAllBuildAttributes (BuildInfo build)

从其他构建复制构建属性、分支和风格的辅助方法。

参数
`build`	`BuildInfo`

添加所有文件

protected void addAllFiles (BuildInfo build)

从其他版本复制所有文件的帮助程序方法。

创建到文件的新硬链接，以便每个构建都将具有该文件的唯一文件路径。

参数
`build`	`BuildInfo`

投掷
	如果创建硬链接时抛出异常。

应用构建属性

protected boolean applyBuildProperties (VersionedFile origFileConsidered, 
                IBuildInfo build, 
                IBuildInfo receiver)

允许应用一些IBuildInfo.BuildInfoProperties并可能进行不同的处理。

参数
`origFileConsidered`	`VersionedFile` ：当前查看的`VersionedFile` 。
`build`	`IBuildInfo` ：正在克隆的原始构建
`receiver`	`IBuildInfo` ：接收信息的构建。

退货
`boolean`	如果我们应用了这些属性，则为 true，并且应跳过进一步的处理。否则为假。

获取属性多重映射

protected MultiMap<String, String> getAttributesMultiMap ()

退货
`MultiMap <String, String>`

获取版本化文件映射

protected  getVersionedFileMap ()

退货

获取版本化文件映射完整

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

退货
`MultiMap <String, VersionedFile >`