IBuildInfo
public interface IBuildInfo
com.android.tradefed.build.IBuildInfo |
Содержит информацию о тестируемой сборке.
Краткое содержание
Константы | |
---|---|
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) Добавить атрибуты сборки |
abstract void | cleanUp () Очистите все временные файлы сборки |
abstract void | cleanUp ( doNotDelete) cleanUp ( doNotDelete) Версия |
abstract IBuildInfo | clone () Клонирует объект |
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) Вспомогательный метод для извлечения файла с заданным |
abstract | getFiles () Возвращает все |
abstract | getProperties () Возвращает копию свойств, установленных в данный момент в |
default | getRemoteFiles () Получите пути для артефактов сборки, загрузка которых отложена. |
abstract String | getTestTag () Возвращает уникальное имя для выполняемых тестов. |
default String | getVersion ( BuildInfoKey.BuildInfoFileKey key) Вспомогательный метод для получения версии файла с заданным |
abstract String | getVersion (String name) Вспомогательный метод для получения версии файла с заданным именем. |
default VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Вспомогательный метод для получения |
default VersionedFile | getVersionedFile (String name) Вспомогательный метод для получения |
default | getVersionedFileKeys () Возвращает набор ключей, доступных для запроса |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Вспомогательный метод для получения списка |
default void | removeBuildAttribute (String attributeName) Удалить заданное имя атрибута из отслеживания. |
abstract void | setBuildBranch (String branch) Установите ветку сборки |
abstract void | setBuildFlavor (String buildFlavor) Установите вкус сборки. |
abstract void | setBuildId (String buildId) Устанавливает уникальный идентификатор тестируемой сборки. |
abstract void | setDeviceSerial (String serial) Установите серийный номер |
abstract void | setFile (String name, File file, String version) Сохраняет файл с заданным именем в этой информации о сборке. |
default void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Сохраняет файл с |
abstract void | setProperties ( BuildInfoProperties... properties) Задайте |
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 и связанную с ним версию. Обратите внимание, что apks будут возвращены из getAppPackageFiles()
в том порядке, в котором они были добавлены этим методом.
Параметры | |
---|---|
appPackageFile | File |
version | String |
аддбилдаттрибуте
public abstract void addBuildAttribute (String attributeName, String attributeValue)
Добавьте атрибут сборки. Это не позволяет переопределить существующее имя атрибута.
Параметры | |
---|---|
attributeName | String : уникальное имя атрибута |
attributeValue | String : значение атрибута |
аддбилдаттрибутес
public void addBuildAttributes (buildAttributes)
Добавить атрибуты сборки
Параметры | |
---|---|
buildAttributes |
очистка
public abstract void cleanUp ()
Очистите все временные файлы сборки
очистка
public abstract void cleanUp (doNotDelete)
Версия cleanUp()
, в которой некоторые файлы не удаляются.
Параметры | |
---|---|
doNotDelete |
получитьAppPackageFiles
publicgetAppPackageFiles ()
Получает копию набора файлов APK локального приложения и их версий. Возвращаемый порядок соответствует порядку, в котором APK были добавлены в IAppBuildInfo
.
Возвращает | |
---|---|
getBuildAttributes
public abstractgetBuildAttributes ()
Получите набор пар "имя-значение" дополнительных атрибутов, описывающих сборку.
Возвращает | |
---|---|
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 abstractgetFiles ()
Возвращает все VersionedFile
, хранящиеся в этом BuildInfo
.
Возвращает | |
---|---|
получить свойства
public abstractgetProperties ()
Возвращает копию свойств, установленных в данный момент в IBuildInfo
.
Возвращает | |
---|---|
getRemoteFiles
publicgetRemoteFiles ()
Получите пути для артефактов сборки, загрузка которых отложена.
Возвращает | |
---|---|
получитьтесттег
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
publicgetVersionedFileKeys ()
Возвращает набор ключей, доступных для запроса VersionedFile
через getFile(BuildInfoFileKey)
.
Возвращает | |
---|---|
getVersionedFiles
publicgetVersionedFiles (BuildInfoKey.BuildInfoFileKey key)
Вспомогательный метод для получения списка VersionedFile
, связанных с данным BuildInfoFileKey
. Если ключ позволяет хранить список.
Параметры | |
---|---|
key | BuildInfoKey.BuildInfoFileKey : запрошенный BuildInfoFileKey . |
Возвращает | |
---|---|
Версионный файл или null , если он не найден |
removeBuildAttribute
public void removeBuildAttribute (String attributeName)
Удалить заданное имя атрибута из отслеживания.
Параметры | |
---|---|
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 |
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 |