Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

FastbootDeviceFlasher

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

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


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

Resumen

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 actualizar las particiones del sistema primario.

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

void overrideDeviceOptions (ITestDevice device)

Reemplazar opciones para un dispositivo.

void setDataWipeSkipList ( dataWipeSkipList) setDataWipeSkipList ( dataWipeSkipList)

Establece la lista de rutas en /data para evitar ITestsZipInstaller cuando se usa ITestsZipInstaller

Tenga en cuenta que la granularidad de la lista de omisión son 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 setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Establece si se debe actualizar un disco RAM adicional después de actualizar el dispositivo a través del archivo zip

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 del zip de imagen

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)

Muestra 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 nuevamente 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 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.

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 la actualización de 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 actualizar.

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>`

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 : el ITestDevice para flashear

deviceBuild IDeviceBuildInfo : el IDeviceBuildInfo para flashear

Lanza
DeviceNotAvailableException
TargetSetupError

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

Recupere el estado de ejecución del comando para actualizar las particiones del sistema primario.

Tenga en cuenta que si las particiones del sistema no se actualizan (el sistema ya tiene la compilación para actualizarse), 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)

Reemplazar 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)

Establece la lista de rutas en /data para evitar ITestsZipInstaller cuando se usa ITestsZipInstaller

Tenga en cuenta que la granularidad de la lista de omisión son 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 : el IFlashingResourcesRetriever para usar

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

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

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 del 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 : el ITestDevice para flashear

deviceBuild IDeviceBuildInfo : el IDeviceBuildInfo que contiene la imagen de banda base para flashear

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 : el ITestDevice para flashear

deviceBuild IDeviceBuildInfo : el IDeviceBuildInfo que contiene la imagen del cargador de arranque para flashear

Devoluciones
boolean true si el cargador de arranque se actualizó, false si se omitió

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.

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 : el ITestDevice para flashear

systemBuildId String : el ID de compilación actual que se ejecuta en el dispositivo

systemBuildFlavor String : el tipo de compilación actual que se ejecuta en el dispositivo

deviceBuild IDeviceBuildInfo : el IDeviceBuildInfo que contiene la imagen del sistema para flashear

Devoluciones
boolean true si el sistema fue flasheado, false si fue 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 : el ITestDevice para comprobar

deviceBuild IDeviceBuildInfo : el IDeviceBuildInfo que contiene la imagen de banda base para verificar

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 : el IDeviceBuildInfo para analizar

descriptor DeviceDescriptor : el descriptor del dispositivo que se está flasheando.

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 : el IFlashingResourcesParser

retriever IFlashingResourcesRetriever : el IFlashingResourcesRetriever

localBuild IDeviceBuildInfo : IDeviceBuildInfo

Lanza
TargetSetupError

descargarFlashingResources

protected void downloadFlashingResources (ITestDevice device, 
                IDeviceBuildInfo localBuild)

Descarga archivos de imagen flash adicionales necesarios

Parámetros
device ITestDevice : el ITestDevice para descargar recursos

localBuild IDeviceBuildInfo : el IDeviceBuildInfo para rellenar. 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 : el ITestDevice para ejecutar el comando

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 de espera permitido por ITestDevice#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 : el ITestDevice para ejecutar el comando

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)

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

Parámetros
device ITestDevice : el ITestDevice para flashear

basebandImageFile File : ERROR(/File) 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 nuevamente en el cargador de arranque

Parámetros
device ITestDevice : el ITestDevice para flashear

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

Lanza
DeviceNotAvailableException si el dispositivo no está disponible
TargetSetupError si no parpadea

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 : el ITestDevice para flashear

deviceBuild IDeviceBuildInfo : el IDeviceBuildInfo contiene los archivos de compilació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 : el ITestDevice para flashear

imgFile File : un ERROR(/File) apunta a la imagen que se va a flashear

partition String : el nombre de la partición que se mostrará.

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 : el ITestDevice para flashear

deviceBuild IDeviceBuildInfo : el IDeviceBuildInfo para flashear

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 : el ITestDevice para flashear

deviceBuild IDeviceBuildInfo : el IDeviceBuildInfo que contiene los archivos para flashear

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 userdata.img del archivo de imagen del dispositivo y lo muestra en el dispositivo.

Parámetros
device ITestDevice : el ITestDevice para flashear

deviceBuild IDeviceBuildInfo : el IDeviceBuildInfo que contiene los archivos para flashear

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

getBootPartitionName

protected String getBootPartitionName ()

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

Por defecto es 'bootloader'. 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 : el ITestDevice para flashear

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 : el ITestDevice para ejecutar el comando.

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 de ayuda para obtener la versión actual de la imagen en el dispositivo.

Parámetros
device ITestDevice : el ITestDevice para ejecutar el comando

imageName String : el nombre de la imagen a obtener.

Devoluciones
String Encadena la salida stdout 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 datos de usuario / partición de caché

Parámetros
device ITestDevice : el ITestDevice para flashear

deviceBuild IDeviceBuildInfo : el IDeviceBuildInfo que contiene los archivos para flashear

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 : el ITestDevice para operar

partition String : el nombre de la partición a verificar

Devoluciones
boolean

Lanza
DeviceNotAvailableException

preFlashSetup

protected void preFlashSetup (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Realice cualquier configuración de predestello adicional requerida. Sin operación a menos que se anule.

Parámetros
device ITestDevice : el ITestDevice para preparar

deviceBuild IDeviceBuildInfo : el IDeviceBuildInfo contiene los archivos de compilació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 actualizar.

La implementación base verificará que deviceProductType esté incluido en la IFlashingResourcesParser#getRequiredBoards() . Las subclases pueden anularse según se desee.

Parámetros
device ITestDevice : el ITestDevice que se ITestDevice a ITestDevice

resourceParser IFlashingResourcesParser : el IFlashingResourcesParser

deviceProductType String : el tipo de producto del device

Lanza
TargetSetupError si la información de placa requerida de 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 : el ITestDevice para flashear

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 : el ITestDevice para operar

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

Lanza
DeviceNotAvailableException
TargetSetupError