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

public class BuildInfo
extends Object implements IBuildInfo

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


Общая реализация 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 >