IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo


Содержит информацию о тестируемой сборке.

Краткое содержание

Константы

String REMOTE_FILE_PREFIX

Префикс, используемый в имени для указания того, что для файла установлена ​​отложенная загрузка.

String REMOTE_FILE_VERSION

Удаленный файл не имеет версии.

String UNKNOWN_BUILD_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 ()

Возвращает все VersionedFile , хранящиеся в этом BuildInfo .

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)

Вспомогательный метод для получения VersionedFile с заданным BuildInfoFileKey .

default VersionedFile getVersionedFile (String name)

Вспомогательный метод для получения VersionedFile с заданным именем.

default getVersionedFileKeys ()

Возвращает набор ключей, доступных для запроса VersionedFile через getFile(BuildInfoFileKey) .

default getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

Вспомогательный метод для получения списка VersionedFile , связанных с данным BuildInfoFileKey .

default void removeBuildAttribute (String 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)

Задайте BuildInfoProperties для экземпляра IBuildInfo .

abstract void setTestTag (String testTag)

Задает уникальное имя для выполняемых тестов.

default File stageRemoteFile (String fileName, File workingDir)

Поместите файл, который является частью удаленных файлов, в корневом каталоге информации о сборке.

default BuildInformation.BuildInfo toProto ()

Сериализуйте экземпляр BuildInfo в protobuf.

Константы

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

Префикс, используемый в имени для указания того, что для файла установлена ​​отложенная загрузка.

Постоянное значение: "remote_file:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

Удаленный файл не имеет версии.

Постоянное значение: ""

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

Значение по умолчанию, когда идентификатор сборки неизвестен.

Постоянное значение: "-1"

Публичные методы

добавитьAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Добавляет локальный файл apk и связанную с ним версию. Обратите внимание, что apks будут возвращены из getAppPackageFiles() в том порядке, в котором они были добавлены этим методом.

Параметры
appPackageFile File

version String

аддбилдаттрибуте

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

Добавьте атрибут сборки. Это не позволяет переопределить существующее имя атрибута.

Параметры
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

получитьAppPackageFiles

public  getAppPackageFiles ()

Получает копию набора файлов APK локального приложения и их версий. Возвращаемый порядок соответствует порядку, в котором APK были добавлены в IAppBuildInfo .

Возвращает

getBuildAttributes

public abstract  getBuildAttributes ()

Получите набор пар "имя-значение" дополнительных атрибутов, описывающих сборку.

Возвращает
ERROR(/Map) атрибутов сборки. Не будет null , но может быть пустым.

getBuildBranch

public abstract String getBuildBranch ()

Необязательный метод для возврата ветки системы управления версиями, из которой была создана тестируемая сборка.

Возвращает
String ветвь сборки или null , если не установлено/не применимо

getBuildFlavor

public abstract String getBuildFlavor ()

Необязательный метод для возврата типа тестируемой сборки.

Обычная реализация для сборок платформы Android заключается в возврате (сборка продукта)-(сборка ОС)-(сборка варианта). т.е. общий-linux-userdebug

Возвращает
String вариант сборки или null , если он не установлен/не применим

getBuildId

public abstract String getBuildId ()

Возвращает уникальный идентификатор тестируемой сборки. Никогда не должен быть нулевым. По умолчанию UNKNOWN_BUILD_ID .

Возвращает
String

getBuildTargetName

public abstract String getBuildTargetName ()

Возвращает полное имя тестируемой сборки.

Распространенной реализацией является создание имени цели сборки из комбинации разновидности сборки и имени ветки. [т.е. (название ветки) - (создать вкус)]

Возвращает
String

getDeviceSerial

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 ()

Возвращает все VersionedFile , хранящиеся в этом BuildInfo .

Возвращает

получить свойства

public abstract  getProperties ()

Возвращает копию свойств, установленных в данный момент в IBuildInfo .

Возвращает

getRemoteFiles

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 , если не найдено

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Вспомогательный метод для получения VersionedFile с заданным BuildInfoFileKey .

Параметры
key BuildInfoKey.BuildInfoFileKey : запрошенный BuildInfoFileKey .

Возвращает
VersionedFile Версионный файл или null , если он не найден

getVersionedFile

public VersionedFile getVersionedFile (String name)

Вспомогательный метод для получения VersionedFile с заданным именем.

Возвращает
VersionedFile Версионный файл или null , если он не найден

getVersionedFileKeys

public  getVersionedFileKeys ()

Возвращает набор ключей, доступных для запроса VersionedFile через getFile(BuildInfoFileKey) .

Возвращает

getVersionedFiles

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Вспомогательный метод для получения списка VersionedFile , связанных с данным BuildInfoFileKey . Если ключ позволяет хранить список.

Параметры
key BuildInfoKey.BuildInfoFileKey : запрошенный BuildInfoFileKey .

Возвращает
Версионный файл или null , если он не найден

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Удалить заданное имя атрибута из отслеживания.

Параметры
attributeName String : атрибут для прекращения отслеживания

setBuildBranch

public abstract void setBuildBranch (String branch)

Установите ветку сборки

Параметры
branch String : имя ветки

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Установите вкус сборки.

setBuildId

public abstract void setBuildId (String buildId)

Устанавливает уникальный идентификатор тестируемой сборки. Никогда не должен быть нулевым.

Параметры
buildId String

setDeviceSerial

public abstract void setDeviceSerial (String serial)

Установите серийный номер ITestDevice , связанный с этой сборкой.

Параметры
serial String : серийный номер ITestDevice , с которым была выполнена эта сборка.

setFile

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

Сохраняет файл с заданным именем в этой информации о сборке.

Параметры
name String : уникальное имя файла.

file File : локальная ERROR(/File)

version String : версия файла

setFile

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)

Задайте BuildInfoProperties для экземпляра IBuildInfo . Переопределите любые существующие свойства, установленные ранее.

Параметры
properties BuildInfoProperties : список свойств для добавления.

setTestTag

public abstract void setTestTag (String testTag)

Задает уникальное имя для выполняемых тестов.

Параметры
testTag String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Поместите файл, который является частью удаленных файлов, в корневом каталоге информации о сборке.

TODO(b/138416078): Удалите этот интерфейс и его вызывающую программу, если модули, необходимые для теста, могут быть правильно построены и выводятся в каталог самого тестового модуля.

Параметры
fileName String : имя файла, который должен быть расположен в удаленных файлах.

workingDir File : объект ERROR(/File) каталога для размещения файла.

Возвращает
File объект ERROR(/File) файла, размещенного в локальном рабочем каталоге.

toProto

public BuildInformation.BuildInfo toProto ()

Сериализуйте экземпляр BuildInfo в protobuf.

Возвращает
BuildInformation.BuildInfo