Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

FastbootDeviceFlasher

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

java.lang.Object
com.android.tradefed.targetprep.FastbootDeviceFlasher


Una clase que se basa en fastboot para flashear una imagen en el hardware físico de Android.

Resumen

Los campos

public static final String BASEBAND_IMAGE_NAME

Constructores públicos

FastbootDeviceFlasher ()

Métodos públicos

void flash (ITestDevice device, IDeviceBuildInfo deviceBuild)

Los flashes se basan en el dispositivo.

CommandStatus getSystemFlashingStatus ()

Recupere el estado de ejecución del comando para flashear las particiones primarias del sistema.

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Obtiene si la imagen de datos del usuario debe actualizarse, borrarse o retenerse

void overrideDeviceOptions (ITestDevice device)

Anular opciones para un dispositivo.

void setDataWipeSkipList ( dataWipeSkipList) setDataWipeSkipList ( dataWipeSkipList)

Conjuntos de la lista de rutas bajo /data a la limpieza evitar al usar ITestsZipInstaller

Tenga en cuenta que la granularidad de la lista de salto es hijos directos de /data .

void setFlashOptions ( flashOptions) setFlashOptions ( flashOptions)

Establece una lista de opciones para pasar con los comandos flash / update.

void setFlashingResourcesRetriever ( IFlashingResourcesRetriever retriever)

Establece el mecanismo por el cual el flasher puede recuperar archivos de recursos para flashear.

void setForceSystemFlash (boolean forceSystemFlash)

Establece si el sistema siempre debe actualizarse incluso si se ejecuta la compilación actual

void setRamdiskPartition (String ramdiskPartition)

Establece la partición ramdisk

void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Establece si se debe actualizar un ramdisk adicional después de actualizar el dispositivo a través del zip de imagen

void setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)

Alterna si la imagen de datos del usuario debe actualizarse, borrarse o retenerse

void setWipeTimeout (long timeout)

Establezca el tiempo de espera para borrar los datos.

boolean shouldFlashRamdisk ()

Verifica si el flasher está configurado para tener un ramdisk adicional debe ser flasheado después de actualizar el dispositivo a través de la imagen zip

Métodos protegidos

void checkAndFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)

Si es necesario, muestre la imagen de banda base en el dispositivo.

boolean checkAndFlashBootloader (ITestDevice device, IDeviceBuildInfo deviceBuild)

Si es necesario, actualice la imagen del cargador de arranque en el dispositivo.

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

Si es necesario, actualice la imagen del sistema en el dispositivo.

boolean checkShouldFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)

Verifique si la banda base en el dispositivo provisto necesita ser flasheada.

IFlashingResourcesParser createFlashingResourcesParser ( IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)

Método de fábrica para crear un IFlashingResourcesParser .

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

Enganche para permitir que las subclases descarguen archivos de imagen personalizados adicionales si es necesario.

void downloadFlashingResources (ITestDevice device, IDeviceBuildInfo localBuild)

Descarga archivos de imagen flash adicionales necesarios

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

Método auxiliar para ejecutar el comando fastboot.

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

Método auxiliar para ejecutar un comando fastboot de larga duración.

void flashBaseband (ITestDevice device, File basebandImageFile)

Destella la imagen de banda base dada y reinicia de nuevo en el cargador de arranque

void flashBootloader (ITestDevice device, File bootloaderImageFile)

Muestra la imagen del cargador de arranque dada y se reinicia de nuevo en el cargador de arranque

void flashExtraImages (ITestDevice device, IDeviceBuildInfo deviceBuild)

Actualice las particiones específicas del dispositivo antes de actualizar el sistema y reiniciar.

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

Flash una partición individual de un dispositivo

void flashRamdiskIfNeeded (ITestDevice device, IDeviceBuildInfo deviceBuild)
void flashSystem (ITestDevice device, IDeviceBuildInfo deviceBuild)

Actualice la imagen del sistema en el dispositivo.

void flashUserData (ITestDevice device, IDeviceBuildInfo deviceBuild)

Flash partición de datos de usuario en el dispositivo.

void flashUserDataFromDeviceImageFile (ITestDevice device, IDeviceBuildInfo deviceBuild)

Extrae el userdata.img del archivo de imagen del dispositivo y lo muestra en el dispositivo.

String getBootPartitionName ()

Obtenga el nombre de la partición de arranque para este dispositivo de flasheo.

String getBootloaderFilePrefix (ITestDevice device)

Obtén el prefijo del archivo del cargador de arranque.

String getCurrentSlot (ITestDevice device)

Método auxiliar para recuperar la ranura actual (para dispositivos con capacidad A / B).

IFlashingResourcesRetriever getFlashingResourcesRetriever ()
String getImageVersion (ITestDevice device, String imageName)

Método de ayuda para obtener la versión actual de la imagen en el dispositivo.

