自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

本頁面由 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 ()

公用方法

setUp

public void setUp (TestInformation testInfo)

執行目標設定以進行測試。

參數
`testInfo`	`TestInformation`：呼叫的 `TestInformation`。

擲回
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

validateGkiBootImg

public void validateGkiBootImg (ITestDevice device, 
                IBuildInfo buildInfo)

驗證 GKI 開機映像檔是否符合預期。(已淘汰)。請使用提供的 tmpDir 呼叫

參數
`device`	`ITestDevice`：`ITestDevice`
`buildInfo`	`IBuildInfo`：`IBuildInfo` 的建構資訊

擲回
`TargetSetupError`	如果沒有有效的 gki boot.img

受保護的方法

addHashFooter

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

驗證 GKI 開機映像檔是否符合預期。如果沒有有效的 boot.img，就擲回例外狀況。

參數
`device`	`ITestDevice`：`ITestDevice`
`buildInfo`	`IBuildInfo`：`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`：`IBuildInfo` 的建構資訊
`tmpDir`	`File`：臨時目錄 `ERROR(/File)`

擲回
`TargetSetupError`	建構圖片檔案時發生錯誤。

extractSystemDlkmTarGzip

protected File extractSystemDlkmTarGzip (File systemDlkmArchive)

將 system_dlkm tar gzip 檔案解壓縮至 system_dlkm_staging 資料夾。這個函式是 ERROR(/TarUtil.extractTarGzipToTemp) 的包裝函式，可為單元測試建立 untarring 的虛設項目。

參數
`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 檔案版面配置。

參數
`device`	`ITestDevice`：`ITestDevice`
`systemDlkmStagingDir`	`File`：system_dlkm 暫存目錄 `ERROR(/File)`

擲回
	或 TargetSetupError，如果系統_dlkm 扁平化時發生錯誤。
`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`

validateGkiBootImg

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

驗證 GKI 開機映像檔是否符合預期。如果沒有有效的 boot.img，就擲回例外狀況。

參數
`device`	`ITestDevice`：`ITestDevice`
`buildInfo`	`IBuildInfo`：`IBuildInfo` 的建構資訊
`tmpDir`	`File`：臨時目錄 `ERROR(/File)`

擲回
`TargetSetupError`	如果沒有有效的 gki boot.img