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 の直接の子です。
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 モードでフラッシュできるかどうか。

パブリック メソッド

flash

public abstract void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

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

フラッシュが完了するとすぐに返されます。呼び出し元は、デバイスがオンラインになって利用可能になるまで待ってからテストを続行する必要があります。

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

getAdditionalFileFilters

public  getAdditionalFileFilters ()

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

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

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

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

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

戻り値

getSystemFlashingStatus

public abstract CommandStatus getSystemFlashingStatus ()

プライマリ システム パーティションをフラッシュするためのコマンド実行ステータスを取得します。

system パーティションがフラッシュされていない場合（フラッシュするビルドがすでにシステムにある）場合は、コマンド ステータスが 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 ディスク パーティションの設定

setNeedFlashRamdisk

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