构建信息

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo


保存有关被测版本的信息。

概括

常数

String REMOTE_FILE_PREFIX

名称中使用的前缀表示该文件被设置为延迟下载。

String REMOTE_FILE_VERSION

远程文件没有版本控制。

String UNKNOWN_BUILD_ID

构建 ID 未知时的默认值。

公共方法

default void addAppPackageFile (File appPackageFile, String version)

添加本地 apk 文件及其关联版本。

abstract void addBuildAttribute (String attributeName, String attributeValue)

添加构建属性。

default void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

添加构建属性

abstract void cleanUp ()

清理所有临时构建文件

abstract void cleanUp ( doNotDelete) cleanUp ( doNotDelete)

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

abstract IBuildInfo clone ()

克隆IBuildInfo对象。

default getAppPackageFiles ()

获取本地应用程序 apk 文件集及其版本的副本。

abstract getBuildAttributes ()

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

abstract String getBuildBranch ()

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

abstract String getBuildFlavor ()

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

abstract String getBuildId ()

返回被测版本的唯一标识符。

abstract String getBuildTargetName ()

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

abstract String getDeviceSerial ()
abstract File getFile (String name)

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

default File getFile ( BuildInfoKey.BuildInfoFileKey key)

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

abstract getFiles ()

返回此BuildInfo中存储的所有VersionedFile

abstract getProperties ()

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

default getRemoteFiles ()

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

abstract String getTestTag ()

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

default String getVersion ( BuildInfoKey.BuildInfoFileKey key)

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

abstract String getVersion (String name)

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

default VersionedFile getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)

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

default VersionedFile getVersionedFile (String name)

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

default getVersionedFileKeys ()

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

default getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

用于检索与给定BuildInfoFileKey关联的VersionedFile列表的帮助程序方法。

default void removeBuildAttribute (String attributeName)

从跟踪中删除给定的 attributeName。

abstract void setBuildBranch (String branch)

设置构建分支

abstract void setBuildFlavor (String buildFlavor)

设置构建风格。

abstract void setBuildId (String buildId)

设置被测版本的唯一标识符。

abstract void setDeviceSerial (String serial)

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

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

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

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

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

abstract void setProperties ( BuildInfoProperties... properties)

设置IBuildInfo实例的BuildInfoProperties

abstract void setTestTag (String testTag)

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

default File stageRemoteFile (String fileName, File workingDir)

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

default BuildInformation.BuildInfo toProto ()

将 BuildInfo 实例序列化到 protobuf 中。

常数

远程文件前缀

public static final String REMOTE_FILE_PREFIX

名称中使用的前缀表示该文件被设置为延迟下载。

常量值:“remote_file:”

远程文件版本

public static final String REMOTE_FILE_VERSION

远程文件没有版本控制。

常数值:“”

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

构建 ID 未知时的默认值。

常数值:“-1”

公共方法

添加应用程序包文件

public void addAppPackageFile (File appPackageFile, 
                String version)

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

参数
appPackageFile File

version String

添加构建属性

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

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

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

attributeValue String : 属性值

添加构建属性

public void addBuildAttributes ( buildAttributes)

添加构建属性

参数
buildAttributes :要添加的属性图

清理

public abstract void cleanUp ()

清理所有临时构建文件

清理

public abstract void cleanUp ( doNotDelete)

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

参数
doNotDelete

克隆

public abstract IBuildInfo clone ()

克隆IBuildInfo对象。

退货
IBuildInfo

获取应用程序包文件

public  getAppPackageFiles ()

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

退货

获取构建属性

public abstract  getBuildAttributes ()

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

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

获取构建分支

public abstract String getBuildBranch ()

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

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

获取BuildFlavor

public abstract String getBuildFlavor ()

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

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

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

获取构建ID

public abstract String getBuildId ()

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

退货
String

获取构建目标名称

public abstract String getBuildTargetName ()

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

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

退货
String

获取设备序列号

public abstract String getDeviceSerial ()

退货
String执行此构建的ITestDevice序列号。如果没有设备与此版本关联,则返回null

获取文件

public abstract File getFile (String name)

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

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

获取文件

public File getFile (BuildInfoKey.BuildInfoFileKey key)

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

参数
key BuildInfoKey.BuildInfoFileKey :请求的BuildInfoFileKey

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

获取文件

public abstract  getFiles ()

返回此BuildInfo中存储的所有VersionedFile

退货

获取属性

public abstract  getProperties ()

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

退货

获取远程文件

public  getRemoteFiles ()

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

退货

获取测试标签

public abstract String getTestTag ()

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

退货
String

获取版本号

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

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

参数
key BuildInfoKey.BuildInfoFileKey :请求的BuildInfoFileKey

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

获取版本号

public abstract String getVersion (String name)

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

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

获取版本化文件

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

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

参数
key BuildInfoKey.BuildInfoFileKey :请求的BuildInfoFileKey

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

获取版本化文件

public VersionedFile getVersionedFile (String name)

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

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

获取版本化文件密钥

public  getVersionedFileKeys ()

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

退货

获取版本化文件

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

参数
key BuildInfoKey.BuildInfoFileKey :请求的BuildInfoFileKey

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

删除构建属性

public void removeBuildAttribute (String attributeName)

从跟踪中删除给定的 attributeName。

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

设置构建分支

public abstract void setBuildBranch (String branch)

设置构建分支

参数
branch String : 分支名称

设置构建风格

public abstract void setBuildFlavor (String buildFlavor)

设置构建风格。

设置构建ID

public abstract void setBuildId (String buildId)

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

参数
buildId String

设置设备序列号

public abstract void setDeviceSerial (String serial)

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

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

设置文件

public abstract 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 abstract void setProperties (BuildInfoProperties... properties)

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

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

设置测试标签

public abstract 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