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

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 allowStagingRemoteFile (boolean stageRemoteFile)

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

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)

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

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

Параметры
appPackageFile File

version String

добавитьбилдаттрибуте

public void addBuildAttribute (String attributeName, 
                String attributeValue)

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

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

attributeValue String : значение атрибута.

добавитьбилдаттрибутес

public void addBuildAttributes ( buildAttributes)

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

Параметры
buildAttributes : Карта добавляемых атрибутов.

AllowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

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

Параметры
stageRemoteFile boolean

очистка

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

изПрото

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

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

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

Возврат
IBuildInfo

getAppPackageFiles

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

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

Возврат

getTestTag

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

удалитьBuildAttribute

public void removeBuildAttribute (String attributeName)

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

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

этап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

toString

public String toString ()

Возврат
String

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

добавитьAllBuildAttributes

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 >