构建信息

public class BuildInfo
extends Object implements IBuildInfo

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


应与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 >