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