FastbootDeviceFlasher

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

java.lang.Объект
↳	com.android.tradefed.targetprep.FastbootDeviceFlasher

---

Класс, использующий fastboot для прошивки образа на физическом оборудовании Android.

Резюме

Поля
public static final String	BASEBAND_IMAGE_NAME

Публичные конструкторы
FastbootDeviceFlasher ()

Публичные методы
void	flash (ITestDevice device, IDeviceBuildInfo deviceBuild) Вспышки встроены в устройство.
CommandStatus	getSystemFlashingStatus () Получить статус выполнения команды для перепрошивки основных системных разделов.
IDeviceFlasher.UserDataFlashOption	getUserDataFlashOption () Получает, следует ли прошивать, стирать или сохранять образ пользовательских данных.
void	overrideDeviceOptions (ITestDevice device) Параметры переопределения для устройства.
void	setDataWipeSkipList ( dataWipeSkipList) setDataWipeSkipList ( dataWipeSkipList) Устанавливает список путей в /data , чтобы избежать очистки при использовании ITestsZipInstaller Обратите внимание, что гранулярность списка пропуска является прямым потомком /data .
void	setFlashOptions ( flashOptions) setFlashOptions ( flashOptions) Устанавливает список параметров для передачи с командами прошивки/обновления.
void	setFlashingResourcesRetriever ( IFlashingResourcesRetriever retriever) Устанавливает механизм, с помощью которого прошивальщик может получить файлы ресурсов для перепрошивки.
void	setForceSystemFlash (boolean forceSystemFlash) Устанавливает, должна ли система всегда прошиваться, даже если запущена текущая сборка
void	setRamdiskPartition (String ramdiskPartition) Устанавливает раздел виртуального диска
void	setShouldFlashRamdisk (boolean shouldFlashRamdisk) Устанавливает, следует ли прошивать дополнительный виртуальный диск после обновления устройства с помощью zip-архива
void	setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption) Переключает, следует ли прошивать, стирать или сохранять изображение пользовательских данных.
void	setWipeTimeout (long timeout) Установите время ожидания для очистки данных.
boolean	shouldFlashRamdisk () Проверяет, настроен ли прошивальщик на наличие дополнительного виртуального диска, который следует прошивать после обновления устройства через образ zip.

Защищенные методы
void	checkAndFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild) При необходимости запустите образ основной полосы частот на устройстве.
boolean	checkAndFlashBootloader (ITestDevice device, IDeviceBuildInfo deviceBuild) При необходимости прошейте образ загрузчика на устройстве.
boolean	checkAndFlashSystem (ITestDevice device, String systemBuildId, String systemBuildFlavor, IDeviceBuildInfo deviceBuild) При необходимости прошейте образ системы на устройстве.
boolean	checkShouldFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild) Проверьте, не нужно ли прошивать основную полосу на предоставленном устройстве.
IFlashingResourcesParser	createFlashingResourcesParser ( IDeviceBuildInfo localBuild, DeviceDescriptor descriptor) Фабричный метод для создания IFlashingResourcesParser .
void	downloadExtraImageFiles ( IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild) Хук, позволяющий подклассам загружать дополнительные пользовательские файлы изображений, если это необходимо.
void	downloadFlashingResources (ITestDevice device, IDeviceBuildInfo localBuild) Загружает необходимые дополнительные файлы мигающих изображений
String	executeFastbootCmd (ITestDevice device, String... cmdArgs) Вспомогательный метод для выполнения команды fastboot.
String	executeLongFastbootCmd (ITestDevice device, String... cmdArgs) Вспомогательный метод для выполнения длительной команды fastboot.
void	flashBaseband (ITestDevice device, File basebandImageFile) Прошивает указанный образ основной полосы частот и перезагружается обратно в загрузчик
void	flashBootloader (ITestDevice device, File bootloaderImageFile) Прошивает данный образ загрузчика и перезагружается обратно в загрузчик
void	flashExtraImages (ITestDevice device, IDeviceBuildInfo deviceBuild) Перед прошивкой системы и перезагрузкой выполните прошивку любых разделов устройства.
void	flashPartition (ITestDevice device, File imgFile, String partition) Прошить отдельный раздел устройства
void	flashRamdiskIfNeeded (ITestDevice device, IDeviceBuildInfo deviceBuild)
void	flashSystem (ITestDevice device, IDeviceBuildInfo deviceBuild) Прошить образ системы на устройстве.
void	flashUserData (ITestDevice device, IDeviceBuildInfo deviceBuild) Прошить раздел пользовательских данных на устройстве.
void	flashUserDataFromDeviceImageFile (ITestDevice device, IDeviceBuildInfo deviceBuild) Извлекает файл userdata.img из файла образа устройства и записывает его на устройство.
String	getBootPartitionName () Получите имя загрузочного раздела для этого прошивальщика устройства.
String	getBootloaderFilePrefix (ITestDevice device) Получите префикс файла загрузчика.
String	getCurrentSlot (ITestDevice device) Вспомогательный метод для получения текущего слота (для устройств с поддержкой A/B).
IFlashingResourcesRetriever	getFlashingResourcesRetriever ()
String	getImageVersion (ITestDevice device, String imageName) Вспомогательный метод для получения текущей версии образа на устройстве.
IRunUtil	getRunUtil () Выставлен на тестирование.
void	handleUserDataFlashing (ITestDevice device, IDeviceBuildInfo deviceBuild) Обработка перепрошивки раздела userdata/cache
boolean	hasPartition (ITestDevice device, String partition) Проверяет с помощью загрузчика, существует ли указанный раздел или нет
void	preFlashSetup (ITestDevice device, IDeviceBuildInfo deviceBuild) Выполните любую дополнительную предварительную настройку.
void	verifyRequiredBoards (ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType) Убедитесь, что тип продукта устройства поддерживает сборку для прошивки.
void	wipeCache (ITestDevice device) Очистите раздел кеша на устройстве.
void	wipePartition (ITestDevice device, String partition) Сотрите указанный раздел с помощью `fastboot erase <name>`

