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 ステージング ディレクトリをフラット化します。
String[] getDeviceKernelVersion(ITestDevice device)

フラッシュする前にデバイスからデバイス カーネル バージョンを取得します。
IHostOptions getHostOptions()

IHostOptions への参照を取得する

String[] getKernelVersionFromImage(File image)

boot、vendor_boot、system_dlkm、vendor_dlkm のイメージ ファイルからカーネル バージョンを抽出します。
File getRequestedFile(ITestDevice device, String requestedFileName, File sourceFile, File tmpDir)

リクエストされたファイル名で、リクエストされたファイルをソースファイル（zip またはフォルダ）から取得します。
IRunUtil getRunUtil()

使用する IRunUtil インスタンスを取得します。
String[] parseKernelVersion(String source, String kernelVersionString)
void validateGkiBootImg(ITestDevice device, IBuildInfo buildInfo, File tmpDir)

GKI ブートイメージが想定どおりであることを検証します。
void validateKernelCompatibility(String imageName, String[] imageVersion, String[] bootVersion, ITestDevice device)
void validateKernelVersion(ITestDevice device, IBuildInfo buildInfo, File tmpDir)

イメージ内のカーネル バージョンが想定どおりであることを検証します。

パブリック コンストラクタ

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: 一時ディレクトリ 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: 一時ディレクトリ File
例外
TargetSetupError イメージ ファイルのビルド中にエラーが発生した場合。

extractSystemDlkmTarGzip

protected File extractSystemDlkmTarGzip (File systemDlkmArchive)

system_dlkm tar gzip ファイルを system_dlkm_staging フォルダに抽出します。この関数は、単体テスト用に untarring をスタブアウトするために ERROR(/TarUtil.extractTarGzipToTemp) のラッパーです。

パラメータ
systemDlkmArchive File: GKI モジュールを含む system_dlkm tar gzip ファイル。
戻り値
File system_dlkm tar gzip の内容を含むファイル。
例外
java.io.IOException
IOException

flattenSystemDlkm

protected void flattenSystemDlkm (ITestDevice device, 
                File systemDlkmStagingDir)

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

パラメータ
device ITestDevice: ITestDevice
systemDlkmStagingDir File: system_dlkm ステージング ディレクトリ File
例外
IOException システム dlkm のフラット化でエラーが発生した場合は TargetSetupError。
TargetSetupError

getDeviceKernelVersion

protected String[] getDeviceKernelVersion (ITestDevice device)

フラッシュする前にデバイスからデバイス カーネル バージョンを取得します。

パラメータ
device ITestDevice: カーネル バージョンを取得する ITestDevice。
戻り値
String[] 解析されたカーネル バージョン情報（[kernelVersion, patchLevel, pageSize]）を含む ERROR(/String[])。バージョン文字列を解析できない場合は null を返します。2
例外
DeviceNotAvailableException

getHostOptions

protected IHostOptions getHostOptions ()

IHostOptions への参照を取得する

戻り値
IHostOptions 使用する IHostOptions

getKernelVersionFromImage

protected String[] getKernelVersionFromImage (File image)

boot/vendor_boot/system_dlkm/vendor_dlkm イメージ ファイルからカーネル バージョンを抽出します。このメソッドは、boot/vendor_boot/system_dlkm/vendor_dlkm イメージ ファイルを読み取り、Android カーネル バージョン文字列内の特定のパターンを検索します。次に、検出された文字列を解析して、標準化された形式でカーネル バージョンを抽出します。

パラメータ
image File: ブート イメージ ファイル（boot.img など）への File。
戻り値
String[] 解析されたカーネル バージョン情報（[kernelVersion, patchLevel, pageSize]）を含む ERROR(/String[])。バージョン文字列を解析できない場合は null を返します。

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

parseKernelVersion

protected String[] parseKernelVersion (String source, 
                String kernelVersionString)

パラメータ
source String

kernelVersionString String

戻り値
String[]

validateGkiBootImg

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

GKI ブートイメージが想定どおりであることを検証します。有効な boot.img がない場合は例外をスローします。

パラメータ
device ITestDevice: ITestDevice
buildInfo IBuildInfo: IBuildInfo ビルド情報
tmpDir File: 一時ディレクトリ File
例外
TargetSetupError 有効な gki boot.img がない場合

validateKernelCompatibility

protected void validateKernelCompatibility (String imageName, 
                String[] imageVersion, 
                String[] bootVersion, 
                ITestDevice device)

パラメータ
imageName String

imageVersion String

bootVersion String

device ITestDevice

例外
TargetSetupError

validateKernelVersion

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

イメージ内のカーネル バージョンが想定どおりであることを検証します。有効でない場合は例外をスローします。

パラメータ
device ITestDevice: ITestDevice
buildInfo IBuildInfo: IBuildInfo ビルド情報
tmpDir File: 一時ディレクトリ File
例外
TargetSetupError 有効な gki boot.img がない場合
DeviceNotAvailableException