IDeviceFlasher
public
interface
IDeviceFlasher
com.android.tradefed.targetprep.IDeviceFlasher |
デバイスにデバイス イメージを書き込みます。
概要
パブリック メソッド | |
---|---|
abstract
void
|
flash(ITestDevice device, IDeviceBuildInfo deviceBuild)
デバイスにビルドをフラッシュします。 |
default
|
getAdditionalFileFilters()
追加のビルド アーティファクトのフィルタを取得します。 |
abstract
CommandStatus
|
getSystemFlashingStatus()
プライマリ システム パーティションのフラッシュのコマンド実行ステータスを取得します。 |
abstract
IDeviceFlasher.UserDataFlashOption
|
getUserDataFlashOption()
ユーザーデータ イメージをフラッシュ、ワイプ、保持するかどうかを取得します。 |
abstract
void
|
overrideDeviceOptions(ITestDevice device)
デバイスのオプションをオーバーライドします。 |
default
void
|
postFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)
実際のフラッシュの重要なセクションの後に実行する必要があるすべてのクリーンアップ オペレーションとチェック。 |
default
void
|
preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)
実際のフラッシュの重要なセクションの前に行う必要があるすべての設定オペレーションとチェック。 |
abstract
void
|
setDataWipeSkipList(
スキップリストの粒度は |
abstract
void
|
setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)
フラッシャーがフラッシュ用のリソース ファイルを取得するメカニズムを設定します。 |
abstract
void
|
setForceSystemFlash(boolean forceSystemFlash)
現在のビルドを実行している場合でも、システムを常にフラッシュするかどうかを設定します。 |
default
void
|
setRamdiskPartition(String ramdiskPartition)
RAM ディスク パーティションを設定します。 |
default
void
|
setShouldFlashRamdisk(boolean shouldFlashRamdisk)
イメージ ZIP を使用してデバイスを更新した後に、追加の RAM ディスクをフラッシュするかどうかを設定します。 |
abstract
void
|
setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)
ユーザーデータ イメージのフラッシュ、ワイプ、保持を切り替えます。 |
abstract
void
|
setWipeTimeout(long timeout)
データのワイプ処理のタイムアウトを設定します。 |
default
boolean
|
shouldFlashRamdisk()
イメージ ZIP を介してデバイスを更新した後に、フラッシャーが追加の RAM ディスクをフラッシュするように設定されているかどうかを確認します。 |
default
boolean
|
supportsFlashingInFastbootD()
フラッシャーを実装しているデバイスを fastbootd モードでフラッシュできるかどうか。 |
default
void
|
tearDownFlasher()
フラッシャー実装が自分自身をクリーンアップする最後の機会 |
パブリック メソッド
flash
public abstract void flash (ITestDevice device, IDeviceBuildInfo deviceBuild)
デバイスにビルドをフラッシュします。
フラッシュ完了後すぐに返されます。呼び出し元は、デバイスがオンラインになって利用可能になるまで待ってからテストを続行する必要があります。
パラメータ | |
---|---|
device |
ITestDevice : フラッシュする ITestDevice |
deviceBuild |
IDeviceBuildInfo : フラッシュする IDeviceBuildInfo |
例外 | |
---|---|
TargetSetupError |
ビルドのフラッシュに失敗した場合 |
DeviceNotAvailableException |
デバイスが応答しなくなった場合 |
getAdditionalFileFilters
publicgetAdditionalFileFilters ()
追加のビルド アーティファクトのフィルタを取得します。
一部のフラッシュツールでは、デフォルトで使用されるアーティファクト以外の特定のビルド アーティファクトが必要になります。このようなフラッシャーは、このメソッドをオーバーライドする必要があります。これにより、フラッシング ツールのすべてのユーザーがこれらのファイルについて理解し、コマンドライン オプションを指定する必要がなくなります。
このメソッドは IDeviceFlasher の一時インスタンスで呼び出されるため、デフォルト コンストラクタで提供される状態以外は信頼しないでください。
セット内の文字列はファイルパターンとして解釈され、パターンに一致するすべてのファイルが取得されます。
デフォルトでは、このメソッドは空の Set を返します。
戻り値 | |
---|---|
|
getSystemFlashingStatus
public abstract CommandStatus getSystemFlashingStatus ()
プライマリ システム パーティションのフラッシュのコマンド実行ステータスを取得します。
システム パーティションがフラッシュされていない場合(システムにフラッシュするビルドがすでにある場合)、コマンドのステータスは null
になることがあります。
戻り値 | |
---|---|
CommandStatus |
getUserDataFlashOption
public abstract IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()
ユーザーデータ イメージのフラッシュ、ワイプ、保持のいずれを行うべきかを取得します。
戻り値 | |
---|---|
IDeviceFlasher.UserDataFlashOption |
ユーザーデータ イメージのフラッシュ、ワイプ、保持 |
overrideDeviceOptions
public abstract void overrideDeviceOptions (ITestDevice device)
デバイスのオプションをオーバーライドします。デフォルトが特定のデバイスでサポートされていない場合に、デフォルトのオプション値をオーバーライドするために使用します。
postFlashOperations
public void postFlashOperations (ITestDevice device, IDeviceBuildInfo deviceBuild)
実際のフラッシュの重要なセクションの後に実行する必要があるすべてのクリーンアップ オペレーションとチェック。これらのオペレーションはいずれも、同時実行制御のクリチカル セクションには含まれません。
パラメータ | |
---|---|
device |
ITestDevice : フラッシュする ITestDevice |
deviceBuild |
IDeviceBuildInfo : フラッシュする IDeviceBuildInfo |
例外 | |
---|---|
TargetSetupError |
設定に失敗した場合 |
DeviceNotAvailableException |
デバイスが応答しなくなった場合 |
preFlashOperations
public void preFlashOperations (ITestDevice device, IDeviceBuildInfo deviceBuild)
実際のフラッシュの重要なセクションの前に行う必要があるすべての設定オペレーションとチェック。これらのオペレーションはいずれも、同時実行制御のクリチカル セクションには含まれません。
パラメータ | |
---|---|
device |
ITestDevice : フラッシュする ITestDevice |
deviceBuild |
IDeviceBuildInfo : フラッシュする IDeviceBuildInfo |
例外 | |
---|---|
TargetSetupError |
設定に失敗した場合 |
DeviceNotAvailableException |
デバイスが応答しなくなった場合 |
setDataWipeSkipList
public abstract void setDataWipeSkipList (dataWipeSkipList)
ITestsZipInstaller
の使用時にクリアされないように、/data
の下にパスのリストを設定します。
スキップリストの粒度は /data
の直接の子です。
パラメータ | |
---|---|
dataWipeSkipList |
|
setFlashingResourcesRetriever
public abstract void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)
フラッシャーがフラッシュ用のリソース ファイルを取得するメカニズムを設定します。
パラメータ | |
---|---|
retriever |
IFlashingResourcesRetriever : 使用する IFlashingResourcesRetriever |
setForceSystemFlash
public abstract void setForceSystemFlash (boolean forceSystemFlash)
現在のビルドを実行している場合でも、システムを常にフラッシュするかどうかを設定します。
setRamdiskPartition
public void setRamdiskPartition (String ramdiskPartition)
RAM ディスク パーティションを設定する
setShouldFlashRamdisk
public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)
イメージ ZIP を使用してデバイスを更新した後に追加の RAM ディスクをフラッシュするかどうかを設定します。
setUserDataFlashOption
public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)
ユーザーデータ イメージのフラッシュ、ワイプ、保持を切り替える
setWipeTimeout
public abstract void setWipeTimeout (long timeout)
データのワイプ処理のタイムアウトを設定します。
パラメータ | |
---|---|
timeout |
long |
shouldFlashRamdisk
public boolean shouldFlashRamdisk ()
イメージ ZIP を介してデバイスを更新した後に、追加の RAM ディスクがフラッシュされるようにフラッシャーが設定されているかどうかを確認します。
戻り値 | |
---|---|
boolean |
supportsFlashingInFastbootD
public boolean supportsFlashingInFastbootD ()
フラッシャーを実装しているデバイスを fastbootd モードでフラッシュできるかどうか。
戻り値 | |
---|---|
boolean |
tearDownFlasher
public void tearDownFlasher ()
フラッシャー実装が自分自身をクリーンアップする最後の機会