Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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`