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(
Legt die Liste der Pfade unter
Die Granularität der Überspringliste entspricht den direkten untergeordneten Elementen von |
void
|
setFlashOptions(
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 |
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,
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 |
|
getImageVersion
protected String getImageVersion (ITestDevice device, String imageName)
| Parameter | |
|---|---|
device |
ITestDevice |
imageName |
String |
| Returns | |
|---|---|
String |
|
| Ausgabe | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
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 |
|