FastbootDeviceFlasher
public
class
FastbootDeviceFlasher
extends Object
implements
IDeviceFlasher
java.lang.Object | |
↳ | com.android.tradefed.targetprep.FastbootDeviceFlasher |
Eine Klasse, die Fastboot zum Flashen eines Images auf physischer Android-Hardware verwendet.
Zusammenfassung
Felder | |
---|---|
public
static
final
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)
Blinken wird auf dem Gerät erstellt. |
CommandStatus
|
getSystemFlashingStatus()
Ruft den Status der Befehlsausführung für das Flashen der primären Systempartitionen ab. |
IDeviceFlasher.UserDataFlashOption
|
getUserDataFlashOption()
Gibt an, ob das Image mit den Nutzerdaten geflasht, gelöscht oder beibehalten werden soll |
void
|
overrideDeviceOptions(ITestDevice device)
Optionen für ein Gerät überschreiben |
void
|
preFlashOperations(ITestDevice device, IDeviceBuildInfo deviceBuild)
Alle Einrichtungsvorgänge und ‑prüfungen, die vor dem eigentlichen Flashen des kritischen Abschnitts ausgeführt werden müssen. |
void
|
setDataWipeSkipList(
Damit wird verhindert, dass die Liste der Pfade unter
Die Granularität der Auslöseliste entspricht den direkt untergeordneten Elementen von |
void
|
setFlashOptions(
Hiermit wird eine Liste von Optionen festgelegt, die mit den Befehlen „flash“ oder „update“ übergeben werden. |
void
|
setFlashingResourcesRetriever(IFlashingResourcesRetriever retriever)
Legt den Mechanismus fest, mit dem der Flasher Ressourcendateien zum Flashen abrufen kann. |
void
|
setForceSystemFlash(boolean forceSystemFlash)
Legen Sie fest, ob das System immer geflasht werden soll, auch wenn der aktuelle Build ausgeführt wird. |
void
|
setIncrementalFlashing(IncrementalImageUtil incrementalUtil)
|
void
|
setRamdiskPartition(String ramdiskPartition)
Ramdisk-Partition festlegen |
void
|
setShouldFlashRamdisk(boolean shouldFlashRamdisk)
Gibt an, ob nach dem Aktualisieren des Geräts über ein Image-Zip-Archiv ein zusätzliches RAM-Disk geflasht werden soll. |
void
|
setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)
Legt fest, ob das Image mit den Nutzerdaten 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 ein Image-Zip-Archiv ein zusätzliches RAM-Disk geflasht werden soll |
Geschützte Methoden | |
---|---|
void
|
checkAndFlashBaseband(ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashen Sie bei Bedarf das Basisband-Image auf dem Gerät. |
boolean
|
checkAndFlashBootloader(ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashen Sie bei Bedarf das Bootloader-Image auf dem 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üfen Sie, ob das Baseband auf dem bereitgestellten Gerät geflasht werden muss. |
IFlashingResourcesParser
|
createFlashingResourcesParser(IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)
Factory-Methode zum Erstellen einer |
void
|
downloadExtraImageFiles(IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild)
Mit diesem Hook können untergeordnete Klassen bei Bedarf zusätzliche benutzerdefinierte Bilddateien herunterladen. |
void
|
downloadFlashingResources(ITestDevice device, IDeviceBuildInfo localBuild)
Erforderliche zusätzliche Blinkbilddateien werden heruntergeladen |
String
|
executeFastbootCmd(ITestDevice device, String... cmdArgs)
Hilfsmethode zum Ausführen des Fastboot-Befehls. |
String
|
executeLongFastbootCmd(ITestDevice device, String... cmdArgs)
Hilfsmethode zum Ausführen eines lang laufenden Fastboot-Befehls. |
String
|
executeLongFastbootCmd(ITestDevice device,
Hilfsmethode zum Ausführen eines lang laufenden Fastboot-Befehls mit Umgebungsvariablen. |
void
|
flashBaseband(ITestDevice device, File basebandImageFile)
Das angegebene Baseband-Image wird geflasht und das Gerät wird neu im Bootloader gestartet. |
void
|
flashBootloader(ITestDevice device, File bootloaderImageFile)
Das angegebene Bootloader-Image wird geflasht und das Gerät wird neu im Bootloader gestartet. |
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)
Flashen Sie das System-Image auf dem Gerät. |
void
|
flashUserData(ITestDevice device, IDeviceBuildInfo deviceBuild)
Flash-Datenpartition auf dem Gerät |
void
|
flashUserDataFromDeviceImageFile(ITestDevice device, IDeviceBuildInfo deviceBuild)
Extrahiert die Datei „userdata.img“ aus der Geräte-Imagedatei und flasht 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()
Wird für Tests freigegeben. |
void
|
handleUserDataFlashing(ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashen der userdata/cache-Partition verarbeiten |
boolean
|
hasPartition(ITestDevice device, String partition)
Prüft beim Bootloader, ob die angegebene Partition vorhanden ist |
void
|
preFlashSetup(ITestDevice device, IDeviceBuildInfo deviceBuild)
Führen Sie alle erforderlichen zusätzlichen Schritte vor dem Flashen aus. |
void
|
setSystemBuildInfo(String systemBuildId, String systemBuildFlavor)
|
void
|
verifyRequiredBoards(ITestDevice device, IFlashingResourcesParser resourceParser, String deviceProductType)
Prüfen Sie, ob der Produkttyp des Geräts das Flashen 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>“. |
Felder
BASEBAND_IMAGE_NAME
public static final String BASEBAND_IMAGE_NAME
Ö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 : ITestDevice , auf dem der Befehl ausgeführt werden soll |
imageName |
String : Der Name des abzurufenden Bilds. |
Returns | |
---|---|
String |
Stdout-Ausgabe des Befehls in einen String umwandeln |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
Wenn der Fastboot-Befehl fehlschlägt oder die Version nicht ermittelt werden konnte |
Flash
public void flash (ITestDevice device, IDeviceBuildInfo deviceBuild)
Blinken wird auf dem Gerät erstellt.
Wird sofort nach Abschluss des Flashens zurückgegeben. Anrufer sollten warten, bis das Gerät online und verfügbar ist, bevor sie mit dem Testen fortfahren.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
deviceBuild |
IDeviceBuildInfo : die IDeviceBuildInfo , die geflasht werden soll |
Ausgabe | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
getSystemFlashingStatus
public CommandStatus getSystemFlashingStatus ()
Ruft den Status der Befehlsausführung für das Flashen der primären Systempartitionen ab.
Hinweis: Wenn keine Systempartitionen geflasht werden (das System hat bereits die zu flashende Version), kann der Befehlsstatus null
sein.
Returns | |
---|---|
CommandStatus |
getUserDataFlashOption
public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()
Gibt an, ob das Image mit den Nutzerdaten geflasht, gelöscht oder beibehalten werden soll
Returns | |
---|---|
IDeviceFlasher.UserDataFlashOption |
Ob das Image mit den Nutzerdaten geflasht, gelöscht oder beibehalten werden soll |
overrideDeviceOptions
public void overrideDeviceOptions (ITestDevice device)
Optionen für ein Gerät überschreiben 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 ausgeführt werden müssen. Keine dieser Vorgänge wird in den synchron gesteuerten kritischen Abschnitt aufgenommen.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
deviceBuild |
IDeviceBuildInfo : die IDeviceBuildInfo , die geflasht werden soll |
Ausgabe | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
setDataWipeSkipList
public void setDataWipeSkipList (dataWipeSkipList)
Damit wird verhindert, dass die Liste der Pfade unter /data
gelöscht wird, wenn ITestsZipInstaller
verwendet wird.
Die Granularität der Auslöseliste entspricht den direkt untergeordneten Elementen von /data
.
Parameter | |
---|---|
dataWipeSkipList |
|
setFlashOptions
public void setFlashOptions (flashOptions)
Hiermit wird eine Liste von Optionen festgelegt, die mit den Befehlen „flash“ oder „update“ übergeben werden.
setFlashingResourcesRetriever
public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)
Legt den Mechanismus fest, mit dem der Flasher Ressourcendateien zum Flashen abrufen kann.
Parameter | |
---|---|
retriever |
IFlashingResourcesRetriever : der zu verwendende IFlashingResourcesRetriever |
setForceSystemFlash
public void setForceSystemFlash (boolean forceSystemFlash)
Legen Sie fest, ob das System immer geflasht werden soll, auch wenn der aktuelle Build ausgeführt wird.
setIncrementalFlashing
public void setIncrementalFlashing (IncrementalImageUtil incrementalUtil)
Parameter | |
---|---|
incrementalUtil |
IncrementalImageUtil |
setRamdiskPartition
public void setRamdiskPartition (String ramdiskPartition)
Ramdisk-Partition festlegen
setShouldFlashRamdisk
public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)
Gibt an, ob nach dem Aktualisieren des Geräts über ein Image-Zip-Archiv ein zusätzliches RAM-Disk geflasht werden soll.
setUserDataFlashOption
public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)
Legt fest, ob das Image mit den Nutzerdaten 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 ein Image-Zip-Archiv ein zusätzliches RAM-Disk geflasht werden soll
Returns | |
---|---|
boolean |
Geschützte Methoden
checkAndFlashBaseband
protected void checkAndFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashen Sie bei Bedarf das Basisband-Image auf dem Gerät. Das Baseband wird nur geflasht, wenn die aktuelle Version auf dem Gerät nicht der erforderlichen Version entspricht.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
deviceBuild |
IDeviceBuildInfo : die IDeviceBuildInfo , die das zu flashende Basisband-Image enthält |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
if failed to flash baseband |
checkAndFlashBootloader
protected boolean checkAndFlashBootloader (ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashen Sie bei Bedarf das Bootloader-Image auf dem Gerät.
Der Bootloader wird nur geflasht, wenn die aktuelle Version auf dem Gerät nicht der erforderlichen Version entspricht.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
deviceBuild |
IDeviceBuildInfo : die IDeviceBuildInfo , die das zu flashende Bootloader-Image enthält |
Returns | |
---|---|
boolean |
true , wenn der Bootloader geflasht wurde, false , wenn er übersprungen wurde |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
if failed to flash bootloader |
checkAndFlashSystem
protected boolean checkAndFlashSystem (ITestDevice device, String systemBuildId, String systemBuildFlavor, IDeviceBuildInfo deviceBuild)
Flashen Sie bei Bedarf das System-Image auf dem Gerät.
Sehen Sie sich ERROR(/#shouldFlashSystem(String,String,com.android.tradefed.build.IDeviceBuildInfo))
an.
Unabhängig vom ausgewählten Pfad sollte das Gerät nach der Ausführung der Methode im Userspace starten.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
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 : die IDeviceBuildInfo , die das zu flashende System-Image enthält |
Returns | |
---|---|
boolean |
true , wenn das System geflasht wurde, false , wenn es übersprungen wurde |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
if failed to flash bootloader |
checkShouldFlashBaseband
protected boolean checkShouldFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)
Prüfen Sie, ob das Baseband auf dem bereitgestellten Gerät geflasht werden muss.
Parameter | |
---|---|
device |
ITestDevice : Die zu prüfende ITestDevice |
deviceBuild |
IDeviceBuildInfo : die IDeviceBuildInfo , die das zu prüfende Basisband-Image enthält |
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
if failed to flash baseband |
createFlashingResourcesParser
protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)
Factory-Methode zum Erstellen einer IFlashingResourcesParser
.
Für Unit-Tests freigegeben.
Parameter | |
---|---|
localBuild |
IDeviceBuildInfo : der zu parsende IDeviceBuildInfo |
descriptor |
DeviceDescriptor : Der Descriptor des zu flashenden Geräts. |
Returns | |
---|---|
IFlashingResourcesParser |
eine IFlashingResourcesParser , die mit der Factory-Methode erstellt wurde. |
Ausgabe | |
---|---|
|
com.android.tradefed.targetprep.TargetSetupError |
TargetSetupError |
downloadExtraImageFiles
protected void downloadExtraImageFiles (IFlashingResourcesParser resourceParser, IFlashingResourcesRetriever retriever, IDeviceBuildInfo localBuild)
Mit diesem Hook können untergeordnete Klassen bei Bedarf zusätzliche benutzerdefinierte Bilddateien herunterladen.
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)
Erforderliche zusätzliche Blinkbilddateien werden heruntergeladen
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , für die Ressourcen heruntergeladen werden sollen |
localBuild |
IDeviceBuildInfo : Die zu befüllende IDeviceBuildInfo . Es wird davon ausgegangen, dass die Geräte-Imagedatei bereits festgelegt ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
if failed to retrieve resources |
executeFastbootCmd
protected String executeFastbootCmd (ITestDevice device, String... cmdArgs)
Hilfsmethode zum Ausführen des Fastboot-Befehls.
Parameter | |
---|---|
device |
ITestDevice : ITestDevice , auf dem der Befehl ausgeführt werden soll |
cmdArgs |
String : die Argumente, die an „fastboot“ übergeben werden |
Returns | |
---|---|
String |
Gibt die stderr-Ausgabe des Befehls als String zurück, falls nicht leer. Andernfalls wird stdout zurückgegeben. Einige Fastboot-Befehle sind insofern merkwürdig, als dass sie die Ausgabe bei Erfolg in stderr drucken. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
Wenn der Fastboot-Befehl fehlschlägt |
executeLongFastbootCmd
protected String executeLongFastbootCmd (ITestDevice device, String... cmdArgs)
Hilfsmethode zum Ausführen eines lang laufenden Fastboot-Befehls.
Hinweis: Die meisten Fastboot-Befehle werden normalerweise innerhalb des von INativeDevice.executeFastbootCommand(String)
festgelegten Zeitlimits ausgeführt. Wenn jedoch mehrere Geräte gleichzeitig geflasht werden, können Fastboot-Befehle viel länger als normal dauern.
Parameter | |
---|---|
device |
ITestDevice : ITestDevice , auf dem der Befehl ausgeführt werden soll |
cmdArgs |
String : die Argumente, die an „fastboot“ übergeben werden |
Returns | |
---|---|
String |
Gibt die stderr-Ausgabe des Befehls als String zurück, falls nicht leer. Andernfalls wird stdout zurückgegeben. Einige Fastboot-Befehle sind insofern merkwürdig, als dass sie die Ausgabe bei Erfolg in stderr drucken. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
Wenn der Fastboot-Befehl fehlschlägt |
executeLongFastbootCmd
protected String executeLongFastbootCmd (ITestDevice device,envVarMap, String... cmdArgs)
Hilfsmethode zum Ausführen eines lang laufenden Fastboot-Befehls mit Umgebungsvariablen.
Hinweis: Die meisten Fastboot-Befehle werden normalerweise innerhalb des von INativeDevice.executeFastbootCommand(String)
festgelegten Zeitlimits ausgeführt. Wenn jedoch mehrere Geräte gleichzeitig geflasht werden, können Fastboot-Befehle viel länger als normal dauern.
Parameter | |
---|---|
device |
ITestDevice : 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 |
Returns | |
---|---|
String |
Gibt die stderr-Ausgabe des Befehls als String zurück, falls nicht leer. Andernfalls wird stdout zurückgegeben. Einige Fastboot-Befehle sind insofern merkwürdig, als dass sie die Ausgabe bei Erfolg in stderr drucken. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
Wenn der Fastboot-Befehl fehlschlägt |
flashBaseband
protected void flashBaseband (ITestDevice device, File basebandImageFile)
Das angegebene Baseband-Image wird geflasht und das Gerät wird neu im Bootloader gestartet.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
basebandImageFile |
File : das Basisbandbild ERROR(/File) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
if failed to flash baseband |
flashBootloader
protected void flashBootloader (ITestDevice device, File bootloaderImageFile)
Das angegebene Bootloader-Image wird geflasht und das Gerät wird neu im Bootloader gestartet.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
bootloaderImageFile |
File : das Bootloader-Image ERROR(/File) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
if failed to flash |
flashExtraImages
protected void flashExtraImages (ITestDevice device, IDeviceBuildInfo deviceBuild)
Flashen Sie alle gerätespezifischen Partitionen, bevor Sie das System flashen und neu starten. Wird nicht ausgeführt, sofern nicht überschrieben.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
deviceBuild |
IDeviceBuildInfo : die 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 : die ITestDevice , die geflasht werden soll |
imgFile |
File : ein ERROR(/File) , das auf das zu flashende Image verweist |
partition |
String : Name der zu flashenden 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)
Flashen Sie das System-Image auf dem Gerät.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
deviceBuild |
IDeviceBuildInfo : die IDeviceBuildInfo , die geflasht werden soll |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
Wenn der Fastboot-Befehl fehlschlägt |
flashUserData
protected void flashUserData (ITestDevice device, IDeviceBuildInfo deviceBuild)
Flash-Datenpartition auf dem Gerät
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
deviceBuild |
IDeviceBuildInfo : die IDeviceBuildInfo , die die zu flashenden Dateien enthält |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
if failed to flash user data |
flashUserDataFromDeviceImageFile
protected void flashUserDataFromDeviceImageFile (ITestDevice device, IDeviceBuildInfo deviceBuild)
Extrahiert die Datei „userdata.img“ aus der Geräte-Imagedatei und flasht sie auf das Gerät
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
deviceBuild |
IDeviceBuildInfo : die IDeviceBuildInfo , die die zu flashenden Dateien enthält |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
if failed to extract or flash user data |
getBootPartitionName
protected String getBootPartitionName ()
Rufen Sie den Namen der Bootpartition für diesen Geräte-Flasher ab.
Standardeinstellung: „bootloader“. Abgeleitete Klassen sollten dies gegebenenfalls überschreiben.
Returns | |
---|---|
String |
getBootloaderFilePrefix
protected String getBootloaderFilePrefix (ITestDevice device)
Bootloader-Dateipräfix abrufen
Die Standardeinstellung ist getBootPartitionName()
. Abgeleitete Klassen sollten dies gegebenenfalls überschreiben.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
Returns | |
---|---|
String |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
if failed to get prefix |
getCurrentSlot
protected String getCurrentSlot (ITestDevice device)
Hilfsmethode zum Abrufen des aktuellen Slots (für A/B-fähige Geräte).
Parameter | |
---|---|
device |
ITestDevice : ITestDevice , auf dem der Befehl ausgeführt werden soll. |
Returns | |
---|---|
String |
„a“, „b“ oder „null“ (wenn das Gerät keine A/B-Tests unterstützt) |
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)
Flashen der userdata/cache-Partition verarbeiten
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
deviceBuild |
IDeviceBuildInfo : die IDeviceBuildInfo , die die zu flashenden 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 beim Bootloader, ob die angegebene Partition vorhanden ist
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , auf die der Vorgang angewendet 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 Schritte vor dem Flashen aus. Hat keine Auswirkungen, es sei denn, er wird überschrieben.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die vorbereitet werden soll |
deviceBuild |
IDeviceBuildInfo : die IDeviceBuildInfo mit den Build-Dateien |
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
|
com.android.tradefed.targetprep.TargetSetupError |
DeviceNotAvailableException |
|
TargetSetupError |
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 das Flashen unterstützt.
Bei der Basisimplementierung wird geprüft, ob der deviceProductType in der IFlashingResourcesParser.getRequiredBoards()
-Sammlung enthalten ist. Abgeleitete Klassen können dies nach Bedarf überschreiben.
Parameter | |
---|---|
device |
ITestDevice : die zu flashende ITestDevice |
resourceParser |
IFlashingResourcesParser : die IFlashingResourcesParser |
deviceProductType |
String : der Produkttyp von device |
Ausgabe | |
---|---|
TargetSetupError |
wenn die erforderlichen Informationen zum Board des Builds nicht mit dem Gerät übereinstimmen |
wipeCache
protected void wipeCache (ITestDevice device)
Löschen Sie die Cache-Partition auf dem Gerät.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , die geflasht werden soll |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if device is not available |
TargetSetupError |
if failed to flash cache |
wipePartition
protected void wipePartition (ITestDevice device, String partition)
Löschen Sie die angegebene Partition mit „fastboot erase <name>“.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice , auf die der Vorgang angewendet werden soll |
partition |
String : Name der zu löschenden Partition |
Ausgabe | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |