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)

Удалить указанный атрибутName из отслеживания.

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 и связанную с ним версию. Обратите внимание, что APK-файлы будут возвращены из 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

getAppPackageFiles

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

Получите пути для артефактов сборки, загрузка которых задерживается.

Возврат

getTestTag

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

удалитьBuildAttribute

public void removeBuildAttribute (String attributeName)

Удалить указанный атрибутName из отслеживания.

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

этапRemoteFile

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