Информация о сборке

public class BuildInfo
extends Object implements IBuildInfo

java.lang.Объект
↳	com.android.tradefed.build.BuildInfo

Известные прямые подклассы AppBuildInfo , DeviceBuildInfo , FolderBuildInfo , OtatoolsBuildInfo AppBuildInfo Объект IBuildInfo , представляющий приложение Android и его тестовые пакеты. информация о устройстве Объект IBuildInfo , представляющий полную сборку устройства Android и (необязательно) его тесты. FolderBuildInfo Конкретная реализация IFolderBuildInfo . OtatoolsBuildInfo Объект IBuildInfo , содержащий артефакты otatools.

Известные косвенные подклассы AppDeviceBuildInfo , ClusterBuildInfo , DeviceFolderBuildInfo , OtaDeviceBuildInfo AppDeviceBuildInfo Этот класс устарел. Используйте IDeviceBuildInfo напрямую. ClusterBuildInfo Класс IBuildInfo для сборок, переданных из TFC. DeviceFolderBuildInfo IDeviceBuildInfo , который также содержит другие артефакты сборки, содержащиеся в каталоге локальной файловой системы. OtaDeviceBuildInfo IDeviceBuildInfo , используемый для беспроводного тестирования обновлений.

---

Общая реализация IBuildInfo , которая должна быть связана с ITestDevice .

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

Публичные конструкторы
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 () Возвращает все VersionedFile , хранящиеся в этом BuildInfo .
	getProperties () Возвращает копию свойств, установленных в данный момент в IBuildInfo .
	getRemoteFiles () Получите пути для артефактов сборки, загрузка которых отложена.
String	getTestTag () Возвращает уникальное имя для выполняемых тестов.
String	getVersion ( BuildInfoKey.BuildInfoFileKey key) Вспомогательный метод для получения версии файла с заданным BuildInfoFileKey .
String	getVersion (String name) Вспомогательный метод для получения версии файла с заданным именем.
VersionedFile	getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Вспомогательный метод для получения VersionedFile с заданным BuildInfoFileKey .
final VersionedFile	getVersionedFile (String name) Вспомогательный метод для получения VersionedFile с заданным именем.
	getVersionedFileKeys () Возвращает набор ключей, доступных для запроса VersionedFile через getFile(BuildInfoFileKey) .
final	getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Вспомогательный метод для получения списка VersionedFile , связанных с данным BuildInfoFileKey .
int	hashCode ()
void	removeBuildAttribute (String 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) Задайте BuildInfoProperties для экземпляра IBuildInfo .
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 : идентификатор сборки
buildTargetName	String : имя цели сборки

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

добавитьAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

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

Параметры
appPackageFile	File
version	String

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

public void addBuildAttribute (String attributeName, 
                String attributeValue)

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

Параметры
attributeName	String : уникальное имя атрибута
attributeValue	String : значение атрибута

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

public void addBuildAttributes ( buildAttributes)

Добавить атрибуты сборки

Параметры
buildAttributes	: Карта атрибутов, которые будут добавлены

очистка

public void cleanUp ()

Очистите все временные файлы сборки

очистка

public void cleanUp ( doNotClean)

Версия cleanUp() , в которой некоторые файлы не удаляются.

Параметры
doNotClean

клон

public IBuildInfo clone ()

Возвращает
IBuildInfo

копироватьAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Скопируйте все файлы VersionedFile из данной сборки в эту.

Параметры
build	BuildInfo

равно

public boolean equals (Object obj)

Параметры
obj	Object

Возвращает
boolean

отProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Обратная операция toProto() для возврата экземпляра.

Параметры
protoBuild	BuildInformation.BuildInfo

Возвращает
IBuildInfo

получитьAppPackageFiles

public  getAppPackageFiles ()

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

Возвращает

getBuildAttributes

public  getBuildAttributes ()

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

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

getBuildBranch

public String getBuildBranch ()

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

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

getBuildFlavor

public String getBuildFlavor ()

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

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

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

getBuildId

public String getBuildId ()

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

Возвращает
String

getBuildTargetName

public String getBuildTargetName ()

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

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

Возвращает
String

getDeviceSerial

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

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

Возвращает

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

public  getProperties ()

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

Возвращает

getRemoteFiles

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

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

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

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

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

getVersionedFile

public final VersionedFile getVersionedFile (String name)

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

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

getVersionedFileKeys

public  getVersionedFileKeys ()

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

Возвращает

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

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

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

хэш-код

public int hashCode ()

Возвращает
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

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

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

setBuildBranch

public void setBuildBranch (String branch)

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

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

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

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

setBuildId

public void setBuildId (String buildId)

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

Параметры
buildId	String

setDeviceSerial

public void setDeviceSerial (String serial)

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

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

setFile

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

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

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

setTestTag

public 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

нанизывать

public String toString ()

Возвращает
String

Защищенные методы

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

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

Параметры
build	BuildInfo

добавитьвсе файлы

protected void addAllFiles (BuildInfo build)

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

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

Параметры
build	BuildInfo

Броски
	если при создании жесткой ссылки возникает исключение.

применитьBuildProperties

protected boolean applyBuildProperties (VersionedFile origFileConsidered, 
                IBuildInfo build, 
                IBuildInfo receiver)

Разрешить применять некоторые IBuildInfo.BuildInfoProperties и, возможно, выполнить другую обработку.

Параметры
origFileConsidered	VersionedFile : просматриваемый в данный момент VersionedFile .
build	IBuildInfo : клонируется исходная сборка.
receiver	IBuildInfo : сборка, получающая информацию.

Возвращает
boolean	Истинно, если мы применили свойства и дальнейшую обработку следует пропустить. Ложь в противном случае.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Возвращает
MultiMap <String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

Возвращает

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Возвращает
MultiMap <String, VersionedFile >