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) すべてのカーネル モジュールが /lib/modules の直下に配置されるように、system_dlkm ステージング ディレクトリをフラット化します。
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 フォルダに展開します。この関数は、単体テスト用の untar をスタブ化するために ERROR(/TarUtil.extractTarGzipToTemp) をラップするものです。

パラメータ
systemDlkmArchive	File: GKI モジュールを含む system_dlkm tar gzip ファイル。

戻り値
File	system_dlkm tar gzip の内容を含むファイル。

例外
	IOException

flattenSystemDlkm

protected void flattenSystemDlkm (ITestDevice device, 
                File systemDlkmStagingDir)

すべてのカーネル モジュールが /lib/modules の直下に配置されるように、system_dlkm ステージング ディレクトリをフラット化します。これは、プラットフォーム ビルドの想定される system_dlkm ファイル レイアウトと一致させるために必要です。

パラメータ
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

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 がない場合