FastbootDeviceFlasher

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

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


Eine Klasse, die auf „fastboot“ angewiesen ist, um ein Image auf physische Android-Hardware zu flashen.

Zusammenfassung

Konstanten

String BASEBAND_IMAGE_NAME

Öffentliche Konstruktoren

FastbootDeviceFlasher()

Öffentliche Methoden

static String fetchImageVersion(IRunUtil runUtil, ITestDevice device, String imageName)

Hilfsmethode zum Abrufen der aktuellen Bildversion auf dem Gerät.

void flash(ITestDevice device, IDeviceBuildInfo deviceBuild)

Flashes werden auf dem Gerät erstellt.

CommandStatus getSystemFlashingStatus()

Rufen Sie den Status der Befehlsausführung für das Flashen primärer Systempartitionen ab.

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption()

Ruft ab, ob das Nutzerdatenträger-Image geflasht, gelöscht oder beibehalten werden soll.

void overrideDeviceOptions(ITestDevice device)

Überschreibt Optionen für ein Gerät.

void preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)

Alle Einrichtungsvorgänge und ‑prüfungen, die vor dem eigentlichen Flashen des kritischen Abschnitts erfolgen müssen.

void setDataWipeSkipList( dataWipeSkipList)

Legt die Liste der Pfade unter /data fest, die beim Verwenden von ITestsZipInstaller nicht gelöscht werden sollen.

Die Granularität der Überspringliste entspricht den direkten untergeordneten Elementen von /data.

void setFlashOptions( flashOptions)

Legt eine Liste von Optionen fest, die mit Flash-/Update-Befehlen übergeben werden sollen.

void setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)

Legt den Mechanismus fest, über den der Flasher Ressourcendateien für das Flashen abrufen kann.

void setForceSystemFlash(boolean forceSystemFlash)

Legt fest, ob das System immer geflasht werden soll, auch wenn die aktuelle Version ausgeführt wird.

void setIncrementalFlashing(IncrementalImageUtil incrementalUtil)
void setRamdiskPartition(String ramdiskPartition)

Legt die Ramdisk-Partition fest.

void setShouldFlashRamdisk(boolean shouldFlashRamdisk)

Legt fest, ob nach dem Aktualisieren des Geräts über eine ZIP-Datei mit einem Image eine zusätzliche Ramdisk geflasht werden soll.

void setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)

Legt fest, ob das Nutzerdatenträger-Image geflasht, gelöscht oder beibehalten werden soll.

void setWipeTimeout(long timeout)

Legen Sie das Zeitlimit für das Löschen der Daten fest.

boolean shouldFlashRamdisk()

Prüft, ob der Flasher so eingestellt ist, dass nach dem Aktualisieren des Geräts über eine Image-ZIP-Datei eine zusätzliche RAM-Disk geflasht werden soll.

boolean shouldSkipBootloaderVersionCheck()
static boolean stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck)
static boolean stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck, boolean skipFastbootFailedMessage)

Geschützte Methoden

void checkAndFlashBaseband(ITestDevice device, IDeviceBuildInfo deviceBuild)

Flashen Sie bei Bedarf das Baseband-Image auf das Gerät.

boolean checkAndFlashBootloader(ITestDevice device, IDeviceBuildInfo deviceBuild)

Flashen Sie bei Bedarf das Bootloader-Image auf das Gerät.

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

Flashen Sie bei Bedarf das System-Image auf das Gerät.

boolean checkShouldFlashBaseband(ITestDevice device, IDeviceBuildInfo deviceBuild)

Prüfe, ob das Baseband auf dem bereitgestellten Gerät geflasht werden muss.

IFlashingResourcesParser createFlashingResourcesParser(IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)

Factory-Methode zum Erstellen eines IFlashingResourcesParser.

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

Hook, mit dem Unterklassen bei Bedarf zusätzliche benutzerdefinierte Bilddateien herunterladen können.

void downloadFlashingResources(ITestDevice device, IDeviceBuildInfo localBuild)

Zusätzliche Flash-Image-Dateien werden heruntergeladen

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

Helper-Methode zum Ausführen eines Fastboot-Befehls.

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

Hilfsmethode zum Ausführen eines Fastboot-Befehls mit langer Laufzeit.

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

Hilfsmethode zum Ausführen eines zeitaufwendigen Fastboot-Befehls mit Umgebungsvariablen.

void flashBaseband(ITestDevice device, File basebandImageFile)

