此页面由 Cloud Translation API 翻译。

GkiDeviceFlashPreparer

public class GkiDeviceFlashPreparer
extends BaseTargetPreparer implements ILabPreparer

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

使用 Android 通用内核通用映像刷写设备的目标准备器。请参阅如需了解详情，请访问 https://source.android.com/devices/architecture/kernel/android-common。

摘要

公共构造函数
`GkiDeviceFlashPreparer()`

公共方法
`void`	`setUp(TestInformation testInfo)` 执行目标设置以进行测试。
`void`	`validateGkiBootImg(ITestDevice device, IBuildInfo buildInfo)` 验证 GKI 启动映像是否符合预期。

受保护的方法
`void`	`addHashFooter(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` 验证 GKI 启动映像是否符合预期。
`void`	`buildGkiSystemDlkmImg(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` 如果提供了 system_dlkm 归档，请构建 GKI system_dlkm 映像。
`File`	`extractSystemDlkmTarGzip(File systemDlkmArchive)` 将 system_dlkm tar gzip 文件解压缩到 system_dlkm_staging 文件夹。
`void`	`flattenSystemDlkm(ITestDevice device, File systemDlkmStagingDir)` 展平 system_dlkm 暂存目录，使所有内核模块都直接位于其下 /lib/modules 中。
`IHostOptions`	`getHostOptions()` 获取对 `IHostOptions` 的引用
`File`	`getRequestedFile(ITestDevice device, String requestedFileName, File sourceFile, File tmpDir)` 按请求的文件名从源文件（zip 或文件夹）中获取请求的文件。
`IRunUtil`	`getRunUtil()` 获取要使用的 `IRunUtil` 实例。
`void`	`validateGkiBootImg(ITestDevice device, IBuildInfo buildInfo, File tmpDir)` 验证 GKI 启动映像是否符合预期。

公共构造函数

GkiDeviceFlashPreparer

public GkiDeviceFlashPreparer ()

公共方法

设置

public void setUp (TestInformation testInfo)

执行目标设置以进行测试。

参数
`testInfo`	`TestInformation`：调用的 `TestInformation`。

抛出
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

VerifyGkiBootImg

public void validateGkiBootImg (ITestDevice device, 
                IBuildInfo buildInfo)

验证 GKI 启动映像是否符合预期。（已作废。请在致电时提供 tmpDir

参数
`device`	`ITestDevice`：`ITestDevice`
`buildInfo`	`IBuildInfo`：build 信息的 `IBuildInfo`

抛出
`TargetSetupError`	如果没有有效的 gki boot.img

受保护的方法

addHashFooter

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

验证 GKI 启动映像是否符合预期。如果没有有效的 boot.img，则会抛出异常。

参数
`device`	`ITestDevice`：`ITestDevice`
`buildInfo`	`IBuildInfo`：build 信息的 `IBuildInfo`
`tmpDir`	`File`：临时目录 `ERROR(/File)`

抛出
`TargetSetupError`	如果没有有效的 gki boot.img
`DeviceNotAvailableException`

buildGkiSystemDlkmImg

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

如果提供了 system_dlkm 归档，请构建 GKI system_dlkm 映像。

参数
`device`	`ITestDevice`：`ITestDevice`
`buildInfo`	`IBuildInfo`：build 信息的 `IBuildInfo`
`tmpDir`	`File`：临时目录 `ERROR(/File)`

抛出
`TargetSetupError`	如果构建图片文件时出错。

extractSystemDlkmTarGzip

protected File extractSystemDlkmTarGzip (File systemDlkmArchive)

将 system_dlkm tar gzip 文件解压缩到 system_dlkm_staging 文件夹。此函数围绕 ERROR(/TarUtil.extractTarGzipToTemp) 的封装容器，用于对以下对象的解压进行打桩单元测试。

参数
`systemDlkmArchive`	`File`：包含 GKI 模块的 system_dlkm tar gzip 文件。

返回
`File`	包含 system_dlkm tar gzip 内容的文件。

抛出
	IOException

FlattenSystemDlkm

protected void flattenSystemDlkm (ITestDevice device, 
                File systemDlkmStagingDir)

展平 system_dlkm 暂存目录，使所有内核模块都直接位于其下 /lib/modules 中。这是符合平台的预期 system_dlkm 文件布局所必需的 build。

参数
`device`	`ITestDevice`：`ITestDevice`
`systemDlkmStagingDir`	`File`：system_dlkm 暂存目录 `ERROR(/File)`

抛出
	如果展平 system_dlkm 时出错，则为 TargetSetupError。
`TargetSetupError`

getHostOptions

protected IHostOptions getHostOptions ()

获取对 IHostOptions 的引用

返回
`IHostOptions`	要使用的 `IHostOptions`

getRequestedFile

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

按请求的文件名从源文件（zip 或文件夹）中获取请求的文件。

提供的源文件可以是 ZIP 文件。该方法会将其解压缩到临时目录并按提供的文件名查找请求的文件。

提供的源文件可以是文件夹。该方法将通过以下方式查找请求的文件：提供的文件名。

参数
`device`	`ITestDevice`：`ITestDevice`
`requestedFileName`	`String`：请求文件名字符串
`sourceFile`	`File`：源文件
`tmpDir`	`File`

返回
`File`	所请求的文件名指定的文件

抛出
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

getRunUtil

protected IRunUtil getRunUtil ()

获取要使用的 IRunUtil 实例。

返回
`IRunUtil`	要使用的 `IRunUtil`

VerifyGkiBootImg

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

验证 GKI 启动映像是否符合预期。如果没有有效的 boot.img，则会抛出异常。

参数
`device`	`ITestDevice`：`ITestDevice`
`buildInfo`	`IBuildInfo`：build 信息的 `IBuildInfo`
`tmpDir`	`File`：临时目录 `ERROR(/File)`

抛出
`TargetSetupError`	如果没有有效的 gki boot.img