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

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

スキップ リストの粒度は /data の直接の子です。
default void setExtraMetadata( metadata)

フラッシャーが追加のメタデータ オプションを受け取れるようにします。
abstract void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

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

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

RAM ディスク パーティションを設定します。

default void setShouldFlashRamdisk(boolean shouldFlashRamdisk)

イメージ zip を介してデバイスを更新した後に、追加の ramdisk をフラッシュするかどうかを設定します。
abstract void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

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

abstract void setWipeTimeout(long timeout)

データを消去するタイムアウトを設定します。
default boolean shouldFlashRamdisk()

イメージ zip を介してデバイスを更新した後に、追加の ramdisk をフラッシュするように flasher が設定されているかどうかを確認します。

default boolean supportsFlashingInFastbootD()

フラッシャーを実装するデバイスを fastbootd モードでフラッシュできるかどうか。
default void tearDownFlasher()

フラッシャー実装が自身をクリーンアップする最後の機会

パブリック メソッド

フラッシュ

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

フラッシュが完了するとすぐに戻ります。呼び出し元は、テストに進む前にデバイスがオンラインになり、利用可能になるまで待つ必要があります。

パラメータ
device ITestDevice: フラッシュする ITestDevice
deviceBuild IDeviceBuildInfo: フラッシュする IDeviceBuildInfo
例外
TargetSetupError ビルドのフラッシュに失敗した場合
DeviceNotAvailableException デバイスが応答しなくなった場合

getAdditionalFileFilters

public  getAdditionalFileFilters ()

追加のビルド アーティファクトのフィルタを取得します。

一部のフラッシャーでは、デフォルトで使用されるビルド アーティファクトに含まれない特定のビルド アーティファクトが必要です。このようなフラッシャーはこのメソッドをオーバーライドする必要があります。これにより、フラッシュ ツールを使用するすべてのユーザーがこれらのファイルについて知る必要がなくなり、コマンドライン オプションを指定する必要もなくなります。

このメソッドは IDeviceFlasher の一時インスタンスで呼び出されるため、デフォルトのコンストラクタで提供される状態以外は信頼しないでください。

Set 内の文字列はファイル パターンとして解釈され、パターンに一致するすべてのファイルが取得されます。

デフォルトでは、このメソッドは空の 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

setExtraMetadata

public void setExtraMetadata ( metadata)

フラッシャーが追加のメタデータ オプションを受け取れるようにします。

パラメータ
metadata

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 を介してデバイスを更新した後に、追加の ramdisk をフラッシュするかどうかを設定します

setUserDataFlashOption

public abstract void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

setWipeTimeout

public abstract void setWipeTimeout (long timeout)

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

パラメータ
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

イメージ zip を介してデバイスを更新した後に、追加の ramdisk をフラッシュするように flasher が設定されているかどうかを確認します

戻り値
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

フラッシャーを実装するデバイスを fastbootd モードでフラッシュできるかどうか。

戻り値
boolean

tearDownFlasher

public void tearDownFlasher ()

フラッシャー実装が自身をクリーンアップする最後の機会