IRunUtil getRunUtil ()

Expuesto para pruebas.

void handleUserDataFlashing (ITestDevice device, IDeviceBuildInfo deviceBuild)

Manejar el flasheo de los datos de usuario / partición de caché

boolean hasPartition (ITestDevice device, String partition)

Comprueba con el gestor de arranque si la partición especificada existe o no

void preFlashSetup (ITestDevice device, IDeviceBuildInfo deviceBuild)

Realice cualquier configuración de predestello adicional requerida.

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

Verifique que el tipo de producto del dispositivo sea compatible con la versión para flashear.

void wipeCache (ITestDevice device)

Limpie la partición de caché en el dispositivo.

void wipePartition (ITestDevice device, String partition)

Limpie la partición especificada con `fastboot erase <nombre>`

Los campos

BASEBAND_IMAGE_NAME

public static final String BASEBAND_IMAGE_NAME

Constructores públicos

FastbootDeviceFlasher

public FastbootDeviceFlasher ()

Métodos públicos

destello

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Los flashes se basan en el dispositivo.

Vuelve inmediatamente después de que se completa el parpadeo. Las personas que llaman deben esperar a que el dispositivo esté en línea y disponible antes de continuar con la prueba.

Parámetros
device ITestDevice : la ITestDevice a parpadear

deviceBuild IDeviceBuildInfo : la IDeviceBuildInfo a parpadear

Lanza
DeviceNotAvailableException
TargetSetupError

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

Recupere el estado de ejecución del comando para flashear las particiones primarias del sistema.

Tenga en cuenta que si las particiones del sistema no se sellan (sistema ya tiene la estructura que se mostró) el estado del comando puede ser null

Devoluciones
CommandStatus

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Obtiene si la imagen de datos del usuario debe actualizarse, borrarse o retenerse

Devoluciones
IDeviceFlasher.UserDataFlashOption Si la imagen de datos del usuario debe actualizarse, borrarse o conservarse

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

Anular opciones para un dispositivo. Se utiliza para anular los valores de opción predeterminados si un dispositivo en particular no admite los valores predeterminados.

setDataWipeSkipList

public void setDataWipeSkipList ( dataWipeSkipList)

Conjuntos de la lista de rutas bajo /data a la limpieza evitar al usar ITestsZipInstaller

Tenga en cuenta que la granularidad de la lista de salto es hijos directos de /data .

Parámetros
dataWipeSkipList

setFlashOptions

public void setFlashOptions ( flashOptions)

Establece una lista de opciones para pasar con los comandos flash / update.

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Establece el mecanismo por el cual el flasher puede recuperar archivos de recursos para flashear.

Parámetros
retriever IFlashingResourcesRetriever : la IFlashingResourcesRetriever de uso

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

Establece si el sistema siempre debe actualizarse incluso si se ejecuta la compilación actual

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Establece la partición ramdisk

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Establece si se debe actualizar un ramdisk adicional después de actualizar el dispositivo a través del zip de imagen

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Alterna si la imagen de datos del usuario debe actualizarse, borrarse o retenerse

setWipeTimeout

public void setWipeTimeout (long timeout)

Establezca el tiempo de espera para borrar los datos.

Parámetros
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Verifica si el flasher está configurado para tener un ramdisk adicional debe ser flasheado después de actualizar el dispositivo a través de la imagen zip

Devoluciones
boolean

Métodos protegidos

checkAndFlashBaseband

protected void checkAndFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Si es necesario, muestre la imagen de banda base en el dispositivo. ¡Solo parpadeará la banda base si la versión actual en el dispositivo! = Versión requerida

Parámetros
device ITestDevice : la ITestDevice a parpadear

deviceBuild IDeviceBuildInfo : la IDeviceBuildInfo que contiene la imagen de banda base a parpadear

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si falla al flashear la banda base

checkAndFlashBootloader

