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)

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

default void allowStagingRemoteFile (boolean stageRemoteFile)

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

abstract void cleanUp ()

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

abstract void cleanUp ( doNotDelete) cleanUp ( doNotDelete)

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

abstract IBuildInfo clone ()

Клонирует объект IBuildInfo .

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)

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

abstract getFiles ()

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

abstract getProperties ()

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

default getRemoteFiles ()

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

abstract String getTestTag ()

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

default String getVersion ( BuildInfoKey.BuildInfoFileKey key)

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

abstract String getVersion (String name)

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

default VersionedFile getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)

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

default VersionedFile getVersionedFile (String name)

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

default getVersionedFileKeys ()

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

default getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

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

default void removeBuildAttribute (String attributeName)

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

abstract void setBuildBranch (String branch)

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

abstract void setBuildFlavor (String buildFlavor)

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

abstract void setBuildId (String buildId)

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

abstract void setDeviceSerial (String serial)

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

abstract void setFile (String name, File file, String version)

Сохраняет файл с заданным именем в этой информации о сборке.

default void setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version)

Сохраняет файл с указанием BuildInfoFileKey в этой информации о сборке.

abstract void setProperties ( BuildInfoProperties... properties)

Задайте BuildInfoProperties для экземпляра IBuildInfo .

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

Параметры
appPackageFile File

version String

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

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

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

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

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

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

public void addBuildAttributes ( buildAttributes)

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

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

AllowStagingRemoteFile 

public void allowStagingRemoteFile (boolean stageRemoteFile)

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

Параметры
stageRemoteFile boolean

очистка 

public abstract void cleanUp ()

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

очистка 

public abstract void cleanUp ( doNotDelete)

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

Параметры
doNotDelete

клонировать 

public abstract IBuildInfo clone ()

Клонирует объект IBuildInfo .

Возврат
IBuildInfo

getAppPackageFiles 

public  getAppPackageFiles ()

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

Возврат

getBuildAttributes 

public abstract  getBuildAttributes ()

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

Возврат
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 abstract  getFiles ()

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

Возврат

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

public abstract  getProperties ()

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

Возврат

getRemoteFiles 

public  getRemoteFiles ()

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

Возврат

getTestTag 

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 

public  getVersionedFileKeys ()

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

Возврат

getVersionedFiles 

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

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

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

удалитьBuildAttribute 

public void removeBuildAttribute (String attributeName)

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

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

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