IDeviceFlasher

public interface IDeviceFlasher

com.android.tradefed.targetprep.IDeviceFlasher

デバイスにデバイス イメージを書き込みます。

概要

パブリック メソッド

default boolean checkAntiRollback(ITestDevice device, IDeviceBuildInfo deviceBuild)

ロールバック防止がトリガーされたかどうかを確認します。
abstract void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

デバイスにビルドをフラッシュします。
default Set<String> 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(Collection<String> dataWipeSkipList)

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

スキップ リストの粒度は /data の直接の子です。
default void setExtraMetadata(Map<String, String> 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 をフラッシュするようにフラッシャーが設定されているかどうかを確認します。

default boolean supportsFlashingInFastbootD()

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

フラッシャー実装がクリーンアップを行う最後の機会

パブリック メソッド

checkAntiRollback

public boolean checkAntiRollback (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

ロールバック防止がトリガーされたかどうかを確認します。

パラメータ
device ITestDevice

deviceBuild IDeviceBuildInfo

戻り値
boolean

例外
DeviceNotAvailableException

フラッシュ

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

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

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

getAdditionalFileFilters

public Set<String> getAdditionalFileFilters ()

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

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

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

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

デフォルトでは、このメソッドは空の Set を返します。

戻り値
Set<String>

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 を書き込む
例外
DeviceNotAvailableException デバイスが応答しなくなった場合
TargetSetupError いずれかの設定が失敗した場合

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

実際のフラッシュ処理の重要なセクションの前に実行する必要があるすべてのセットアップ オペレーションとチェック。これらのオペレーションは、同時実行制御されたクリティカル セクションには含まれません。

パラメータ
device ITestDevice: ITestDevice を書き込む
deviceBuild IDeviceBuildInfo: IDeviceBuildInfo を書き込む
例外
DeviceNotAvailableException デバイスが応答しなくなった場合
TargetSetupError いずれかの設定が失敗した場合

setDataWipeSkipList

public abstract void setDataWipeSkipList (Collection<String> dataWipeSkipList)

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

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

パラメータ
dataWipeSkipList Collection

setExtraMetadata

public void setExtraMetadata (Map<String, String> metadata)

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

パラメータ
metadata Map

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 をフラッシャーが設定しているかどうかを確認します

戻り値
boolean

supportsFlashingInFastbootD

public boolean supportsFlashingInFastbootD ()

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

戻り値
boolean

tearDownFlasher

public void tearDownFlasher ()

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