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 . |
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 ()
Последняя возможность для реализации программы прошивки навести порядок после себя.