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