protected boolean checkAndFlashBootloader (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Si es necesario, actualice la imagen del cargador de arranque en el dispositivo.

¡Solo actualizará el cargador de arranque si la versión actual en el dispositivo! = Versión requerida.

Parámetros
device ITestDevice : la ITestDevice a parpadear

deviceBuild IDeviceBuildInfo : la IDeviceBuildInfo que contiene la imagen del cargador de arranque a parpadear

Devoluciones
boolean true si el gestor de arranque se ventiló, false si se ha omitido

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si no se pudo flashear el cargador de arranque

checkAndFlashSystem

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

Si es necesario, actualice la imagen del sistema en el dispositivo.

Por favor, mire ERROR(/#shouldFlashSystem(String,String,com.android.tradefed.build.IDeviceBuildInfo))

Independientemente de la ruta elegida, después de la ejecución del método, el dispositivo debe iniciarse en el espacio de usuario.

Parámetros
device ITestDevice : la ITestDevice a parpadear

systemBuildId String : la versión actual Identificación ejecuta en el dispositivo

systemBuildFlavor String : el sabor versión actual que se ejecuta en el dispositivo

deviceBuild IDeviceBuildInfo : la IDeviceBuildInfo que contiene la imagen del sistema a parpadear

Devoluciones
boolean true si el sistema se ventiló, false si se ha omitido

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si no se pudo flashear el cargador de arranque

checkShouldFlashBaseband

protected boolean checkShouldFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Verifique si la banda base en el dispositivo provisto necesita ser flasheada.

Parámetros
device ITestDevice : la ITestDevice al cheque

deviceBuild IDeviceBuildInfo : la IDeviceBuildInfo que contiene la imagen de banda base para comprobar

Devoluciones
boolean

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si falla al flashear la banda base

createFlashingResourcesParser

protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, 
                DeviceDescriptor descriptor)

Método de fábrica para crear un IFlashingResourcesParser .

Expuesto para pruebas unitarias.

Parámetros
localBuild IDeviceBuildInfo : la IDeviceBuildInfo para analizar

descriptor DeviceDescriptor : el descriptor del dispositivo que se cruzó.

Devoluciones
IFlashingResourcesParser un IFlashingResourcesParser creado por el método de fábrica.

Lanza
TargetSetupError

downloadExtraImageFiles

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

Enganche para permitir que las subclases descarguen archivos de imagen personalizados adicionales si es necesario.

Parámetros
resourceParser IFlashingResourcesParser : la IFlashingResourcesParser

retriever IFlashingResourcesRetriever : la IFlashingResourcesRetriever

localBuild IDeviceBuildInfo : la IDeviceBuildInfo

Lanza
TargetSetupError

descargarFlashingResources

protected void downloadFlashingResources (ITestDevice device, 
                IDeviceBuildInfo localBuild)

Descarga archivos de imagen flash adicionales necesarios

Parámetros
device ITestDevice : la ITestDevice a los recursos de descargas de

localBuild IDeviceBuildInfo : la IDeviceBuildInfo para poblar. Supone que el archivo de imagen del dispositivo ya está configurado

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si no pudo recuperar los recursos

executeFastbootCmd

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

Método auxiliar para ejecutar el comando fastboot.

Parámetros
device ITestDevice : la ITestDevice para ejecutar comandos en

cmdArgs String : los argumentos para proporcionar a fastboot

Devoluciones
String Encadena la salida stderr del comando si no está vacío. De lo contrario, devuelve la salida estándar.Algunos comandos fastboot son extraños porque descargan la salida a stderr en caso de éxito.

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si falla el comando fastboot

executeLongFastbootCmd

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

Método auxiliar para ejecutar un comando fastboot de larga duración.

Nota: La mayoría de los comandos fastboot normalmente se ejecutan dentro del tiempo límite permitido por INativeDevice.executeFastbootCommand(String) . Sin embargo, cuando varios dispositivos parpadean a la vez, los comandos fastboot pueden tardar mucho más de lo normal.

Parámetros
device ITestDevice : la ITestDevice para ejecutar comandos en

cmdArgs String : los argumentos para proporcionar a fastboot

Devoluciones
String Encadena la salida stderr del comando si no está vacío. De lo contrario, devuelve la salida estándar.Algunos comandos fastboot son extraños porque descargan la salida a stderr en caso de éxito.

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si falla el comando fastboot

flashBaseband

protected void flashBaseband (ITestDevice device, 
                File basebandImageFile)

Destella la imagen de banda base dada y reinicia de nuevo en el cargador de arranque

Parámetros
device ITestDevice : la ITestDevice a parpadear

basebandImageFile File : la imagen de banda base ERROR(/File)

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si falla al flashear la banda base

flashBootloader

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile)

Muestra la imagen del cargador de arranque dada y se reinicia de nuevo en el cargador de arranque

Parámetros
device ITestDevice : la ITestDevice a parpadear

bootloaderImageFile File : la imagen del cargador de arranque ERROR(/File)

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si falla al parpadear

flashExtraImages

protected void flashExtraImages (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Actualice las particiones específicas del dispositivo antes de actualizar el sistema y reiniciar. Sin operación a menos que se anule.

Parámetros
device ITestDevice : la ITestDevice a parpadear

deviceBuild IDeviceBuildInfo : la IDeviceBuildInfo que contiene los archivos de generación

Lanza
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

flashPartition

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

Flash una partición individual de un dispositivo

Parámetros
device ITestDevice : la ITestDevice a parpadear

imgFile File : un ERROR(/File) que apunta a la imagen que se mostró

partition String : el nombre de la partición que se mostró

Lanza
DeviceNotAvailableException
TargetSetupError

flashRamdiskIfNeeded

protected void flashRamdiskIfNeeded (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Parámetros
device ITestDevice

deviceBuild IDeviceBuildInfo

Lanza
DeviceNotAvailableException
TargetSetupError

flashSystem

protected void flashSystem (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Actualice la imagen del sistema en el dispositivo.

Parámetros
device ITestDevice : la ITestDevice a parpadear

deviceBuild IDeviceBuildInfo : la IDeviceBuildInfo a parpadear

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si falla el comando fastboot

flashUserData

protected void flashUserData (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flash partición de datos de usuario en el dispositivo.

Parámetros
device ITestDevice : la ITestDevice a parpadear

deviceBuild IDeviceBuildInfo : la IDeviceBuildInfo que contiene los archivos de Flash

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si no pudo actualizar los datos del usuario

flashUserDataFromDeviceImageFile

protected void flashUserDataFromDeviceImageFile (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Extrae el userdata.img del archivo de imagen del dispositivo y lo muestra en el dispositivo.

Parámetros
device ITestDevice : la ITestDevice a parpadear

deviceBuild IDeviceBuildInfo : la IDeviceBuildInfo que contiene los archivos de Flash

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si no se pudieron extraer o actualizar los datos del usuario

getBootPartitionName

protected String getBootPartitionName ()

Obtenga el nombre de la partición de arranque para este dispositivo de flasheo.

El valor predeterminado es 'cargador de arranque'. Las subclases deben anularse si es necesario.

Devoluciones
String

getBootloaderFilePrefix

protected String getBootloaderFilePrefix (ITestDevice device)

Obtén el prefijo del archivo del cargador de arranque.

El valor predeterminado es getBootPartitionName() . Las subclases deben anularse si es necesario.

Parámetros
device ITestDevice : la ITestDevice a parpadear

Devoluciones
String

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si no pudo obtener el prefijo

getCurrentSlot

protected String getCurrentSlot (ITestDevice device)

Método auxiliar para recuperar la ranura actual (para dispositivos con capacidad A / B).

Parámetros
device ITestDevice : la ITestDevice para ejecutar comandos en.

Devoluciones
String "a", "b" o nulo (si el dispositivo no es compatible con A / B)

Lanza
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

getFlashingResourcesRetriever

protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()

Devoluciones
IFlashingResourcesRetriever

getImageVersion

protected String getImageVersion (ITestDevice device, 
                String imageName)

Método auxiliar para obtener la versión actual de la imagen en el dispositivo.

Parámetros
device ITestDevice : la ITestDevice para ejecutar comandos en

imageName String : el nombre de la imagen de conseguir.

Devoluciones
String Encadena la salida estándar del comando

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si el comando fastboot falla o no se pudo determinar la versión

getRunUtil

protected IRunUtil getRunUtil ()

Expuesto para pruebas.

Devoluciones
IRunUtil

handleUserDataFlashing

protected void handleUserDataFlashing (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Manejar el flasheo de los datos de usuario / partición de caché

Parámetros
device ITestDevice : la ITestDevice a parpadear

deviceBuild IDeviceBuildInfo : la IDeviceBuildInfo que contiene los archivos de Flash

Lanza
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

hasPartition

protected boolean hasPartition (ITestDevice device, 
                String partition)

Comprueba con el gestor de arranque si la partición especificada existe o no

Parámetros
device ITestDevice : la ITestDevice para operar en

partition String : el nombre de la partición de comprobación

Devoluciones
boolean

Lanza
DeviceNotAvailableException

preFlashSetup

protected void preFlashSetup (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Realice cualquier configuración de predestello adicional requerida. No operativa a menos que se anule.

Parámetros
device ITestDevice : la ITestDevice para preparar

deviceBuild IDeviceBuildInfo : la IDeviceBuildInfo que contiene los archivos de generación

Lanza
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

verifyRequiredBoards

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

Verifique que el tipo de producto del dispositivo sea compatible con la versión para flashear.

La implementación base verificará que el deviceProductType está incluido en las IFlashingResourcesParser.getRequiredBoards() de recogida. Las subclases pueden anularse según se desee.

Parámetros
device ITestDevice : la ITestDevice que ser flasheado

resourceParser IFlashingResourcesParser : la IFlashingResourcesParser

deviceProductType String : el device 's tipo de producto

Lanza
TargetSetupError si la información de placa requerida por la compilación no coincide con el dispositivo

wipeCache

protected void wipeCache (ITestDevice device)

Limpie la partición de caché en el dispositivo.

Parámetros
device ITestDevice : la ITestDevice a parpadear

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si no se pudo flashear el caché

wipePartition

protected void wipePartition (ITestDevice device, 
                String partition)

Limpie la partición especificada con `fastboot erase <nombre>`

Parámetros
device ITestDevice : la ITestDevice para operar en

partition String : el nombre de la partición que se secó

Lanza
DeviceNotAvailableException
TargetSetupError