Поля

BASEBAND_IMAGE_NAME

public static final String BASEBAND_IMAGE_NAME

Публичные конструкторы

FastbootDeviceFlasher

public FastbootDeviceFlasher ()

Публичные методы

вспышка

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Вспышки встроены в устройство.

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

Параметры
device	ITestDevice : ITestDevice для прошивки
deviceBuild	IDeviceBuildInfo : IDeviceBuildInfo для прошивки

Броски
DeviceNotAvailableException
TargetSetupError

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

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

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

Возвращает
CommandStatus

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

Возвращает
IDeviceFlasher.UserDataFlashOption	Должен ли образ пользовательских данных прошиваться, стираться или сохраняться

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

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

setDataWipeSkipList

public void setDataWipeSkipList ( dataWipeSkipList)

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

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

Параметры
dataWipeSkipList

setFlashOptions

public void setFlashOptions ( flashOptions)

Устанавливает список параметров для передачи с командами прошивки/обновления.

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

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

Параметры
retriever	IFlashingResourcesRetriever : используемый IFlashingResourcesRetriever

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

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

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Устанавливает раздел виртуального диска

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Устанавливает, следует ли прошивать дополнительный виртуальный диск после обновления устройства с помощью zip-архива

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

setWipeTimeout

public void setWipeTimeout (long timeout)

Установите время ожидания для очистки данных.

Параметры
timeout	long

долженFlashRamdisk

public boolean shouldFlashRamdisk ()

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

Возвращает
boolean

Защищенные методы

checkAndFlashBaseband

protected void checkAndFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

При необходимости запустите образ основной полосы частот на устройстве. Будет мигать только основная полоса, если текущая версия на устройстве! = требуемая версия

Параметры
device	ITestDevice : ITestDevice для прошивки
deviceBuild	IDeviceBuildInfo : IDeviceBuildInfo , который содержит образ основной полосы для прошивки.

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

проверитьAndFlashBootloader

