Google は、黒人コミュニティに対する人種平等の促進に取り組んでいます。取り組みを見る
このページは Cloud Translation API によって翻訳されました。
Switch to English

FastbootDeviceFlasher

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

java.lang.Object
com.android.tradefed.targetprep.FastbootDeviceFlasher


物理的なAndroidハードウェアでイメージをフラッシュするためにfastbootに依存するクラス。

概要

田畑

public static final String BASEBAND_IMAGE_NAME

パブリックコンストラクター

FastbootDeviceFlasher ()

パブリックメソッド

void flash (ITestDevice device, IDeviceBuildInfo deviceBuild)

フラッシュはデバイス上に構築されます。

CommandStatus getSystemFlashingStatus ()

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

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

ユーザーデータイメージをフラッシュするか、ワイプするか、保持するかを取得します

void overrideDeviceOptions (ITestDevice device)

デバイスのオプションを上書きします。

void setDataWipeSkipList ( dataWipeSkipList) setDataWipeSkipList ( dataWipeSkipList)

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

スキップリストの粒度は/data直接の子であることに注意してください。

void setFlashOptions ( flashOptions) setFlashOptions ( flashOptions)

flash / updateコマンドで渡すオプションのリストを設定します。

void setFlashingResourcesRetriever ( IFlashingResourcesRetriever retriever)

フラッシャーがフラッシュ用のリソースファイルを取得できるメカニズムを設定します。

void setForceSystemFlash (boolean forceSystemFlash)

現在のビルドを実行している場合でも、システムを常にフラッシュする必要があるかどうかを設定します

void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

イメージzipを介してデバイスを更新した後、追加のramdiskをフラッシュする必要があるかどうかを設定します

void setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)

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

void setWipeTimeout (long timeout)

データを消去するためのタイムアウトを設定します。

boolean shouldFlashRamdisk ()

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

保護された方法

void checkAndFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)

必要に応じて、デバイスのベースバンドイメージをフラッシュします。

boolean checkAndFlashBootloader (ITestDevice device, IDeviceBuildInfo deviceBuild)

必要に応じて、デバイスのブートローダーイメージをフラッシュします。

boolean checkAndFlashSystem (ITestDevice device, String systemBuildId, String systemBuildFlavor, IDeviceBuildInfo deviceBuild)

必要に応じて、デバイスのシステムイメージをフラッシュします。

boolean checkShouldFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)

提供されたデバイスのベースバンドをフラッシュする必要があるかどうかを確認します。

IFlashingResourcesParser createFlashingResourcesParser ( IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)

IFlashingResourcesParserを作成するためのファクトリメソッド。

void downloadExtraImageFiles ( IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild)

必要に応じて、サブクラスが追加のカスタム画像ファイルをダウンロードできるようにするためのフック。

void downloadFlashingResources (ITestDevice device, IDeviceBuildInfo localBuild)

必要な追加の点滅画像ファイルをダウンロードします

String executeFastbootCmd (ITestDevice device, String... cmdArgs)

fastbootコマンドを実行するためのヘルパーメソッド。

String executeLongFastbootCmd (ITestDevice device, String... cmdArgs)

長時間実行されるfastbootコマンドを実行するためのヘルパーメソッド。

void flashBaseband (ITestDevice device, File basebandImageFile)

指定されたベースバンドイメージをフラッシュし、ブートローダーで再起動します

void flashBootloader (ITestDevice device, File bootloaderImageFile)

指定されたブートローダーイメージをフラッシュし、再起動してブートローダーに戻ります

void flashExtraImages (ITestDevice device, IDeviceBuildInfo deviceBuild)

システムをフラッシュして再起動する前に、デバイス固有のパーティションをフラッシュしてください。

void flashPartition (ITestDevice device, File imgFile, String partition)

デバイスの個々のパーティションをフラッシュする

void flashRamdiskIfNeeded (ITestDevice device, IDeviceBuildInfo deviceBuild)
void flashSystem (ITestDevice device, IDeviceBuildInfo deviceBuild)

