Загрузить протоколы с глобальной конфигурацией

Чтобы понять этот раздел, сначала изучите Tradefed @Option .

Типичные опции в Tradefed позволяют тестовым классам получать дополнительную информацию из конфигурации XML или командной строки. Эта функция позволяет вам сделать еще один шаг и при необходимости разрешить некоторую дополнительную информацию.

Пример варианта файла

Пример файла @option:

@Option(name = 'config-file')
private File mConfigFile;

Вышеупомянутое можно установить с помощью конфигурации XML:

<option name="config-file" value="/tmp/file" />

или через команду: 

--config-file /tmp/file

Описание

Эта функция позволяет преобразовать удаленные @Options файлового типа в локальный файл, чтобы они были беспрепятственно доступны с точки зрения пользователя.

Чтобы это работало, файлу необходимо указать путь к удаленному стилю . Например:

--config-file gs://bucket/tmp/file

Этот путь указывает на файл в сегменте Google Cloud Storage (GCS), где он хранится. Tradefed, увидев этот удаленный путь, попытается загрузить файл локально и назначить его @Option. В результате переменная mConfigFile теперь указывает на локальную версию файла, который может использоваться тестом.

Если удаленный файл не может быть загружен по какой-либо причине, Tradefed выдаст исключение ConfigurationException , которое предотвратит запуск теста. Мы считаем отсутствие этих файлов критической ошибкой, поскольку некоторые тестовые артефакты также будут отсутствовать.

Использовать параметры запроса

Добавление параметров запроса в URL-адрес возможно с помощью ? . Например, gs://bucket/path?unzip=true . Ключ/значение unzip=true будет доступно в реализации интерфейса IRemoteFileResolver .

Доступны два встроенных поведения:

  • unzip: если установлено значение true и загруженный файл представляет собой zip-архив, он будет автоматически разархивирован во временное расположение. Пример: ?unzip=true
  • необязательно: по умолчанию — false . Если установлено значение true и разрешение не удалось, оно не выдаст исключение и просто не заменит файл. Пример: ?optional=true

Вы также можете передать аргументы глобального запроса через --dynamic-download-args key=value , который будет передавать ключ/значение всем динамическим загрузкам, предпринятым при вызове.

Поддерживаемые протоколы

Официально поддерживаемые протоколы и соответствующие им форматы:

  • Google Cloud Storage, протокол: gs , формат: gs://<bucket name>/path
  • Локальные файлы, протокол: file , формат: file:/local/path
  • http-ссылки, протокол: http , формат: http://url
  • https ссылки, протокол: https , формат: https://url

Ограничения

Динамическое разрешение @Option в настоящее время поддерживает только ограниченное количество протоколов и мест для загрузки. Разрешение @Option в настоящее время включено только для основной конфигурации XML Tradefed.

При работе в виде пакета текущие модули ( AndroidTest.xml ) не будут разрешать файлы по умолчанию. Это сделано для того, чтобы модули не создавали неизвестных зависимостей . Этого можно избежать, используя --enable-module-dynamic-download на уровне пакета, но основные пакеты, такие как Compatibility Test Suite (CTS) и Vendor Test Suite (VTS), не включат его.

Внедрить новый протокол

Поддерживаемые протоколы имеют реализацию в Tradefed интерфейса IRemoteFileResolver , который определяет короткий тег протокола, который будет сопоставляться в пути к файлу через getSupportedProtocol . Например, gs используется для протокола Google Cloud Storage. Рекомендуемый интерфейс для реализации — #resolveRemoteFiles(RemoteFileResolverArgs) который будет поддерживаться в течение длительного времени.

Реализованные протоколы можно добавить в файл служб META-INF, чтобы официально включить поддержку.