protected boolean checkAndFlashBootloader (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

Будет прошивать загрузчик только в том случае, если текущая версия на устройстве != требуемая версия.

Параметры
device	ITestDevice : ITestDevice для прошивки
deviceBuild	IDeviceBuildInfo : IDeviceBuildInfo , содержащий образ загрузчика для прошивки.

Возвращает
boolean	true , если загрузчик был прошит, false , если он был пропущен

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

checkAndFlashSystem

protected boolean checkAndFlashSystem (ITestDevice device, 
                String systemBuildId, 
                String systemBuildFlavor, 
                IDeviceBuildInfo deviceBuild)

При необходимости прошейте образ системы на устройстве.

Пожалуйста, посмотрите ERROR(/#shouldFlashSystem(String,String,com.android.tradefed.build.IDeviceBuildInfo))

Независимо от выбранного пути, после выполнения метода устройство должно загружаться в пользовательское пространство.

Параметры
device	ITestDevice : ITestDevice для прошивки
systemBuildId	String : текущий идентификатор сборки, работающий на устройстве.
systemBuildFlavor	String : текущая версия сборки, работающая на устройстве.
deviceBuild	IDeviceBuildInfo : IDeviceBuildInfo , содержащий образ системы для прошивки.

Возвращает
boolean	true , если система была прошита, false , если она была пропущена

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

checkShouldFlashBaseband

protected boolean checkShouldFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Проверьте, не нужно ли прошивать основную полосу на предоставленном устройстве.

Параметры
device	ITestDevice : ITestDevice для проверки
deviceBuild	IDeviceBuildInfo : IDeviceBuildInfo , который содержит изображение основной полосы для проверки.

Возвращает
boolean

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

создатьFlashingResourcesParser

protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, 
                DeviceDescriptor descriptor)

Фабричный метод для создания IFlashingResourcesParser .

Выставлено для модульного тестирования.

Параметры
localBuild	IDeviceBuildInfo : IDeviceBuildInfo для анализа
descriptor	DeviceDescriptor : дескриптор прошиваемого устройства.

Возвращает
IFlashingResourcesParser	IFlashingResourcesParser , созданный фабричным методом.

Броски
TargetSetupError

скачатьExtraImageFiles

protected void downloadExtraImageFiles (IFlashingResourcesParser resourceParser, 
                IFlashingResourcesRetriever retriever, 
                IDeviceBuildInfo localBuild)

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

Параметры
resourceParser	IFlashingResourcesParser : IFlashingResourcesParser
retriever	IFlashingResourcesRetriever : IFlashingResourcesRetriever
localBuild	IDeviceBuildInfo : IDeviceBuildInfo

Броски
TargetSetupError

скачатьFlashingResources

protected void downloadFlashingResources (ITestDevice device, 
                IDeviceBuildInfo localBuild)

Загружает необходимые дополнительные файлы мигающих изображений

Параметры
device	ITestDevice : ITestDevice для загрузки ресурсов.
localBuild	IDeviceBuildInfo : IDeviceBuildInfo для заполнения. Предполагается, что файл образа устройства уже установлен

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

выполнитьFastbootCmd

protected String executeFastbootCmd (ITestDevice device, 
                String... cmdArgs)

Вспомогательный метод для выполнения команды fastboot.

Параметры
device	ITestDevice : ITestDevice для выполнения команды.
cmdArgs	String : аргументы для быстрой загрузки.

Возвращает
String	Строка вывода stderr из команды, если она не пуста. В противном случае возвращается stdout. Некоторые команды fastboot странны тем, что в случае успеха они сбрасывают вывод на stderr.

Броски
DeviceNotAvailableException	если устройство недоступно
TargetSetupError	если команда fastboot не работает

выполнитьLongFastbootCmd

protected String executeLongFastbootCmd (ITestDevice device, 
                String... cmdArgs)

Вспомогательный метод для выполнения длительной команды fastboot.

Примечание. Большинство команд fastboot обычно выполняются в течение времени ожидания, разрешенного INativeDevice.executeFastbootCommand(String) . Однако, когда несколько устройств прошивают устройства одновременно, команды fastboot могут занимать намного больше времени, чем обычно.

Параметры
device	ITestDevice : ITestDevice для выполнения команды.
cmdArgs	String : аргументы для быстрой загрузки.

Возвращает
String	Строка вывода stderr из команды, если она не пуста. В противном случае возвращается stdout. Некоторые команды fastboot странны тем, что в случае успеха они сбрасывают вывод на stderr.

Броски
DeviceNotAvailableException	если устройство недоступно
TargetSetupError	если команда fastboot не работает

flashBaseband

protected void flashBaseband (ITestDevice device, 
                File basebandImageFile)

Прошивает указанный образ основной полосы частот и перезагружается обратно в загрузчик

Параметры
device	ITestDevice : ITestDevice для прошивки
basebandImageFile	File : изображение основной полосы частот ERROR(/File)

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

flash загрузчик

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile)

Прошивает данный образ загрузчика и перезагружается обратно в загрузчик

Параметры
device	ITestDevice : ITestDevice для прошивки
bootloaderImageFile	File : образ загрузчика ERROR(/File)

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

flashExtraImages

