IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

Известные косвенные подклассы AppBuildInfo , AppDeviceBuildInfo , BuildInfo , ClusterBuildInfo , DeviceBuildInfo , DeviceFolderBuildInfo , FolderBuildInfo , IAppBuildInfo , IDeviceBuildInfo , IFolderBuildInfo , OtaDeviceBuildInfo , OtatoolsBuildInfo AppBuildInfo IBuildInfo , представляющий приложение Android и его тестовые пакеты. AppDeviceBuildInfo Этот класс устарел. Используйте IDeviceBuildInfo напрямую. Информация о сборке Общая реализация IBuildInfo , которая должна быть связана с ITestDevice . Информация о кластереBuildInfo Класс IBuildInfo для сборок, передаваемых по конвейеру из TFC. Информация о сборке устройства IBuildInfo , представляющий полную сборку устройства Android и (необязательно) ее тесты. Девицефолдербилдинформо IDeviceBuildInfo , который также содержит другие артефакты сборки, находящиеся в каталоге локальной файловой системы. ПапкаBuildInfo Конкретная реализация IFolderBuildInfo . IAppBuildInfo Этот интерфейс устарел. Используйте IBuildInfo напрямую. IDeviceBuildInfo IBuildInfo , представляющий полную сборку устройства Android и (необязательно) ее тесты. IFolderBuildInfo Простой абстрактный IBuildInfo артефакты сборки которого содержатся в каталоге локальной файловой системы. OtaDeviceBuildInfo IDeviceBuildInfo используемый для беспроводного тестирования обновлений. OtatoolsBuildInfo IBuildInfo , содержащий артефакты otatools.

---

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

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

Константы
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) Добавить атрибуты сборки
default void	allowStagingRemoteFile (boolean stageRemoteFile) Устанавливает разрешение, позволяющее размещать удаленные файлы.
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	: Карта добавляемых атрибутов.

AllowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Устанавливает разрешение, позволяющее размещать удаленные файлы.

Параметры
stageRemoteFile	boolean

очистка

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