デバイス上のシステムイメージをフラッシュします。

void flashUserData (ITestDevice device, IDeviceBuildInfo deviceBuild)

デバイス上のフラッシュユーザーデータパーティション。

void flashUserDataFromDeviceImageFile (ITestDevice device, IDeviceBuildInfo deviceBuild)

デバイスイメージファイルからuserdata.imgを抽出し、デバイスにフラッシュします

String getBootPartitionName ()

このデバイスフラッシャーのブートパーティション名を取得します。

String getBootloaderFilePrefix (ITestDevice device)

ブートローダーファイルのプレフィックスを取得します。

String getCurrentSlot (ITestDevice device)

現在のスロットを取得するためのヘルパーメソッド(A / B対応デバイスの場合)。

IFlashingResourcesRetriever getFlashingResourcesRetriever ()
String getImageVersion (ITestDevice device, String imageName)

デバイス上の現在の画像バージョンを取得するためのヘルパーメソッド。

IRunUtil getRunUtil ()

テスト用に公開。

void handleUserDataFlashing (ITestDevice device, IDeviceBuildInfo deviceBuild)

ユーザーデータ/キャッシュパーティションのフラッシュを処理します

boolean hasPartition (ITestDevice device, String partition)

指定されたパーティションが存在するかどうかをブートローダーに確認します

void preFlashSetup (ITestDevice device, IDeviceBuildInfo deviceBuild)

必要な追加のプリフラッシュ設定を実行します。

void verifyRequiredBoards (ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType)

デバイスの製品タイプがフラッシュされるビルドをサポートしていることを確認します。

void wipeCache (ITestDevice device)

デバイスのキャッシュパーティションをワイプします。

void wipePartition (ITestDevice device, String partition)

「fastbooterase <name>」で指定したパーティションを消去します

田畑

BASEBAND_IMAGE_NAME

public static final String BASEBAND_IMAGE_NAME

パブリックコンストラクター

FastbootDeviceFlasher

public FastbootDeviceFlasher ()

パブリックメソッド

閃光

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

フラッシュはデバイス上に構築されます。

点滅が完了した直後に戻ります。発信者は、テストを続行する前に、デバイスがオンラインで使用可能になるのを待つ必要があります。

パラメーター
device ITestDevice :フラッシュするITestDevice

deviceBuild IDeviceBuildInfo :フラッシュするIDeviceBuildInfo

投げる
DeviceNotAvailableException
TargetSetupError

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

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

システムパーティションがフラッシュされていない場合(システムにフラッシュされるビルドがすでにある場合)、コマンドステータスがnullなる可能性があることに注意してください

戻り値
CommandStatus

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

ユーザーデータイメージをフラッシュ、ワイプ、または保持する必要があるかどうかを取得します

戻り値
IDeviceFlasher.UserDataFlashOptionユーザーデータイメージをフラッシュ、ワイプ、または保持する必要があるかどうか

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

デバイスのオプションを上書きします。デフォルトが特定のデバイスでサポートされていない場合に、デフォルトのオプション値を上書きするために使用されます。

setDataWipeSkipList

public void setDataWipeSkipList ( dataWipeSkipList)

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

スキップリストの粒度は/data直接の子であることに注意してください。

パラメーター
dataWipeSkipList

setFlashOptions

public void setFlashOptions ( flashOptions)

flash / updateコマンドで渡すオプションのリストを設定します。

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

フラッシャーがフラッシュ用のリソースファイルを取得できるメカニズムを設定します。

パラメーター
retriever IFlashingResourcesRetriever :使用するIFlashingResourcesRetriever

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

現在のビルドを実行している場合でも、システムを常にフラッシュする必要があるかどうかを設定します

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

イメージzipを介してデバイスを更新した後、追加のramdiskをフラッシュする必要があるかどうかを設定します

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

setWipeTimeout

public void setWipeTimeout (long timeout)

データを消去するためのタイムアウトを設定します。

パラメーター
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

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

戻り値
boolean

保護された方法

checkAndFlashBaseband