protected void flashExtraImages (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Перед прошивкой системы и перезагрузкой выполните прошивку любых разделов устройства. Не работает, если не переопределено.

Параметры
device	ITestDevice : ITestDevice для прошивки
deviceBuild	IDeviceBuildInfo : IDeviceBuildInfo , содержащий файлы сборки.

Броски
	com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

флэш-раздел

protected void flashPartition (ITestDevice device, 
                File imgFile, 
                String partition)

Прошить отдельный раздел устройства

Параметры
device	ITestDevice : ITestDevice для прошивки
imgFile	File : ERROR(/File) , указывающая на изображение, которое нужно прошить.
partition	String : имя раздела, который нужно прошить.

Броски
DeviceNotAvailableException
TargetSetupError

flashRamdiskIfNeeded

protected void flashRamdiskIfNeeded (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Параметры
device	ITestDevice
deviceBuild	IDeviceBuildInfo

Броски
DeviceNotAvailableException
TargetSetupError

flashСистема

protected void flashSystem (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Прошить образ системы на устройстве.

Параметры
device	ITestDevice : ITestDevice для прошивки
deviceBuild	IDeviceBuildInfo : IDeviceBuildInfo для прошивки

Броски
DeviceNotAvailableException	если устройство недоступно
TargetSetupError	если команда fastboot не работает

FlashUserData

protected void flashUserData (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Прошить раздел пользовательских данных на устройстве.

Параметры
device	ITestDevice : ITestDevice для прошивки
deviceBuild	IDeviceBuildInfo : IDeviceBuildInfo , содержащий файлы для прошивки.

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

flashUserDataFromDeviceImageFile

protected void flashUserDataFromDeviceImageFile (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Извлекает файл userdata.img из файла образа устройства и записывает его на устройство.

Параметры
device	ITestDevice : ITestDevice для прошивки
deviceBuild	IDeviceBuildInfo : IDeviceBuildInfo , содержащий файлы для прошивки.

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

getBootPartitionName

protected String getBootPartitionName ()

Получите имя загрузочного раздела для этого прошивальщика устройства.

По умолчанию используется «загрузчик». Подклассы должны переопределяться, если это необходимо.

Возвращает
String

getBootloaderFilePrefix

protected String getBootloaderFilePrefix (ITestDevice device)

Получите префикс файла загрузчика.

По умолчанию getBootPartitionName() . Подклассы должны переопределяться, если это необходимо.

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

Возвращает
String

Броски
DeviceNotAvailableException	если устройство недоступно
TargetSetupError	если не удалось получить префикс

получить текущий слот

protected String getCurrentSlot (ITestDevice device)

Вспомогательный метод для получения текущего слота (для устройств с поддержкой A/B).

Параметры
device	ITestDevice : ITestDevice для выполнения команды.

Возвращает
String	"a", "b" или null (если устройство не поддерживает A/B)

Броски
	com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

getFlashingResourcesRetriever

protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()

Возвращает
IFlashingResourcesRetriever

получитьImageVersion

protected String getImageVersion (ITestDevice device, 
                String imageName)

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

Параметры
device	ITestDevice : ITestDevice для выполнения команды.
imageName	String : имя изображения, которое необходимо получить.

Возвращает
String	Строка вывода stdout из команды

Броски
DeviceNotAvailableException	если устройство недоступно
TargetSetupError	если команда fastboot не удалась или не удалось определить версию

getRunUtil

protected IRunUtil getRunUtil ()

Выставлен на тестирование.

Возвращает
IRunUtil

дескрипторUserDataFlashing

protected void handleUserDataFlashing (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Обработка перепрошивки раздела userdata/cache

Параметры
device	ITestDevice : ITestDevice для прошивки
deviceBuild	IDeviceBuildInfo : IDeviceBuildInfo , содержащий файлы для прошивки.

Броски
	com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

hasPartition

protected boolean hasPartition (ITestDevice device, 
                String partition)

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

Параметры
device	ITestDevice : ITestDevice для работы.
partition	String : имя проверяемого раздела.

Возвращает
boolean

Броски
DeviceNotAvailableException

preFlashSetup

protected void preFlashSetup (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Выполните любую дополнительную предварительную настройку. Не работает, если не переопределено.

Параметры
device	ITestDevice : ITestDevice для подготовки
deviceBuild	IDeviceBuildInfo : IDeviceBuildInfo , содержащий файлы сборки.

Броски
	com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

Верирекуиредбордс

protected void verifyRequiredBoards (ITestDevice device, 
                IFlashingResourcesParser resourceParser, 
                String deviceProductType)

Убедитесь, что тип продукта устройства поддерживает сборку для прошивки.

Базовая реализация проверит, включен ли тип deviceProductType в коллекцию IFlashingResourcesParser.getRequiredBoards() . Подклассы могут переопределять по желанию.

Параметры
device	ITestDevice : ITestDevice для прошивки
resourceParser	IFlashingResourcesParser : IFlashingResourcesParser
deviceProductType	String : тип продукта device .

Броски
TargetSetupError	если требуемая для сборки информация о плате не соответствует устройству

очистить кэш

protected void wipeCache (ITestDevice device)

Очистите раздел кеша на устройстве.

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

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

стереть раздел

protected void wipePartition (ITestDevice device, 
                String partition)

Сотрите указанный раздел с помощью `fastboot erase <name>`

Параметры
device	ITestDevice : ITestDevice для работы.
partition	String : имя раздела, который нужно стереть.

Броски
DeviceNotAvailableException
TargetSetupError