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)
フラッシュはデバイス上でビルドされます。
この実装では、 |
CommandStatus
|
getSystemFlashingStatus()
プライマリ システム パーティションのフラッシュのコマンド実行ステータスを取得します。 |
IDeviceFlasher.UserDataFlashOption
|
getUserDataFlashOption()
ユーザーデータ イメージのフラッシュ、ワイプ、保持のいずれを行うかを取得します。 |
void
|
overrideDeviceOptions(ITestDevice device)
デバイスのオプションをオーバーライドします。 |
void
|
setDataWipeSkipList(
スキップリストの粒度は |
void
|
setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)
フラッシャーがフラッシュ用のリソース ファイルを取得するメカニズムを設定します。 |
void
|
setForceSystemFlash(boolean forceSystemFlash)
現在のビルドを実行している場合でも、システムを常にフラッシュするかどうかを設定します。 |
void
|
setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)
ユーザーデータ イメージのフラッシュ、ワイプ、保持を切り替えます。
この実装では、有効なオプションとして |
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_ZIP
と IDeviceFlasher.UserDataFlashOption#RETAIN
のみがサポートされています。
setWipeTimeout
public void setWipeTimeout (long timeout)
データをワイプするためのタイムアウトを設定します。
パラメータ | |
---|---|
timeout |
long |