Google は、黒人コミュニティに対する人種平等の促進に取り組んでいます。取り組みを見る

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 setRamdiskPartition (String ramdiskPartition)

ramdiskパーティションを設定します

void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

void setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)

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

void setWipeTimeout (long timeout)

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

boolean shouldFlashRamdisk ()

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

保護されたメソッド

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)

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

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)

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

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

ramdiskパーティションを設定します

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

setWipeTimeout

public void setWipeTimeout (long timeout)

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

パラメーター
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

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

戻り値
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コマンドは、通常、 INativeDevice.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 ()

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

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

戻り値
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