GkiDeviceFlashPreparer

public class GkiDeviceFlashPreparer
extends BaseTargetPreparer implements ILabPreparer

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.GkiDeviceFlashPreparer

---

Um preparador de destino que atualiza o dispositivo com uma imagem genérica do kernel comum do Android. Consulte https://source.android.com/devices/architecture/kernel/android-common para mais detalhes.

Resumo

Construtores públicos
GkiDeviceFlashPreparer()

Métodos públicos
void	setUp(TestInformation testInfo) Faça a configuração de destino para testes.
void	validateGkiBootImg(ITestDevice device, IBuildInfo buildInfo) Validar se a imagem de inicialização GKI é a esperada.

Métodos protegidos
void	addHashFooter(ITestDevice device, IBuildInfo buildInfo, File tmpDir) Validar se a imagem de inicialização GKI é a esperada.
void	buildGkiSystemDlkmImg(ITestDevice device, IBuildInfo buildInfo, File tmpDir) Crie a imagem system_dlkm do GKI se o arquivo system_dlkm for fornecido.
File	extractSystemDlkmTarGzip(File systemDlkmArchive) Extrai o arquivo tar gzip system_dlkm na pasta system_dlkm_staging.
void	flattenSystemDlkm(ITestDevice device, File systemDlkmStagingDir) Achate o diretório de preparo system_dlkm para que todos os módulos do kernel fiquem diretamente em /lib/modules.
String[]	getDeviceKernelVersion(ITestDevice device) Confira a versão do kernel do dispositivo antes de fazer o flash.
IHostOptions	getHostOptions() Acesse uma referência ao IHostOptions
String[]	getKernelVersionFromImage(File image) Extrai a versão do kernel de arquivos de imagem boot/vendor_boot/system_dlkm/vendor_dlkm.
File	getRequestedFile(ITestDevice device, String requestedFileName, File sourceFile, File tmpDir) Recebe o arquivo solicitado do arquivo de origem (ZIP ou pasta) pelo nome do arquivo solicitado.
IRunUtil	getRunUtil() Receba a instância IRunUtil a ser usada.
String[]	parseKernelVersion(String source, String kernelVersionString)
void	validateGkiBootImg(ITestDevice device, IBuildInfo buildInfo, File tmpDir) Validar se a imagem de inicialização GKI é a esperada.
void	validateKernelCompatibility(String imageName, String[] imageVersion, String[] bootVersion, ITestDevice device)
void	validateKernelVersion(ITestDevice device, IBuildInfo buildInfo, File tmpDir) Valide se as versões do kernel nas imagens são as esperadas.

Construtores públicos

GkiDeviceFlashPreparer

public GkiDeviceFlashPreparer ()

Métodos públicos

setUp

public void setUp (TestInformation testInfo)

Faça a configuração de destino para testes.

Parâmetros
testInfo	TestInformation: o TestInformation da invocação.

Gera
BuildError
DeviceNotAvailableException
TargetSetupError

validateGkiBootImg

public void validateGkiBootImg (ITestDevice device, 
                IBuildInfo buildInfo)

Validar se a imagem de inicialização GKI é a esperada. (Obsoleto. Please call with tmpDir provided)

Parâmetros
device	ITestDevice: o ITestDevice
buildInfo	IBuildInfo: o IBuildInfo as informações da build

Gera
TargetSetupError	se não houver um boot.img do GKI válido

Métodos protegidos

addHashFooter