protected void checkAndFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

必要に応じて、デバイスのベースバンドイメージをフラッシュします。デバイスの現在のバージョン!=必要なバージョンの場合にのみベースバンドをフラッシュします

パラメーター
device ITestDevice :フラッシュするITestDevice

deviceBuild IDeviceBuildInfo :フラッシュするベースバンドイメージを含むIDeviceBuildInfo

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupErrorベースバンドのフラッシュに失敗した場合

checkAndFlashBootloader

protected boolean checkAndFlashBootloader (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

必要に応じて、デバイスのブートローダーイメージをフラッシュします。

デバイスの現在のバージョン!=必要なバージョンの場合にのみブートローダーをフラッシュします。

パラメーター
device ITestDevice :フラッシュするITestDevice

deviceBuild IDeviceBuildInfo :フラッシュするブートローダーイメージを含むIDeviceBuildInfo

戻り値
booleanブートローダーがフラッシュされた場合はtrue 、スキップされた場合はfalse

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupErrorブートローダーのフラッシュに失敗した場合

checkAndFlashSystem

protected boolean checkAndFlashSystem (ITestDevice device, 
                String systemBuildId, 
                String systemBuildFlavor, 
                IDeviceBuildInfo deviceBuild)

必要に応じて、デバイスのシステムイメージをフラッシュします。

ERROR(/#shouldFlashSystem(String,String,com.android.tradefed.build.IDeviceBuildInfo))ご覧ください。

選択したパスに関係なく、メソッド実行後、デバイスはユーザースペースで起動する必要があります。

パラメーター
device ITestDevice :フラッシュするITestDevice

systemBuildId String :デバイスで実行されている現在のビルドID

systemBuildFlavor String :デバイスで実行されている現在のビルドフレーバー

deviceBuild IDeviceBuildInfo :フラッシュするシステムイメージを含むIDeviceBuildInfo

戻り値
booleanシステムがフラッシュされた場合はtrue 、スキップされた場合はfalse

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupErrorブートローダーのフラッシュに失敗した場合

checkShouldFlashBaseband

protected boolean checkShouldFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

提供されたデバイスのベースバンドをフラッシュする必要があるかどうかを確認します。

パラメーター
device ITestDevice :チェックするITestDevice

deviceBuild IDeviceBuildInfo :チェックするベースバンドイメージを含むIDeviceBuildInfo

戻り値
boolean

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupErrorベースバンドのフラッシュに失敗した場合

createFlashingResourcesParser

protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, 
                DeviceDescriptor descriptor)

IFlashingResourcesParserを作成するためのファクトリメソッド。

ユニットテスト用に公開。

パラメーター
localBuild IDeviceBuildInfo :解析するIDeviceBuildInfo

descriptor DeviceDescriptor :フラッシュされるデバイスの記述子。

戻り値
IFlashingResourcesParserファクトリメソッドによって作成されたIFlashingResourcesParser

投げる
TargetSetupError

downloadExtraImageFiles

protected void downloadExtraImageFiles (IFlashingResourcesParser resourceParser, 
                IFlashingResourcesRetriever retriever, 
                IDeviceBuildInfo localBuild)

必要に応じて、サブクラスが追加のカスタム画像ファイルをダウンロードできるようにするためのフック。

パラメーター
resourceParser IFlashingResourcesParserIFlashingResourcesParser

retriever IFlashingResourcesRetrieverIFlashingResourcesRetriever

localBuild IDeviceBuildInfoIDeviceBuildInfo

投げる
TargetSetupError

downloadFlashingResources

protected void downloadFlashingResources (ITestDevice device, 
                IDeviceBuildInfo localBuild)

必要な追加の点滅画像ファイルをダウンロードします

パラメーター
device ITestDevice :リソースをダウンロードするためのITestDevice

localBuild IDeviceBuildInfo :入力するIDeviceBuildInfo 。デバイスイメージファイルがすでに設定されていることを前提としています

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupErrorリソースの取得に失敗した場合

executeFastbootCmd

protected String executeFastbootCmd (ITestDevice device, 
                String... cmdArgs)

fastbootコマンドを実行するためのヘルパーメソッド。

パラメーター
device ITestDevice :コマンドを実行するITestDevice

cmdArgs String :fastbootに提供する引数

戻り値
String空でない場合は、コマンドからのstderr出力を文字列化します。それ以外の場合はstdoutを返します一部のfastbootコマンドは、成功した場合に出力をstderrにダンプするという点で奇妙です

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupError fastbootコマンドが失敗した場合

executeLongFastbootCmd

protected String executeLongFastbootCmd (ITestDevice device, 
                String... cmdArgs)

長時間実行されるfastbootコマンドを実行するためのヘルパーメソッド。

注:ほとんどのfastbootコマンドは、通常、 ITestDevice#executeFastbootCommand(String...)許可されているタイムアウト内に実行されます。ただし、複数のデバイスが同時にデバイスをフラッシュしている場合、fastbootコマンドは通常よりもはるかに長くかかる可能性があります。

パラメーター
device ITestDevice :コマンドを実行するITestDevice

cmdArgs String :fastbootに提供する引数

戻り値
String空でない場合は、コマンドからのstderr出力を文字列化します。それ以外の場合はstdoutを返します一部のfastbootコマンドは、成功した場合に出力をstderrにダンプするという点で奇妙です

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupError fastbootコマンドが失敗した場合

flashBaseband

protected void flashBaseband (ITestDevice device, 
                File basebandImageFile)

指定されたベースバンドイメージをフラッシュし、ブートローダーで再起動します

パラメーター
device ITestDevice :フラッシュするITestDevice

basebandImageFile File :ベースバンドイメージERROR(/File)

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupErrorベースバンドのフラッシュに失敗した場合

flashBootloader

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile)