Flasht das angegebene Basisband-Image und startet das Gerät neu in den Bootloader.

void flashBootloader(ITestDevice device, File bootloaderImageFile)

Flasht das angegebene Bootloader-Image und startet das Gerät neu in den Bootloader.

void flashExtraImages(ITestDevice device, IDeviceBuildInfo deviceBuild)

Flashen Sie alle gerätespezifischen Partitionen, bevor Sie das System flashen und neu starten.

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

Einzelne Partition eines Geräts flashen

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

Spiele das System-Image auf das Gerät.

void flashUserData(ITestDevice device, IDeviceBuildInfo deviceBuild)

Die Partition „userdata“ auf dem Gerät flashen.

void flashUserDataFromDeviceImageFile(ITestDevice device, IDeviceBuildInfo deviceBuild)

Extrahiert die Datei „userdata.img“ aus der Geräte-Image-Datei und überträgt sie auf das Gerät.

String getBootPartitionName()

Rufen Sie den Namen der Bootpartition für diesen Geräte-Flasher ab.

String getBootloaderFilePrefix(ITestDevice device)

Bootloader-Dateipräfix abrufen

String getCurrentSlot(ITestDevice device)

Helper-Methode zum Abrufen des aktuellen Slots (für A/B-fähige Geräte).

IFlashingResourcesRetriever getFlashingResourcesRetriever()
FuseUtil getFuseUtil()
String getImageVersion(ITestDevice device, String imageName)
IRunUtil getRunUtil()

Für Tests verfügbar gemacht.

void handleUserDataFlashing(ITestDevice device, IDeviceBuildInfo deviceBuild)

Flashen der userdata-/cache-Partition verarbeiten

boolean hasPartition(ITestDevice device, String partition)

Prüft mit dem Bootloader, ob die angegebene Partition vorhanden ist

void preFlashSetup(ITestDevice device, IDeviceBuildInfo deviceBuild)

Führen Sie alle erforderlichen zusätzlichen Einrichtungsschritte vor dem Flashen durch.

void setSkipBootloaderVersionCheck(boolean skipBootloaderVersionCheck)
void setSkipFastbootFailedMessage(boolean skipFastbootFailedMessage)
void setSystemBuildInfo(String systemBuildId, String systemBuildFlavor)
void verifyRequiredBoards(ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType)

Prüfen Sie, ob der Produkttyp des Geräts den zu flash-enden Build unterstützt.

void wipeCache(ITestDevice device)

Löschen Sie die Cache-Partition auf dem Gerät.

void wipePartition(ITestDevice device, String partition)

Löschen Sie die angegebene Partition mit „fastboot erase <name>“.

Konstanten

BASEBAND_IMAGE_NAME

public static final String BASEBAND_IMAGE_NAME

Konstanter Wert: "radio"

Öffentliche Konstruktoren

FastbootDeviceFlasher

public FastbootDeviceFlasher ()

Öffentliche Methoden

fetchImageVersion

public static String fetchImageVersion (IRunUtil runUtil, 
                ITestDevice device, 
                String imageName)

Hilfsmethode zum Abrufen der aktuellen Bildversion auf dem Gerät.

Parameter
runUtil IRunUtil

device ITestDevice: der ITestDevice, auf dem der Befehl ausgeführt werden soll.

imageName String: Der Name des abzurufenden Bildes.

Returns
String Ausgabe von stdout des Befehls als String

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError Wenn der Fastboot-Befehl fehlschlägt oder die Version nicht ermittelt werden kann

Flash

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flashes werden auf dem Gerät erstellt.

Die Funktion wird sofort nach Abschluss des Flash-Vorgangs zurückgegeben. Anrufer sollten warten, bis das Gerät online und verfügbar ist, bevor sie mit dem Testen fortfahren.

Parameter
device ITestDevice: das zu flash-ende ITestDevice

deviceBuild IDeviceBuildInfo: das zu flash-ende IDeviceBuildInfo

Ausgabe
DeviceNotAvailableException
TargetSetupError

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

Rufen Sie den Status der Befehlsausführung für das Flashen primärer Systempartitionen ab.

Wenn Systempartitionen nicht geflasht werden (das System hat bereits den zu flashhenden Build), kann der Befehlsstatus null sein.

Returns
CommandStatus

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Ruft ab, ob das Nutzerdatenträger-Image geflasht, gelöscht oder beibehalten werden soll.

Returns
IDeviceFlasher.UserDataFlashOption Ob das Nutzerdatenset geflasht, gelöscht oder beibehalten werden soll

