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

default void tearDownFlasher()

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

パブリック メソッド

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

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

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

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