FastbootDeviceFlasher
public
class
FastbootDeviceFlasher
extends Object
implements
IDeviceFlasher
| java.lang.Object | |
| ↳ | com.android.tradefed.targetprep.FastbootDeviceFlasher |
Eine Klasse, die auf „fastboot“ basiert, 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(Collection<String> dataWipeSkipList)
Legt die Liste der Pfade unter
Die Granularität der Überspringen-Liste bezieht sich auf die direkten untergeordneten Elemente von |
void
|
setFlashOptions(Collection<String> flashOptions)
Legt eine Liste von Optionen fest, die mit Flash-/Update-Befehlen übergeben werden sollen. |
void
|
setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)
Legt den Mechanismus fest, mit dem 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
|
shouldCheckBasebandVersionAfterFlash()
|
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
|
shouldSkipBasebandVersionCheck()
|
boolean
|
shouldSkipBootloaderVersionCheck()
|
static
boolean
|
stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck, boolean skipBasebandVersionCheck, boolean skipFastbootFailedMessage)
|
static
boolean
|
stderrContainsFailed(String stderr, boolean skipBootloaderVersionCheck, boolean skipBasebandVersionCheck)
|
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 dem 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 |
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, Map<String, String> envVarMap, String... cmdArgs)
Hilfsmethode zum Ausführen eines zeitaufwendigen Fastboot-Befehls mit Umgebungsvariablen. |
void
|
flashBaseband(ITestDevice device, File basebandImageFile)
Flasht das angegebene Baseband-Image und startet das Gerät neu in den Bootloader. |
void
|
flashBootloader(ITestDevice device, File bootloaderImageFile, boolean requireReboot)
Flasht das angegebene Bootloader-Image. |
void
|
flashBootloader(ITestDevice device, File bootloaderImageFile)
Das angegebene Bootloader-Image wird geflasht und das Gerät wird wieder im Bootloader-Modus neu gestartet. |
void
|
flashExtraImages(ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashen Sie alle gerätespezifischen Partitionen, bevor Sie das System flashen und das Gerät 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)
Flashen Sie das Systemimage auf dem Gerät. |
void
|
flashTrusty(ITestDevice device, File trustyImageFile)
Das angegebene Trusty-Image wird geflasht und das Gerät wird wieder in den Bootloader neu gestartet. |
void
|
flashUserData(ITestDevice device, IDeviceBuildInfo deviceBuild)
Die userdata-Partition 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)
Hilfsmethode 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)
Flash-Vorgang für die Partitionen „userdata“ und „cache“ 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
|
setCheckBasebandVersionAfterFlash(boolean checkBasebandVersionAfterFlash)
|
void
|
setSkipBasebandVersionCheck(boolean skipBasebandVersionCheck)
|
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. |
| Gibt Folgendes zurück: | |
|---|---|
String |
Ausgabe von stdout des Befehls als String |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
wenn das Gerät nicht verfügbar ist |
TargetSetupError |
Wenn der Fastboot-Befehl fehlschlägt oder die Version nicht ermittelt werden konnte |
flashen
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: der zu flash-ende ITestDevice |
deviceBuild |
IDeviceBuildInfo: der zu flash-ende IDeviceBuildInfo |
| Löst aus | |
|---|---|
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.
| Gibt Folgendes zurück: | |
|---|---|
CommandStatus |
|
getUserDataFlashOption
public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()
Ruft ab, ob das Nutzerdatenträger-Image geflasht, gelöscht oder beibehalten werden soll.
| Gibt Folgendes zurück: | |
|---|---|
IDeviceFlasher.UserDataFlashOption |
Ob das Nutzerdaten-Image 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: der zu flash-ende ITestDevice |
deviceBuild |
IDeviceBuildInfo: der zu flash-ende IDeviceBuildInfo |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
setDataWipeSkipList
public void setDataWipeSkipList (Collection<String> dataWipeSkipList)
Legt die Liste der Pfade unter /data fest, die beim Verwenden von ITestsZipInstaller nicht gelöscht werden sollen.
Die Granularität der Überspringen-Liste bezieht sich auf die direkten untergeordneten Elemente von /data.
| Parameter | |
|---|---|
dataWipeSkipList |
Collection |
setFlashOptions
public void setFlashOptions (Collection<String> 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, mit dem 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 |
shouldCheckBasebandVersionAfterFlash
public boolean shouldCheckBasebandVersionAfterFlash ()
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
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.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
shouldSkipBasebandVersionCheck
public boolean shouldSkipBasebandVersionCheck ()
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
shouldSkipBootloaderVersionCheck
public boolean shouldSkipBootloaderVersionCheck ()
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
stderrContainsFailed
public static boolean stderrContainsFailed (String stderr,
boolean skipBootloaderVersionCheck,
boolean skipBasebandVersionCheck,
boolean skipFastbootFailedMessage)| Parameter | |
|---|---|
stderr |
String |
skipBootloaderVersionCheck |
boolean |
skipBasebandVersionCheck |
boolean |
skipFastbootFailedMessage |
boolean |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
stderrContainsFailed
public static boolean stderrContainsFailed (String stderr,
boolean skipBootloaderVersionCheck,
boolean skipBasebandVersionCheck)| Parameter | |
|---|---|
stderr |
String |
skipBootloaderVersionCheck |
boolean |
skipBasebandVersionCheck |
boolean |
| Gibt Folgendes zurück: | |
|---|---|
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: der zu flash-ende ITestDevice |
deviceBuild |
IDeviceBuildInfo: das IDeviceBuildInfo, das das zu flash-ende Baseband-Image enthält |
| Löst aus | |
|---|---|
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: der zu flash-ende ITestDevice |
deviceBuild |
IDeviceBuildInfo: Das IDeviceBuildInfo, das das zu flash-ende Bootloader-Image enthält. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn der Bootloader geflasht wurde, false, wenn er übersprungen wurde |
| Löst aus | |
|---|---|
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 dem Gerät.
Weitere Informationen finden Sie unter ERROR(shouldFlashSystem(String,String,IDeviceBuildInfo)/#shouldFlashSystem(java.lang.String,java.lang.String,com.android.tradefed.build.IDeviceBuildInfo) shouldFlashSystem(String,String,IDeviceBuildInfo)).
Unabhängig vom gewählten Pfad sollte das Gerät nach der Ausführung der Methode in den Userspace booten.
| Parameter | |
|---|---|
device |
ITestDevice: der 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 flash-ende System-Image enthält |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn das System geflasht wurde, false, wenn es übersprungen wurde |
| Löst aus | |
|---|---|
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 |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
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: Das zu parsende IDeviceBuildInfo |
descriptor |
DeviceDescriptor: Der Deskriptor des Geräts, das geflasht wird. |
| Gibt Folgendes zurück: | |
|---|---|
IFlashingResourcesParser |
ein IFlashingResourcesParser, das von der Factory-Methode erstellt wurde. |
| Löst aus | |
|---|---|
|
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: Der IFlashingResourcesParser |
retriever |
IFlashingResourcesRetriever: Der IFlashingResourcesRetriever |
localBuild |
IDeviceBuildInfo: Der IDeviceBuildInfo |
| Löst aus | |
|---|---|
|
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 |
| Löst aus | |
|---|---|
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 eines 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 |
| Gibt Folgendes zurück: | |
|---|---|
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. |
| Löst aus | |
|---|---|
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 ITestDevice.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 |
| Gibt Folgendes zurück: | |
|---|---|
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. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
wenn das Gerät nicht verfügbar ist |
TargetSetupError |
Wenn der Fastboot-Befehl fehlschlägt |
executeLongFastbootCmd
protected String executeLongFastbootCmd (ITestDevice device, Map<String, String> envVarMap, String... cmdArgs)
Hilfsmethode zum Ausführen eines zeitaufwendigen Fastboot-Befehls mit Umgebungsvariablen.
Hinweis: Die meisten Fastboot-Befehle werden normalerweise innerhalb des von ITestDevice.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 |
Map: 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 |
| Gibt Folgendes zurück: | |
|---|---|
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. |
| Löst aus | |
|---|---|
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: der zu flash-ende ITestDevice |
basebandImageFile |
File: Das Baseband-Image File |
| Löst aus | |
|---|---|
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, boolean requireReboot)
Flasht das angegebene Bootloader-Image.
| Parameter | |
|---|---|
device |
ITestDevice: der zu flash-ende ITestDevice |
bootloaderImageFile |
File: Das Bootloader-Image File |
requireReboot |
boolean: Gibt an, ob nach dem Flashen neu gestartet werden soll. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
wenn das Gerät nicht verfügbar ist |
TargetSetupError |
wenn das Flashen fehlgeschlagen ist |
flashBootloader
protected void flashBootloader (ITestDevice device, File bootloaderImageFile)
Das angegebene Bootloader-Image wird geflasht und das Gerät wird wieder im Bootloader-Modus neu gestartet.
| Parameter | |
|---|---|
device |
ITestDevice: der zu flash-ende ITestDevice |
bootloaderImageFile |
File: Das Bootloader-Image File |
| Löst aus | |
|---|---|
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 das Gerät neu starten. Keine Aktion, sofern nicht überschrieben.
| Parameter | |
|---|---|
device |
ITestDevice: der zu flash-ende ITestDevice |
deviceBuild |
IDeviceBuildInfo: das IDeviceBuildInfo mit den Build-Dateien |
| Löst aus | |
|---|---|
|
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: der zu flash-ende ITestDevice |
imgFile |
File: ein File, der auf das zu flash-ende Image verweist |
partition |
String: Der Name der zu flash-enden Partition. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
flashRamdiskIfNeeded
protected void flashRamdiskIfNeeded (ITestDevice device, IDeviceBuildInfo deviceBuild)
| Parameter | |
|---|---|
device |
ITestDevice |
deviceBuild |
IDeviceBuildInfo |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
flashSystem
protected void flashSystem (ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashen Sie das Systemimage auf dem Gerät.
| Parameter | |
|---|---|
device |
ITestDevice: der zu flash-ende ITestDevice |
deviceBuild |
IDeviceBuildInfo: der zu flash-ende IDeviceBuildInfo |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
wenn das Gerät nicht verfügbar ist |
TargetSetupError |
Wenn der Fastboot-Befehl fehlschlägt |
flashTrusty
protected void flashTrusty (ITestDevice device, File trustyImageFile)
Das angegebene Trusty-Image wird geflasht und das Gerät wird wieder in den Bootloader neu gestartet.
| Parameter | |
|---|---|
device |
ITestDevice: der zu flash-ende ITestDevice |
trustyImageFile |
File: das vertrauenswürdige Bild File |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
wenn das Gerät nicht verfügbar ist |
TargetSetupError |
wenn das Flashen fehlgeschlagen ist |
flashUserData
protected void flashUserData (ITestDevice device, IDeviceBuildInfo deviceBuild)
Die userdata-Partition auf dem Gerät flashen.
| Parameter | |
|---|---|
device |
ITestDevice: der zu flash-ende ITestDevice |
deviceBuild |
IDeviceBuildInfo: das IDeviceBuildInfo, das die zu flash-enden Dateien enthält |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
wenn das Gerät nicht verfügbar ist |
TargetSetupError |
Wenn das Flashen von 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: der zu flash-ende ITestDevice |
deviceBuild |
IDeviceBuildInfo: das IDeviceBuildInfo, das die zu flash-enden Dateien enthält |
| Löst aus | |
|---|---|
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.
| Gibt Folgendes zurück: | |
|---|---|
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: der zu flash-ende ITestDevice |
| Gibt Folgendes zurück: | |
|---|---|
String |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
wenn das Gerät nicht verfügbar ist |
TargetSetupError |
wenn das Präfix nicht abgerufen werden konnte |
getCurrentSlot
protected String getCurrentSlot (ITestDevice device)
Hilfsmethode 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. |
| Gibt Folgendes zurück: | |
|---|---|
String |
„a“, „b“ oder null (wenn das Gerät nicht A/B-fähig ist) |
| Löst aus | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.targetprep.TargetSetupError |
DeviceNotAvailableException |
|
TargetSetupError |
|
getFlashingResourcesRetriever
protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()
| Gibt Folgendes zurück: | |
|---|---|
IFlashingResourcesRetriever |
|
getImageVersion
protected String getImageVersion (ITestDevice device, String imageName)
| Parameter | |
|---|---|
device |
ITestDevice |
imageName |
String |
| Gibt Folgendes zurück: | |
|---|---|
String |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
getRunUtil
protected IRunUtil getRunUtil ()
Für Tests verfügbar gemacht.
| Gibt Folgendes zurück: | |
|---|---|
IRunUtil |
|
handleUserDataFlashing
protected void handleUserDataFlashing (ITestDevice device, IDeviceBuildInfo deviceBuild)
Flash-Vorgang für die Partitionen „userdata“ und „cache“ verarbeiten
| Parameter | |
|---|---|
device |
ITestDevice: der zu flash-ende ITestDevice |
deviceBuild |
IDeviceBuildInfo: das IDeviceBuildInfo, das die zu flash-enden Dateien enthält |
| Löst aus | |
|---|---|
|
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 |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
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 |
| Löst aus | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.targetprep.TargetSetupError |
DeviceNotAvailableException |
|
TargetSetupError |
|
setCheckBasebandVersionAfterFlash
protected void setCheckBasebandVersionAfterFlash (boolean checkBasebandVersionAfterFlash)
| Parameter | |
|---|---|
checkBasebandVersionAfterFlash |
boolean |
setSkipBasebandVersionCheck
protected void setSkipBasebandVersionCheck (boolean skipBasebandVersionCheck)
| Parameter | |
|---|---|
skipBasebandVersionCheck |
boolean |
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 dies nach Bedarf überschreiben.
| Parameter | |
|---|---|
device |
ITestDevice: die zu flash-ende ITestDevice |
resourceParser |
IFlashingResourcesParser: Der IFlashingResourcesParser |
deviceProductType |
String: Der Produkttyp von device. |
| Löst aus | |
|---|---|
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: der zu flash-ende ITestDevice |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
wenn das Gerät nicht verfügbar ist |
TargetSetupError |
Fehler beim Flashen des Cache |
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. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|