IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher


Прошивка устройства путем загрузки образа операционной системы.

Краткое содержание

Общедоступные методы

default boolean checkAntiRollback ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Проверьте, сработала ли защита от отката.

abstract void flash ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Прошивка устанавливается на устройство.

default Set<String> getAdditionalFileFilters ()

Получить фильтры для дополнительных артефактов сборки.

abstract CommandStatus getSystemFlashingStatus ()

Получите информацию о состоянии выполнения команды для прошивки основных системных разделов.

abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Определяет, следует ли записывать, удалять или сохранять образ пользовательских данных.

abstract void overrideDeviceOptions ( ITestDevice device)

Переопределить параметры устройства.

default void postFlashOperations ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Все операции по очистке и проверки, которые должны быть проведены после фактического включения критически важного участка.

default void preFlashOperations ( ITestDevice device, IDeviceBuildInfo deviceBuild)

Все операции настройки и проверки, которые должны быть выполнены перед фактической прошивкой критического раздела.

abstract void setDataWipeSkipList (Collection<String> dataWipeSkipList)

Задает список путей в каталоге /data , чтобы избежать очистки при использовании ITestsZipInstaller

Обратите внимание, что список пропуска содержит только дочерние элементы /data .

default void setExtraMetadata (Map<String, String> metadata)

Позволяет программе для прошивки получать дополнительные параметры метаданных.

abstract void setFlashingResourcesRetriever ( IFlashingResourcesRetriever retriever)

Задает механизм, с помощью которого программа для прошивки может получать файлы ресурсов для прошивки.

abstract void setForceSystemFlash (boolean forceSystemFlash)

Определяет, следует ли всегда прошивать систему, даже если используется текущая сборка.

default void setRamdiskPartition (String ramdiskPartition)

Задает раздел оперативной памяти

default void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Определяет, следует ли прошивать дополнительный образ оперативной памяти после обновления устройства через ZIP-архив.

abstract void setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)

Определяет, следует ли записывать, удалять или сохранять образ пользовательских данных.

abstract void setWipeTimeout (long timeout)

Установите тайм-аут для удаления данных.

default boolean shouldFlashRamdisk ()

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

default boolean supportsFlashingInFastbootD ()

Можно ли прошить устройство, использующее программу для прошивки, в режиме fastbootd?

default void tearDownFlasher ()

Последняя возможность для реализации программы прошивки навести порядок после себя.

Общедоступные методы

checkAntiRollback

public boolean checkAntiRollback (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Проверьте, сработала ли защита от отката.

Параметры
device ITestDevice

deviceBuild IDeviceBuildInfo

Возвраты
boolean

Броски
DeviceNotAvailableException

вспышка

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Прошивка устанавливается на устройство.

Возврат происходит сразу после завершения прошивки. Пользователям следует дождаться, пока устройство подключится к сети и станет доступным, прежде чем приступать к тестированию.

Параметры
device ITestDevice : устройство ITestDevice для прошивки

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo для прошивки

Броски
DeviceNotAvailableException если устройство перестает реагировать
TargetSetupError если не удалось выполнить сборку прошивки

getAdditionalFileFilters

public Set<String> getAdditionalFileFilters ()

Получить фильтры для дополнительных артефактов сборки.

Некоторым программам для прошивки требуются определенные артефакты сборки, которые не входят в число используемых по умолчанию. Таким программам следует переопределить этот метод, чтобы каждому пользователю инструментов прошивки не нужно было знать об этих файлах и указывать параметры командной строки.

Обратите внимание, что этот метод вызывается для временного экземпляра IDeviceFlasher, поэтому нельзя полагаться ни на какое состояние, кроме того, которое указано в конструкторе по умолчанию.

Строки в наборе интерпретируются как шаблоны файлов, и будут получены все файлы, соответствующие шаблону.

По умолчанию этот метод возвращает пустой набор объектов (Set).

Возвраты
Set<String>

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

Получите информацию о состоянии выполнения команды для прошивки основных системных разделов.

Обратите внимание, что если системные разделы не прошиты (система уже содержит сборку, которую необходимо прошить), статус команды может быть null

Возвраты
CommandStatus

getUserDataFlashOption

public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Определяет, следует ли записывать, удалять или сохранять образ пользовательских данных.

Возвраты
IDeviceFlasher.UserDataFlashOption Следует ли записывать, стирать или сохранять образ пользовательских данных на флешку?

overrideDeviceOptions

public abstract void overrideDeviceOptions (ITestDevice device)

Переопределение параметров устройства. Используется для переопределения значений параметров по умолчанию, если значения по умолчанию не поддерживаются конкретным устройством.

postFlashOperations

public void postFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Все операции очистки и проверки, которые должны выполняться после фактического обновления критической секции. Ни одна из этих операций не будет включена в критическую секцию, управляемую параллельным доступом.

Параметры
device ITestDevice : устройство ITestDevice для прошивки

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo для прошивки

Броски
DeviceNotAvailableException если устройство перестает реагировать
TargetSetupError если какая-либо настройка не удастся

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Все операции настройки и проверки, которые должны быть выполнены до фактического обновления критической секции. Ни одна из этих операций не будет включена в критическую секцию, управляемую параллельным доступом.

Параметры
device ITestDevice : устройство ITestDevice для прошивки

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo для прошивки

Броски
DeviceNotAvailableException если устройство перестает реагировать
TargetSetupError если какая-либо настройка не удастся

setDataWipeSkipList

public abstract void setDataWipeSkipList (Collection<String> dataWipeSkipList)

Задает список путей в каталоге /data , чтобы избежать очистки при использовании ITestsZipInstaller

Обратите внимание, что список пропуска содержит только дочерние элементы /data .

Параметры
dataWipeSkipList Collection

setExtraMetadata

public void setExtraMetadata (Map<String, String> metadata)

Позволяет программе для прошивки получать дополнительные параметры метаданных.

Параметры
metadata Map

setFlashingResourcesRetriever

public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Задает механизм, с помощью которого программа для прошивки может получать файлы ресурсов для прошивки.

Параметры
retriever IFlashingResourcesRetriever : объект IFlashingResourcesRetriever для использования.

setForceSystemFlash

public abstract void setForceSystemFlash (boolean forceSystemFlash)

Определяет, следует ли всегда прошивать систему, даже если используется текущая сборка.

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Задает раздел оперативной памяти

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Определяет, следует ли прошивать дополнительный образ оперативной памяти после обновления устройства через ZIP-архив.

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Определяет, следует ли записывать, удалять или сохранять образ пользовательских данных.

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

Установите тайм-аут для удаления данных.

Параметры
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

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

Возвраты
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

Можно ли прошить устройство, использующее программу для прошивки, в режиме fastbootd?

Возвраты
boolean

tearDownFlasher

public void tearDownFlasher ()

Последняя возможность для реализации программы прошивки навести порядок после себя.