overrideDeviceOptions

public void overrideDeviceOptions (ITestDevice device)

Überschreibt Optionen für ein Gerät. Wird verwendet, um Standardoptionswerte zu überschreiben, wenn die Standardwerte von einem bestimmten Gerät nicht unterstützt werden.

preFlashOperations

public void preFlashOperations (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Alle Einrichtungsvorgänge und ‑prüfungen, die vor dem eigentlichen Flashen des kritischen Abschnitts erfolgen müssen. Keiner dieser Vorgänge wird in den kritischen Abschnitt mit Parallelitätssteuerung aufgenommen.

Parameter
device ITestDevice: das zu flash-ende ITestDevice

deviceBuild IDeviceBuildInfo: das zu flash-ende IDeviceBuildInfo

Ausgabe
DeviceNotAvailableException
TargetSetupError

setDataWipeSkipList

public void setDataWipeSkipList ( dataWipeSkipList)

Legt die Liste der Pfade unter /data fest, die beim Verwenden von ITestsZipInstaller nicht gelöscht werden sollen.

Die Granularität der Überspringliste entspricht den direkten untergeordneten Elementen von /data.

Parameter
dataWipeSkipList

setFlashOptions

public void setFlashOptions ( flashOptions)

Legt eine Liste von Optionen fest, die mit Flash-/Update-Befehlen übergeben werden sollen.

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Legt den Mechanismus fest, über den der Flasher Ressourcendateien für das Flashen abrufen kann.

Parameter
retriever IFlashingResourcesRetriever: die zu verwendende IFlashingResourcesRetriever

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

Legt fest, ob das System immer geflasht werden soll, auch wenn die aktuelle Version ausgeführt wird.

setIncrementalFlashing

public void setIncrementalFlashing (IncrementalImageUtil incrementalUtil)

Parameter
incrementalUtil IncrementalImageUtil

setRamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Legt die Ramdisk-Partition fest.

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Legt fest, ob nach dem Aktualisieren des Geräts über eine ZIP-Datei mit einem Image eine zusätzliche Ramdisk geflasht werden soll.

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Legt fest, ob das Nutzerdatenträger-Image geflasht, gelöscht oder beibehalten werden soll.

setWipeTimeout

public void setWipeTimeout (long timeout)

Legen Sie das Zeitlimit für das Löschen der Daten fest.

Parameter
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Prüft, ob der Flasher so eingestellt ist, dass nach dem Aktualisieren des Geräts über eine Image-ZIP-Datei eine zusätzliche RAM-Disk geflasht werden soll.

Returns
boolean

shouldSkipBootloaderVersionCheck

public boolean shouldSkipBootloaderVersionCheck ()

Returns
boolean

stderrContainsFailed

public static boolean stderrContainsFailed (String stderr, 
                boolean skipBootloaderVersionCheck)

Parameter
stderr String

skipBootloaderVersionCheck boolean

Returns
boolean

stderrContainsFailed

public static boolean stderrContainsFailed (String stderr, 
                boolean skipBootloaderVersionCheck, 
                boolean skipFastbootFailedMessage)

Parameter
stderr String

skipBootloaderVersionCheck boolean

skipFastbootFailedMessage boolean

Returns
boolean

Geschützte Methoden

checkAndFlashBaseband

protected void checkAndFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flashen Sie bei Bedarf das Baseband-Image auf das Gerät. Das Baseband wird nur geflasht, wenn die aktuelle Version auf dem Gerät nicht der erforderlichen Version entspricht.

Parameter
device ITestDevice: das zu flash-ende ITestDevice

deviceBuild IDeviceBuildInfo: das IDeviceBuildInfo, das das zu flash-ende Baseband-Image enthält

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError Wenn das Flashen des Basisbands fehlgeschlagen ist

checkAndFlashBootloader

protected boolean checkAndFlashBootloader (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flashen Sie bei Bedarf das Bootloader-Image auf das Gerät.

Der Bootloader wird nur geflasht, wenn die aktuelle Version auf dem Gerät nicht der erforderlichen Version entspricht.

Parameter
device ITestDevice: das zu flash-ende ITestDevice

deviceBuild IDeviceBuildInfo: Das IDeviceBuildInfo, das das zu flash-ende Bootloader-Image enthält.

Returns
boolean true, wenn der Bootloader geflasht wurde, false, wenn er übersprungen wurde

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError Wenn das Flashen des Bootloaders fehlgeschlagen ist

checkAndFlashSystem

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

Flashen Sie bei Bedarf das System-Image auf das Gerät.

Bitte sehen Sie sich ERROR(/#shouldFlashSystem(String,String,com.android.tradefed.build.IDeviceBuildInfo)) an.

Unabhängig vom gewählten Pfad sollte das Gerät nach der Ausführung der Methode in den Userspace booten.

Parameter
device ITestDevice: das zu flash-ende ITestDevice

systemBuildId String: die aktuelle Build-ID, die auf dem Gerät ausgeführt wird

systemBuildFlavor String: die aktuelle Build-Variante, die auf dem Gerät ausgeführt wird

deviceBuild IDeviceBuildInfo: das IDeviceBuildInfo, das das zu flashhende System-Image enthält

Returns
boolean true, wenn das System geflasht wurde, false, wenn es übersprungen wurde

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError Wenn das Flashen des Bootloaders fehlgeschlagen ist

checkShouldFlashBaseband

protected boolean checkShouldFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Prüfe, ob das Baseband auf dem bereitgestellten Gerät geflasht werden muss.

Parameter
device ITestDevice: Die zu prüfende ITestDevice

deviceBuild IDeviceBuildInfo: das IDeviceBuildInfo, das das zu prüfende Baseband-Image enthält

Returns
boolean

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError Wenn das Flashen des Basisbands fehlgeschlagen ist

createFlashingResourcesParser

protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, 
                DeviceDescriptor descriptor)

Factory-Methode zum Erstellen eines IFlashingResourcesParser.

Für Einheitentests verfügbar gemacht.

Parameter
localBuild IDeviceBuildInfo: Der zu parsende IDeviceBuildInfo

descriptor DeviceDescriptor: Der Deskriptor des Geräts, das geflasht wird.

Returns
IFlashingResourcesParser ein IFlashingResourcesParser, das von der Factory-Methode erstellt wurde.

Ausgabe
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

downloadExtraImageFiles

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

Hook, mit dem Unterklassen bei Bedarf zusätzliche benutzerdefinierte Bilddateien herunterladen können.

Parameter
resourceParser IFlashingResourcesParser: die IFlashingResourcesParser

retriever IFlashingResourcesRetriever: die IFlashingResourcesRetriever

localBuild IDeviceBuildInfo: die IDeviceBuildInfo

Ausgabe
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

downloadFlashingResources

protected void downloadFlashingResources (ITestDevice device, 
                IDeviceBuildInfo localBuild)

Zusätzliche Flash-Image-Dateien werden heruntergeladen

Parameter
device ITestDevice: die ITestDevice, für die Ressourcen heruntergeladen werden sollen

localBuild IDeviceBuildInfo: Die IDeviceBuildInfo, die gefüllt werden soll. Setzt voraus, dass die Gerätebilddatei bereits festgelegt ist

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError wenn Ressourcen nicht abgerufen werden konnten

executeFastbootCmd

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

Helper-Methode zum Ausführen des Fastboot-Befehls.

Parameter
device ITestDevice: der ITestDevice, auf dem der Befehl ausgeführt werden soll.

cmdArgs String: die Argumente, die an fastboot übergeben werden sollen

Returns
String Gibt die stderr-Ausgabe des Befehls als String zurück, falls sie nicht leer ist. Andernfalls wird stdout zurückgegeben. Einige Fastboot-Befehle sind insofern ungewöhnlich, als sie im Erfolgsfall die Ausgabe in stderr ausgeben.

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError Wenn der Fastboot-Befehl fehlschlägt

executeLongFastbootCmd

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

Hilfsmethode zum Ausführen eines Fastboot-Befehls mit langer Laufzeit.

Hinweis: Die meisten Fastboot-Befehle werden normalerweise innerhalb des von INativeDevice.executeFastbootCommand(String) zugelassenen Zeitlimits ausgeführt. Wenn jedoch mehrere Geräte gleichzeitig geflasht werden, können Fastboot-Befehle viel länger als gewöhnlich dauern.

Parameter
device ITestDevice: der ITestDevice, auf dem der Befehl ausgeführt werden soll.

cmdArgs String: die Argumente, die an fastboot übergeben werden sollen

Returns
String Gibt die stderr-Ausgabe des Befehls als String zurück, falls sie nicht leer ist. Andernfalls wird stdout zurückgegeben. Einige Fastboot-Befehle sind insofern ungewöhnlich, als sie im Erfolgsfall die Ausgabe in stderr ausgeben.

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError Wenn der Fastboot-Befehl fehlschlägt

executeLongFastbootCmd

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

Hilfsmethode zum Ausführen eines zeitaufwendigen Fastboot-Befehls mit Umgebungsvariablen.

Hinweis: Die meisten Fastboot-Befehle werden normalerweise innerhalb des von INativeDevice.executeFastbootCommand(String) zugelassenen Zeitlimits ausgeführt. Wenn jedoch mehrere Geräte gleichzeitig geflasht werden, können Fastboot-Befehle viel länger als gewöhnlich dauern.

Parameter
device ITestDevice: der ITestDevice, auf dem der Befehl ausgeführt werden soll.

envVarMap : Die Map mit Umgebungsvariablen, die vor dem Ausführen des Fastboot-Befehls festgelegt werden müssen.

cmdArgs String: die Argumente, die an fastboot übergeben werden sollen

Returns
String Gibt die stderr-Ausgabe des Befehls als String zurück, falls sie nicht leer ist. Andernfalls wird stdout zurückgegeben. Einige Fastboot-Befehle sind insofern ungewöhnlich, als sie im Erfolgsfall die Ausgabe in stderr ausgeben.

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError Wenn der Fastboot-Befehl fehlschlägt

flashBaseband

protected void flashBaseband (ITestDevice device, 
                File basebandImageFile)

Flasht das angegebene Baseband-Image und startet das Gerät neu in den Bootloader.

Parameter
device ITestDevice: das zu flash-ende ITestDevice

basebandImageFile File: Das Baseband-Image ERROR(/File)

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError Wenn das Flashen des Basisbands fehlgeschlagen ist

flashBootloader

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile)

Flasht das angegebene Bootloader-Image und startet das Gerät neu im Bootloader-Modus.

Parameter
device ITestDevice: das zu flash-ende ITestDevice

bootloaderImageFile File: Das Bootloader-Image ERROR(/File)

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError wenn das Flashen fehlgeschlagen ist

flashExtraImages

protected void flashExtraImages (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flashen Sie alle gerätespezifischen Partitionen, bevor Sie das System flashen und neu starten. Keine Aktion, sofern nicht überschrieben.

Parameter
device ITestDevice: das zu flash-ende ITestDevice

deviceBuild IDeviceBuildInfo: das IDeviceBuildInfo mit den Build-Dateien

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

flashPartition

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

Einzelne Partition eines Geräts flashen

Parameter
device ITestDevice: das zu flash-ende ITestDevice

imgFile File: ein ERROR(/File), der auf das zu flash-ende Image verweist

partition String: Der Name der zu flash-enden Partition.

Ausgabe
DeviceNotAvailableException
TargetSetupError

flashRamdiskIfNeeded

protected void flashRamdiskIfNeeded (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Parameter
device ITestDevice

deviceBuild IDeviceBuildInfo

Ausgabe
DeviceNotAvailableException
TargetSetupError

flashSystem

protected void flashSystem (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Spiele das System-Image auf das Gerät.

Parameter
device ITestDevice: das zu flash-ende ITestDevice

deviceBuild IDeviceBuildInfo: das zu flash-ende IDeviceBuildInfo

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError Wenn der Fastboot-Befehl fehlschlägt

flashUserData

protected void flashUserData (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Die Partition „userdata“ auf dem Gerät flashen.

Parameter
device ITestDevice: das zu flash-ende ITestDevice

deviceBuild IDeviceBuildInfo: das IDeviceBuildInfo, das die zu flash-enden Dateien enthält

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError Wenn das Flashen der Nutzerdaten fehlgeschlagen ist

flashUserDataFromDeviceImageFile

protected void flashUserDataFromDeviceImageFile (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Extrahiert die Datei „userdata.img“ aus der Geräte-Image-Datei und überträgt sie auf das Gerät.

Parameter
device ITestDevice: das zu flash-ende ITestDevice

deviceBuild IDeviceBuildInfo: das IDeviceBuildInfo, das die zu flash-enden Dateien enthält

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError Wenn das Extrahieren oder Flashen von Nutzerdaten fehlgeschlagen ist

getBootPartitionName

protected String getBootPartitionName ()

Rufen Sie den Namen der Bootpartition für diesen Geräte-Flasher ab.

Die Standardeinstellung ist „bootloader“. Abgeleitete Klassen sollten diese Methode bei Bedarf überschreiben.

Returns
String

getBootloaderFilePrefix

protected String getBootloaderFilePrefix (ITestDevice device)

Bootloader-Dateipräfix abrufen

Die Standardeinstellung ist getBootPartitionName(). Abgeleitete Klassen sollten diese Methode bei Bedarf überschreiben.

Parameter
device ITestDevice: das zu flash-ende ITestDevice

Returns
String

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError if failed to get prefix

getCurrentSlot

protected String getCurrentSlot (ITestDevice device)

Helper-Methode zum Abrufen des aktuellen Slots (für A/B-fähige Geräte).

Parameter
device ITestDevice: Die ITestDevice, auf der der Befehl ausgeführt werden soll.

Returns
String „a“, „b“ oder null (wenn das Gerät nicht A/B-fähig ist)

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

getFlashingResourcesRetriever

protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()

Returns
IFlashingResourcesRetriever

getFuseUtil

protected FuseUtil getFuseUtil ()

Returns
FuseUtil

getImageVersion

protected String getImageVersion (ITestDevice device, 
                String imageName)

Parameter
device ITestDevice

imageName String

Returns
String

Ausgabe
DeviceNotAvailableException
TargetSetupError

getRunUtil

protected IRunUtil getRunUtil ()

Für Tests verfügbar gemacht.

Returns
IRunUtil

handleUserDataFlashing

protected void handleUserDataFlashing (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flash der userdata-/cache-Partition verarbeiten

Parameter
device ITestDevice: das zu flash-ende ITestDevice

deviceBuild IDeviceBuildInfo: das IDeviceBuildInfo, das die zu flash-enden Dateien enthält

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

hasPartition

protected boolean hasPartition (ITestDevice device, 
                String partition)

Prüft mit dem Bootloader, ob die angegebene Partition vorhanden ist

Parameter
device ITestDevice: die ITestDevice, die verwendet werden soll

partition String: Der Name der zu prüfenden Partition

Returns
boolean

Ausgabe
DeviceNotAvailableException

preFlashSetup

protected void preFlashSetup (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Führen Sie alle erforderlichen zusätzlichen Einrichtungsschritte vor dem Flashen durch. Keine Aktion, sofern nicht überschrieben.

Parameter
device ITestDevice: die vorzubereitende ITestDevice

deviceBuild IDeviceBuildInfo: das IDeviceBuildInfo mit den Build-Dateien

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.targetprep.TargetSetupError
DeviceNotAvailableException
TargetSetupError

setSkipBootloaderVersionCheck

protected void setSkipBootloaderVersionCheck (boolean skipBootloaderVersionCheck)

Parameter
skipBootloaderVersionCheck boolean

setSkipFastbootFailedMessage

protected void setSkipFastbootFailedMessage (boolean skipFastbootFailedMessage)

Parameter
skipFastbootFailedMessage boolean

setSystemBuildInfo

protected void setSystemBuildInfo (String systemBuildId, 
                String systemBuildFlavor)

Parameter
systemBuildId String

systemBuildFlavor String

verifyRequiredBoards

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

Prüfen Sie, ob der Produkttyp des Geräts den zu flash-enden Build unterstützt.

Bei der Basisimplementierung wird geprüft, ob „deviceProductType“ in der Sammlung IFlashingResourcesParser.getRequiredBoards() enthalten ist. Abgeleitete Klassen können diese Methode nach Bedarf überschreiben.

Parameter
device ITestDevice: die zu flash-ende ITestDevice

resourceParser IFlashingResourcesParser: die IFlashingResourcesParser

deviceProductType String: Der Produkttyp des device

Ausgabe
TargetSetupError wenn die erforderlichen Board-Informationen des Builds nicht mit dem Gerät übereinstimmten

wipeCache

protected void wipeCache (ITestDevice device)

Löschen Sie die Cache-Partition auf dem Gerät.

Parameter
device ITestDevice: das zu flash-ende ITestDevice

Ausgabe
DeviceNotAvailableException Wenn das Gerät nicht verfügbar ist
TargetSetupError Wenn der Flash-Cache nicht geleert werden konnte

wipePartition

protected void wipePartition (ITestDevice device, 
                String partition)

Löschen Sie die angegebene Partition mit „fastboot erase <name>“.

Parameter
device ITestDevice: die ITestDevice, die verwendet werden soll

partition String: Der Name der zu löschenden Partition.

Ausgabe
DeviceNotAvailableException
TargetSetupError