SystemUpdaterDeviceFlasher

public class SystemUpdaterDeviceFlasher
extends Object implements IDeviceFlasher

java.lang.Object
   ↳ com.android.tradefed.targetprep.SystemUpdaterDeviceFlasher


システム アップデータを使用して OTA アップデート パッケージにバンドルされているシステム イメージをインストールする IDeviceFlasher。特に、この実装では fastboot に依存しません。

概要

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

SystemUpdaterDeviceFlasher()

パブリック メソッド

void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

フラッシュはデバイス上でビルドされます。

この実装では、IDeviceBuildInfo#getDeviceImageFile() によって返されたデバイス イメージ ファイルが OTA アップデート ZIP であると想定しています。

CommandStatus getSystemFlashingStatus()

プライマリ システム パーティションのフラッシュのコマンド実行ステータスを取得します。

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

ユーザーデータ イメージのフラッシュ、ワイプ、保持のいずれを行うかを取得します。

void overrideDeviceOptions(ITestDevice device)

デバイスのオプションをオーバーライドします。

void setDataWipeSkipList( dataWipeSkipList)

ITestsZipInstaller の使用時に消去されないように、/data の下にあるパスのリストを設定します。

スキップリストの粒度は /data の直接の子です。

void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

フラッシャーがフラッシュ用のリソース ファイルを取得するメカニズムを設定します。

void setForceSystemFlash(boolean forceSystemFlash)

現在のビルドを実行している場合でも、システムを常にフラッシュするかどうかを設定します。

void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

ユーザーデータ イメージのフラッシュ、ワイプ、保持を切り替えます。

この実装では、有効なオプションとして IDeviceFlasher.UserDataFlashOption#TESTS_ZIPIDeviceFlasher.UserDataFlashOption#RETAIN のみがサポートされています。

void setWipeTimeout(long timeout)

データのワイプ処理のタイムアウトを設定します。

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

SystemUpdaterDeviceFlasher

public SystemUpdaterDeviceFlasher ()

パブリック メソッド

flash

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

デバイスにビルドをフラッシュします。

フラッシュが完了するとすぐに返されます。呼び出し元は、デバイスがオンラインになって利用可能になるまで待ってからテストを開始する必要があります。

この実装では、IDeviceBuildInfo#getDeviceImageFile() から返されるデバイス イメージ ファイルが OTA アップデート zip であることを前提としています。この解釈が成立しないコンテキストでこのアップデータを使用することは安全ではありません。

パラメータ
device ITestDevice: フラッシュする ITestDevice

deviceBuild IDeviceBuildInfo: フラッシュする IDeviceBuildInfo

例外
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

プライマリ システム パーティションのフラッシュのコマンド実行ステータスを取得します。

システム パーティションがフラッシュされていない場合(システムにフラッシュするビルドがすでにある場合)、コマンドのステータスは null になることがあります。

戻り値
CommandStatus

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

ユーザーデータ イメージのフラッシュ、ワイプ、保持のいずれを行うべきかを取得します。

戻り値
IDeviceFlasher.UserDataFlashOption ユーザーデータ イメージのフラッシュ、ワイプ、保持

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

デバイスのオプションをオーバーライドします。デフォルトが特定のデバイスでサポートされていない場合に、デフォルトのオプション値をオーバーライドするために使用します。

setDataWipeSkipList

public void setDataWipeSkipList ( dataWipeSkipList)

ITestsZipInstaller の使用時に消去されないように、/data の下にあるパスのリストを設定します。

スキップリストの粒度は、/data の直接の子です。

パラメータ
dataWipeSkipList

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

フラッシャーがフラッシュ用のリソース ファイルを取得するメカニズムを設定します。

パラメータ
retriever IFlashingResourcesRetriever: 使用する IFlashingResourcesRetriever

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

現在のビルドを実行している場合でも、システムを常にフラッシュするかどうかを設定します。

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

ユーザーデータ イメージを書き込むか、ワイプするか、保持するかを切り替えます。

この実装では、有効なオプションとして IDeviceFlasher.UserDataFlashOption#TESTS_ZIPIDeviceFlasher.UserDataFlashOption#RETAIN のみがサポートされています。

setWipeTimeout

public void setWipeTimeout (long timeout)

データをワイプするためのタイムアウトを設定します。

パラメータ
timeout long