protected void addHashFooter (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

Validar se a imagem de inicialização GKI é a esperada. Gerar exceção se não houver um boot.img válido.

Parâmetros
device	ITestDevice: o ITestDevice
buildInfo	IBuildInfo: o IBuildInfo as informações da build
tmpDir	File: o diretório temporário File

Gera
TargetSetupError	se não houver um boot.img do GKI válido
DeviceNotAvailableException

buildGkiSystemDlkmImg

protected void buildGkiSystemDlkmImg (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

Crie a imagem system_dlkm do GKI se o arquivo system_dlkm for fornecido.

Parâmetros
device	ITestDevice: o ITestDevice
buildInfo	IBuildInfo: o IBuildInfo as informações da build
tmpDir	File: o diretório temporário File

Gera
TargetSetupError	se houver um erro ao criar o arquivo de imagem.

extractSystemDlkmTarGzip

protected File extractSystemDlkmTarGzip (File systemDlkmArchive)

Extrai o arquivo tar gzip system_dlkm na pasta system_dlkm_staging. Essa função é um wrapper em torno de ERROR(/TarUtil.extractTarGzipToTemp) para criar stubs da descompactação para testes de unidade.

Parâmetros
systemDlkmArchive	File: o arquivo tar gzip system_dlkm que contém módulos GKI.

Retorna
File	Arquivo que contém o conteúdo gzip tar do system_dlkm.

Gera
	java.io.IOException
IOException

flattenSystemDlkm

protected void flattenSystemDlkm (ITestDevice device, 
                File systemDlkmStagingDir)

Achate o diretório de preparo system_dlkm para que todos os módulos do kernel estejam diretamente em /lib/modules. Isso é necessário para corresponder ao layout de arquivo system_dlkm esperado para builds de plataforma.

Parâmetros
device	ITestDevice: o ITestDevice
systemDlkmStagingDir	File: o diretório de preparo do system_dlkm File

Gera
IOException	ou TargetSetupError se houver um erro ao simplificar o system_dlkm.
TargetSetupError

getDeviceKernelVersion

protected String[] getDeviceKernelVersion (ITestDevice device)

Extraia a versão do kernel do dispositivo antes de fazer o flash.

Parâmetros
device	ITestDevice: o ITestDevice de onde a versão do kernel será extraída.

Retorna
String[]	Um ERROR(/String[]) que contém as informações analisadas da versão do kernel: [kernelVersion, patchLevel, pageSize]. Retorna nulo se não for possível analisar a string de versão.2

Gera
DeviceNotAvailableException

getHostOptions

protected IHostOptions getHostOptions ()

Acesse uma referência ao IHostOptions

Retorna
IHostOptions	o IHostOptions a ser usado

getKernelVersionFromImage

protected String[] getKernelVersionFromImage (File image)

Extrai a versão do kernel de arquivos de imagem boot/vendor_boot/system_dlkm/vendor_dlkm. Esse método lê o arquivo de imagem boot/vendor_boot/system_dlkm/vendor_dlkm e procura um padrão específico nas strings de versão do kernel do Android. Em seguida, ele analisa a string encontrada para extrair a versão do kernel em um formato padronizado.

Parâmetros
image	File: o File para o arquivo de imagem de inicialização (por exemplo, boot.img).

Retorna
String[]	Um ERROR(/String[]) que contém as informações analisadas da versão do kernel: [kernelVersion, patchLevel, pageSize]. Retorna nulo se não for possível analisar a string de versão.

getRequestedFile

protected File getRequestedFile (ITestDevice device, 
                String requestedFileName, 
                File sourceFile, 
                File tmpDir)

Recebe o arquivo solicitado do arquivo de origem (ZIP ou pasta) pelo nome do arquivo solicitado.

O arquivo de origem fornecido pode ser um arquivo ZIP. O método vai descompactar o arquivo em um diretório temporário e encontrar o arquivo solicitado pelo nome fornecido.

O arquivo de origem fornecido pode ser uma pasta de arquivos. O método vai encontrar o arquivo solicitado pelo nome fornecido.

Parâmetros
device	ITestDevice: o ITestDevice
requestedFileName	String: a string do nome do arquivo solicitado
sourceFile	File: o arquivo de origem
tmpDir	File

Retorna
File	o arquivo especificado pelo nome do arquivo solicitado

Gera
	com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

getRunUtil

protected IRunUtil getRunUtil ()

Receba a instância IRunUtil a ser usada.

Retorna
IRunUtil	o IRunUtil a ser usado

parseKernelVersion

protected String[] parseKernelVersion (String source, 
                String kernelVersionString)

Parâmetros
source	String
kernelVersionString	String

Retorna
String[]

validateGkiBootImg

protected void validateGkiBootImg (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

Validar se a imagem de inicialização GKI é a esperada. Gerar exceção se não houver um boot.img válido.

Parâmetros
device	ITestDevice: o ITestDevice
buildInfo	IBuildInfo: o IBuildInfo as informações da build
tmpDir	File: o diretório temporário File

Gera
TargetSetupError	se não houver um boot.img do GKI válido

validateKernelCompatibility

protected void validateKernelCompatibility (String imageName, 
                String[] imageVersion, 
                String[] bootVersion, 
                ITestDevice device)

Parâmetros
imageName	String
imageVersion	String
bootVersion	String
device	ITestDevice

Gera
TargetSetupError

validateKernelVersion

protected void validateKernelVersion (ITestDevice device, 
                IBuildInfo buildInfo, 
                File tmpDir)

Valide se as versões do kernel nas imagens são as esperadas. Gerar exceção se não for válido.

Parâmetros
device	ITestDevice: o ITestDevice
buildInfo	IBuildInfo: o IBuildInfo as informações da build
tmpDir	File: o diretório temporário File

Gera
TargetSetupError	se não houver um boot.img do GKI válido
DeviceNotAvailableException