指定されたブートローダーイメージをフラッシュし、再起動してブートローダーに戻ります

パラメーター
device ITestDevice :フラッシュするITestDevice

bootloaderImageFile File :ブートローダーイメージERROR(/File)

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupErrorフラッシュに失敗した場合

flashExtraImages

protected void flashExtraImages (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

システムをフラッシュして再起動する前に、デバイス固有のパーティションをフラッシュしてください。オーバーライドされない限り、操作はできません。

パラメーター
device ITestDevice :フラッシュするITestDevice

deviceBuild IDeviceBuildInfo :ビルドファイルを含むIDeviceBuildInfo

投げる
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

flashPartition

protected void flashPartition (ITestDevice device, 
                File imgFile, 
                String partition)

デバイスの個々のパーティションをフラッシュする

パラメーター
device ITestDevice :フラッシュするITestDevice

imgFile File :フラッシュする画像を指すERROR(/File)

partition String :フラッシュするパーティションの名前

投げる
DeviceNotAvailableException
TargetSetupError

flashRamdiskIfNeeded

protected void flashRamdiskIfNeeded (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

パラメーター
device ITestDevice

deviceBuild IDeviceBuildInfo

スロー
DeviceNotAvailableException
TargetSetupError

flashSystem

protected void flashSystem (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

デバイスのシステムイメージをフラッシュします。

パラメーター
device ITestDevice :フラッシュするITestDevice

deviceBuild IDeviceBuildInfo :フラッシュするIDeviceBuildInfo

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupError fastbootコマンドが失敗した場合

flashUserData

protected void flashUserData (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

デバイス上のフラッシュuserdataパーティション。

パラメーター
device ITestDevice :フラッシュするITestDevice

deviceBuild IDeviceBuildInfo :フラッシュするファイルを含むIDeviceBuildInfo

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupErrorユーザーデータのフラッシュに失敗した場合

flashUserDataFromDeviceImageFile

protected void flashUserDataFromDeviceImageFile (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

デバイスイメージファイルからuserdata.imgを抽出し、デバイスにフラッシュします

パラメーター
device ITestDevice :フラッシュするITestDevice

deviceBuild IDeviceBuildInfo :フラッシュするファイルを含むIDeviceBuildInfo

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupErrorユーザーデータの抽出またはフラッシュに失敗した場合

getBootPartitionName

protected String getBootPartitionName ()

このデバイスフラッシャーのブートパーティション名を取得します。

デフォルトは「bootloader」です。サブクラスは、必要に応じてオーバーライドする必要があります。

戻り値
String

getBootloaderFilePrefix

protected String getBootloaderFilePrefix (ITestDevice device)

ブートローダーファイルのプレフィックスを取得します。

デフォルトはgetBootPartitionName()です。サブクラスは、必要に応じてオーバーライドする必要があります。

パラメーター
device ITestDevice :フラッシュするITestDevice

戻り値
String

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupErrorプレフィックスの取得に失敗した場合

getCurrentSlot

protected String getCurrentSlot (ITestDevice device)

現在のスロットを取得するためのヘルパーメソッド(A / B対応デバイスの場合)。

パラメーター
device ITestDevice :コマンドを実行するITestDevice

戻り値
String 「a」、「b」、またはnull(デバイスがA / B対応でない場合)

投げる
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

getFlashingResourcesRetriever

protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()

戻り値
IFlashingResourcesRetriever

getImageVersion

protected String getImageVersion (ITestDevice device, 
                String imageName)

デバイス上の現在の画像バージョンを取得するためのヘルパーメソッド。

パラメーター
device ITestDevice :コマンドを実行するITestDevice

imageName String :取得する画像の名前。

戻り値
Stringコマンドからのstdout出力を文字列化する

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupError fastbootコマンドが失敗した場合、またはバージョンを判別できなかった場合

getRunUtil

protected IRunUtil getRunUtil ()

テスト用に公開。

戻り値
IRunUtil

handleUserDataFlashing

protected void handleUserDataFlashing (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

ユーザーデータ/キャッシュパーティションのフラッシュを処理します

パラメーター
device ITestDevice :フラッシュするITestDevice

deviceBuild IDeviceBuildInfo :フラッシュするファイルを含むIDeviceBuildInfo

投げる
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

hasPartition

protected boolean hasPartition (ITestDevice device, 
                String partition)

指定されたパーティションが存在するかどうかをブートローダーに確認します

パラメーター
device ITestDevice :操作するITestDevice

partition String :チェックするパーティションの名前

戻り値
boolean

投げる
DeviceNotAvailableException

preFlashSetup

protected void preFlashSetup (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

必要な追加のプリフラッシュ設定を実行します。オーバーライドされない限り、操作はできません。

パラメーター
device ITestDevice :準備するITestDevice

deviceBuild IDeviceBuildInfo :ビルドファイルを含むIDeviceBuildInfo

投げる
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

verifyRequiredBoards

protected void verifyRequiredBoards (ITestDevice device, 
                IFlashingResourcesParser resourceParser, 
                String deviceProductType)

デバイスの製品タイプがフラッシュされるビルドをサポートしていることを確認します。

基本実装は、deviceProductTypeがIFlashingResourcesParser#getRequiredBoards()コレクションに含まれていることを確認します。サブクラスは、必要に応じてオーバーライドできます。

パラメーター
device ITestDevice :フラッシュされるITestDevice

resourceParser IFlashingResourcesParserIFlashingResourcesParser

deviceProductType Stringdeviceの製品タイプ

投げる
TargetSetupErrorビルドに必要なボード情報がデバイスと一致しなかった場合

ワイプキャッシュ

protected void wipeCache (ITestDevice device)

デバイスのキャッシュパーティションをワイプします。

パラメーター
device ITestDevice :フラッシュするITestDevice

投げる
DeviceNotAvailableExceptionデバイスが利用できない場合
TargetSetupErrorキャッシュのフラッシュに失敗した場合

ワイプパーティション

protected void wipePartition (ITestDevice device, 
                String partition)

指定したパーティションを「fastbooterase <name>」でワイプします

パラメーター
device ITestDevice :操作するITestDevice

partition String :ワイプするパーティションの名前

投げる
DeviceNotAvailableException
TargetSetupError