Информация о сборке
public class BuildInfo
extends Object
implements IBuildInfo
java.lang.Объект | |
↳ | com.android.tradefed.build.BuildInfo |
Общая реализация IBuildInfo
, которая должна быть связана с ITestDevice
.
Краткое содержание
Общественные конструкторы | |
---|---|
BuildInfo () Создает | |
BuildInfo (String buildId, String buildTargetName) Создает |
Публичные методы | |
---|---|
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) Версия |
IBuildInfo | clone () |
final void | copyAllFileFrom ( BuildInfo build) Скопируйте все |
boolean | equals (Object obj) |
static IBuildInfo | fromProto (BuildInformation.BuildInfo protoBuild) Обратная операция |
getAppPackageFiles () Получает копию набора apk-файлов локального приложения и их версий. | |
getBuildAttributes () Получите набор пар имя-значение дополнительных атрибутов, описывающих сборку. | |
String | getBuildBranch () Необязательный метод для возврата ветки системы управления версиями, из которой была создана тестируемая сборка. |
String | getBuildFlavor () Необязательный метод для возврата типа тестируемой сборки. |
String | getBuildId () Возвращает уникальный идентификатор тестируемой сборки. |
String | getBuildTargetName () Возвращает полное имя тестируемой сборки. |
String | getDeviceSerial () |
File | getFile (String name) Вспомогательный метод для получения файла с заданным именем. |
File | getFile ( BuildInfoKey.BuildInfoFileKey key) Вспомогательный метод для получения файла с заданным |
getFiles () Возвращает все | |
getProperties () Возвращает копию свойств, установленных в данный момент в | |
getRemoteFiles () Получите пути к артефактам сборки, загрузка которых задерживается. | |
String | getTestTag () Возвращает уникальное имя для запускаемых тестов. |
String | getVersion ( BuildInfoKey.BuildInfoFileKey key) Вспомогательный метод для получения версии файла с заданным |
String | getVersion (String name) Вспомогательный метод для получения версии файла с заданным именем. |
VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Вспомогательный метод для получения |
final VersionedFile | getVersionedFile (String name) Вспомогательный метод для получения |
getVersionedFileKeys () Возвращает набор ключей, доступных для запроса | |
final | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Вспомогательный метод для получения списка |
int | hashCode () |
void | removeBuildAttribute (String attributeName) Удалить указанный атрибутName из отслеживания. |
void | setBuildBranch (String branch) Установить ветку сборки |
void | setBuildFlavor (String buildFlavor) Установите вкус сборки. |
void | setBuildId (String buildId) Устанавливает уникальный идентификатор тестируемой сборки. |
void | setDeviceSerial (String serial) Установите серийный номер |
void | setFile (String name, File file, String version) Сохраняет файл с заданным именем в этой информации о сборке. |
void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Сохраняет файл с указанием |
void | setProperties ( BuildInfoProperties... properties) Задайте |
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) Разрешить применять некоторые |
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 |
копировать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
publicgetAppPackageFiles ()
Получает копию набора apk-файлов локального приложения и их версий. Возвращаемый порядок соответствует порядку, в котором APK-файлы были добавлены в IAppBuildInfo
.
Возврат | |
---|---|
getBuildAttributes
publicgetBuildAttributes ()
Получите набор пар имя-значение дополнительных атрибутов, описывающих сборку.
Возврат | |
---|---|
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 , если не найден |
получить файлы
publicgetFiles ()
Возвращает все VersionedFile
, хранящиеся в этом BuildInfo
.
Возврат | |
---|---|
получить свойства
publicgetProperties ()
Возвращает копию свойств, установленных в данный момент в IBuildInfo
.
Возврат | |
---|---|
getRemoteFiles
publicgetRemoteFiles ()
Получите пути к артефактам сборки, загрузка которых задерживается.
Возврат | |
---|---|
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
publicgetVersionedFileKeys ()
Возвращает набор ключей, доступных для запроса VersionedFile
через getFile(BuildInfoFileKey)
.
Возврат | |
---|---|
getVersionedFiles
public finalgetVersionedFiles (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
protectedgetVersionedFileMap ()
Возврат | |
---|---|
getVersionedFileMapFull
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
Возврат | |
---|---|
MultiMap <String, VersionedFile > |