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(Collection<String> 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 ()

パブリック メソッド

フラッシュ

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 (Collection<String> dataWipeSkipList)

ITestsZipInstaller を使用するときにクリアしないように、/data の下のパスのリストを設定します。

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

パラメータ
dataWipeSkipList Collection

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