Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

FastbootDeviceFlasher

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

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

Kelas yang mengandalkan fastboot untuk mem-flash gambar pada perangkat keras Android fisik.

Ringkasan

bidang

public static final String BASEBAND_IMAGE_NAME

Konstruktor publik

FastbootDeviceFlasher ()

Metode publik

void flash (ITestDevice device, IDeviceBuildInfo deviceBuild)

Flash dibangun di perangkat.

CommandStatus getSystemFlashingStatus ()

Ambil status eksekusi perintah untuk mem-flash partisi sistem utama.

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Mendapatkan apakah gambar data pengguna harus di-flash, dihapus, atau dipertahankan

void overrideDeviceOptions (ITestDevice device)

Ganti opsi untuk perangkat.

void setDataWipeSkipList ( dataWipeSkipList) setDataWipeSkipList ( dataWipeSkipList)

Set daftar jalur bawah /data untuk kliring menghindari ketika menggunakan ITestsZipInstaller

Perhatikan bahwa rincian dari daftar melompat adalah anak-anak langsung /data .

void setFlashOptions ( flashOptions) setFlashOptions ( flashOptions)

Menetapkan daftar opsi untuk diteruskan dengan perintah flash/perbarui.

void setFlashingResourcesRetriever ( IFlashingResourcesRetriever retriever)

Mengatur mekanisme di mana flasher dapat mengambil file sumber daya untuk flashing.

void setForceSystemFlash (boolean forceSystemFlash)

Menyetel apakah sistem harus selalu di-flash meskipun menjalankan build saat ini

void setRamdiskPartition (String ramdiskPartition)

Setel partisi ramdisk

void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Menyetel apakah ramdisk tambahan harus di-flash setelah memperbarui perangkat melalui zip gambar

void setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)

Beralih apakah gambar data pengguna harus di-flash, dihapus, atau dipertahankan

void setWipeTimeout (long timeout)

Atur batas waktu untuk menghapus data.

boolean shouldFlashRamdisk ()

Memeriksa apakah flasher diatur untuk memiliki ramdisk tambahan yang harus di-flash setelah memperbarui perangkat melalui zip gambar

Metode yang dilindungi

void checkAndFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)

Jika perlu, flash image baseband pada perangkat.

boolean checkAndFlashBootloader (ITestDevice device, IDeviceBuildInfo deviceBuild)

Jika perlu, flash image bootloader pada perangkat.

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

Jika perlu, flash citra sistem pada perangkat.

boolean checkShouldFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)

Periksa apakah pita dasar pada perangkat yang disediakan perlu di-flash.

IFlashingResourcesParser createFlashingResourcesParser ( IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)

Metode pabrik untuk menciptakan IFlashingResourcesParser .

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

Kaitkan untuk mengizinkan subkelas mengunduh file gambar khusus tambahan jika diperlukan.

void downloadFlashingResources (ITestDevice device, IDeviceBuildInfo localBuild)

Unduh file gambar berkedip ekstra yang diperlukan

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

Metode pembantu untuk menjalankan perintah fastboot.

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

Metode pembantu untuk menjalankan perintah fastboot yang sudah berjalan lama.

void flashBaseband (ITestDevice device, File basebandImageFile)

Flash image baseband yang diberikan dan reboot kembali ke bootloader

void flashBootloader (ITestDevice device, File bootloaderImageFile)

Mem-flash image bootloader yang diberikan dan mem-boot ulang kembali ke bootloader

void flashExtraImages (ITestDevice device, IDeviceBuildInfo deviceBuild)

Flash partisi khusus perangkat apa pun sebelum mem-flash sistem dan mem-boot ulang.

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

Flash partisi individual perangkat

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

Flash citra sistem pada perangkat.

void flashUserData (ITestDevice device, IDeviceBuildInfo deviceBuild)

Flash partisi data pengguna pada perangkat.

void flashUserDataFromDeviceImageFile (ITestDevice device, IDeviceBuildInfo deviceBuild)

Mengekstrak userdata.img dari file gambar perangkat dan mem-flash-nya ke perangkat

String getBootPartitionName ()

Dapatkan nama partisi boot untuk flasher perangkat ini.

String getBootloaderFilePrefix (ITestDevice device)

Dapatkan awalan file bootloader.

String getCurrentSlot (ITestDevice device)

Metode pembantu untuk mengambil slot saat ini (untuk perangkat berkemampuan A/B).

IFlashingResourcesRetriever getFlashingResourcesRetriever ()
String getImageVersion (ITestDevice device, String imageName)

Metode pembantu untuk mendapatkan versi gambar saat ini di perangkat.

IRunUtil getRunUtil ()

Diekspos untuk pengujian.

void handleUserDataFlashing (ITestDevice device, IDeviceBuildInfo deviceBuild)

Menangani flashing data pengguna/partisi cache

boolean hasPartition (ITestDevice device, String partition)

Periksa dengan bootloader apakah partisi yang ditentukan ada atau tidak

void preFlashSetup (ITestDevice device, IDeviceBuildInfo deviceBuild)

Lakukan pengaturan pra-flash tambahan yang diperlukan.

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

Pastikan jenis produk perangkat mendukung build-to-be-flash.

void wipeCache (ITestDevice device)

Bersihkan partisi cache pada perangkat.

void wipePartition (ITestDevice device, String partition)

Hapus partisi yang ditentukan dengan `fastboot erase <name>`

bidang

BASEBAND_IMAGE_NAME

public static final String BASEBAND_IMAGE_NAME

Konstruktor publik

FastbootDeviceFlasher

public FastbootDeviceFlasher ()

Metode publik

kilatan

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flash dibangun di perangkat.

Kembali segera setelah flashing selesai. Penelepon harus menunggu perangkat online dan tersedia sebelum melanjutkan pengujian.

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

deviceBuild IDeviceBuildInfo : yang IDeviceBuildInfo ke flashdisk

Melempar
DeviceNotAvailableException
TargetSetupError

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

Ambil status eksekusi perintah untuk mem-flash partisi sistem utama.

Perhatikan bahwa jika partisi sistem tidak melintas (sistem yang sudah memiliki membangun yang akan melintas) status perintah mungkin null

Kembali
CommandStatus

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

Mendapatkan apakah gambar data pengguna harus di-flash, dihapus, atau dipertahankan

Kembali
IDeviceFlasher.UserDataFlashOption Apakah gambar data pengguna harus di-flash, dihapus, atau dipertahankan

menimpaOpsiPerangkat

public void overrideDeviceOptions (ITestDevice device)

Ganti opsi untuk perangkat. Digunakan untuk mengganti nilai opsi default jika default tidak didukung oleh perangkat tertentu.

setDataWipeSkipList

public void setDataWipeSkipList ( dataWipeSkipList)

Set daftar jalur bawah /data untuk kliring menghindari ketika menggunakan ITestsZipInstaller

Perhatikan bahwa rincian dari daftar melompat adalah anak-anak langsung /data .

Parameter
dataWipeSkipList

setFlashOptions

public void setFlashOptions ( flashOptions)

Menetapkan daftar opsi untuk diteruskan dengan perintah flash/perbarui.

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Mengatur mekanisme di mana flasher dapat mengambil file sumber daya untuk flashing.

Parameter
retriever IFlashingResourcesRetriever : yang IFlashingResourcesRetriever penggunaan

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

Menyetel apakah sistem harus selalu di-flash meskipun menjalankan build saat ini

set RamdiskPartition

public void setRamdiskPartition (String ramdiskPartition)

Setel partisi ramdisk

setHarusFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

Menyetel apakah ramdisk tambahan harus di-flash setelah memperbarui perangkat melalui zip gambar

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Beralih apakah gambar data pengguna harus di-flash, dihapus, atau dipertahankan

atur WipeTimeout

public void setWipeTimeout (long timeout)

Atur batas waktu untuk menghapus data.

Parameter
timeout long

harusFlashRamdisk

public boolean shouldFlashRamdisk ()

Memeriksa apakah flasher diatur untuk memiliki ramdisk tambahan yang harus di-flash setelah memperbarui perangkat melalui zip gambar

Kembali
boolean

Metode yang dilindungi

checkAndFlashBaseband

protected void checkAndFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Jika perlu, flash image baseband pada perangkat. Hanya akan mem-flash baseband jika versi saat ini di perangkat != versi yang diperlukan

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

deviceBuild IDeviceBuildInfo : yang IDeviceBuildInfo yang berisi gambar baseband ke flash

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal untuk mem-flash baseband

checkAndFlashBootloader

protected boolean checkAndFlashBootloader (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Jika perlu, flash image bootloader pada perangkat.

Hanya akan mem-flash bootloader jika versi saat ini di perangkat != versi yang diperlukan.

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

deviceBuild IDeviceBuildInfo : yang IDeviceBuildInfo yang berisi gambar bootloader untuk flash

Kembali
boolean true jika bootloader itu berkelebat, false apakah itu dilewati

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal mem-flash bootloader

checkAndFlashSystem

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

Jika perlu, flash citra sistem pada perangkat.

Silakan lihat ERROR(/#shouldFlashSystem(String,String,com.android.tradefed.build.IDeviceBuildInfo))

Terlepas dari jalur yang dipilih, perangkat setelah eksekusi metode harus boot ke ruang pengguna.

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

systemBuildId String : membangun saat ini id berjalan pada perangkat

systemBuildFlavor String : membangun saat rasa berjalan pada perangkat

deviceBuild IDeviceBuildInfo : yang IDeviceBuildInfo yang berisi sistem image ke flash

Kembali
boolean true jika sistem itu berkelebat, false apakah itu dilewati

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal mem-flash bootloader

checkShouldFlashBaseband

protected boolean checkShouldFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Periksa apakah pita dasar pada perangkat yang disediakan perlu di-flash.

Parameter
device ITestDevice : yang ITestDevice untuk cek

deviceBuild IDeviceBuildInfo : yang IDeviceBuildInfo yang berisi gambar baseband untuk memeriksa

Kembali
boolean

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal untuk mem-flash baseband

buatFlashingResourcesParser

protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, 
                DeviceDescriptor descriptor)

Metode pabrik untuk menciptakan IFlashingResourcesParser .

Terkena untuk pengujian unit.

Parameter
localBuild IDeviceBuildInfo : yang IDeviceBuildInfo untuk mengurai

descriptor DeviceDescriptor : deskriptor perangkat yang melintas.

Kembali
IFlashingResourcesParser sebuah IFlashingResourcesParser diciptakan oleh metode pabrik.

Melempar
TargetSetupError

unduhExtraImageFiles

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

Kaitkan untuk mengizinkan subkelas mengunduh file gambar khusus tambahan jika diperlukan.

Parameter
resourceParser IFlashingResourcesParser : yang IFlashingResourcesParser

retriever IFlashingResourcesRetriever : yang IFlashingResourcesRetriever

localBuild IDeviceBuildInfo : yang IDeviceBuildInfo

Melempar
TargetSetupError

unduhFlashingResources

protected void downloadFlashingResources (ITestDevice device, 
                IDeviceBuildInfo localBuild)

Unduh file gambar berkedip ekstra yang diperlukan

Parameter
device ITestDevice : yang ITestDevice untuk download sumber daya untuk

localBuild IDeviceBuildInfo : yang IDeviceBuildInfo untuk mengisi. Asumsikan file gambar perangkat sudah disetel

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal mengambil sumber daya

eksekusiFastbootCmd

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

Metode pembantu untuk menjalankan perintah fastboot.

Parameter
device ITestDevice : yang ITestDevice untuk mengeksekusi perintah pada

cmdArgs String : argumen untuk memberikan ke fastboot

Kembali
String String output stderr dari perintah jika tidak kosong. Jika tidak, kembalikan stdout Beberapa perintah fastboot aneh karena mereka membuang output ke stderr pada kasus sukses

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika perintah fastboot gagal

eksekusiLongFastbootCmd

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

Metode pembantu untuk menjalankan perintah fastboot yang sudah berjalan lama.

Catatan: Sebagian besar perintah fastboot biasanya mengeksekusi dalam batas waktu yang diizinkan oleh INativeDevice.executeFastbootCommand(String) . Namun, ketika beberapa perangkat mem-flash perangkat sekaligus, perintah fastboot dapat memakan waktu lebih lama dari biasanya.

Parameter
device ITestDevice : yang ITestDevice untuk mengeksekusi perintah pada

cmdArgs String : argumen untuk memberikan ke fastboot

Kembali
String String output stderr dari perintah jika tidak kosong. Jika tidak, kembalikan stdout Beberapa perintah fastboot aneh karena mereka membuang output ke stderr pada kasus sukses

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika perintah fastboot gagal

flashBaseband

protected void flashBaseband (ITestDevice device, 
                File basebandImageFile)

Flash image baseband yang diberikan dan reboot kembali ke bootloader

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

basebandImageFile File : baseband image ERROR(/File)

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal untuk mem-flash baseband

flashBootloader

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile)

Mem-flash image bootloader yang diberikan dan mem-boot ulang kembali ke bootloader

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

bootloaderImageFile File : bootloader image ERROR(/File)

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal untuk berkedip

flashEkstraGambar

protected void flashExtraImages (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flash partisi khusus perangkat apa pun sebelum mem-flash sistem dan mem-boot ulang. Tidak ada operasi kecuali diganti.

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

deviceBuild IDeviceBuildInfo : yang IDeviceBuildInfo berisi file build

Melempar
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

flashPartisi

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

Flash partisi individual perangkat

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

imgFile File : a ERROR(/File) menunjuk ke gambar yang akan melintas

partition String : nama partisi yang akan melintas

Melempar
DeviceNotAvailableException
TargetSetupError

flashRamdiskJika Diperlukan

protected void flashRamdiskIfNeeded (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Parameter
device ITestDevice

deviceBuild IDeviceBuildInfo

Melempar
DeviceNotAvailableException
TargetSetupError

sistem flash

protected void flashSystem (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flash citra sistem pada perangkat.

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

deviceBuild IDeviceBuildInfo : yang IDeviceBuildInfo ke flashdisk

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika perintah fastboot gagal

flashDataPengguna

protected void flashUserData (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flash partisi data pengguna pada perangkat.

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

deviceBuild IDeviceBuildInfo : yang IDeviceBuildInfo yang berisi file ke flashdisk

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal mem-flash data pengguna

flashUserDataFromDeviceImageFile

protected void flashUserDataFromDeviceImageFile (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Mengekstrak userdata.img dari file gambar perangkat dan mem-flash-nya ke perangkat

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

deviceBuild IDeviceBuildInfo : yang IDeviceBuildInfo yang berisi file ke flashdisk

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal mengekstrak atau mem-flash data pengguna

getBootPartitionName

protected String getBootPartitionName ()

Dapatkan nama partisi boot untuk flasher perangkat ini.

Default ke 'bootloader'. Subclass harus ditimpa jika perlu.

Kembali
String

getBootloaderFilePrefix

protected String getBootloaderFilePrefix (ITestDevice device)

Dapatkan awalan file bootloader.

Default getBootPartitionName() . Subclass harus ditimpa jika perlu.

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

Kembali
String

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal mendapatkan awalan

dapatkanCurrentSlot

protected String getCurrentSlot (ITestDevice device)

Metode pembantu untuk mengambil slot saat ini (untuk perangkat berkemampuan A/B).

Parameter
device ITestDevice : yang ITestDevice untuk mengeksekusi perintah pada.

Kembali
String "a", "b" atau null (jika perangkat tidak mampu A/B)

Melempar
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

getFlashingResourcesRetriever

protected IFlashingResourcesRetriever getFlashingResourcesRetriever ()

Kembali
IFlashingResourcesRetriever

getImageVersion

protected String getImageVersion (ITestDevice device, 
                String imageName)

Metode pembantu untuk mendapatkan versi gambar saat ini di perangkat.

Parameter
device ITestDevice : yang ITestDevice untuk mengeksekusi perintah pada

imageName String : nama gambar untuk mendapatkan.

Kembali
String String output stdout dari perintah

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika perintah fastboot gagal atau versi tidak dapat ditentukan

getRunUtil

protected IRunUtil getRunUtil ()

Diekspos untuk pengujian.

Kembali
IRunUtil

handleUserDataFlashing

protected void handleUserDataFlashing (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Menangani flashing data pengguna/partisi cache

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

deviceBuild IDeviceBuildInfo : yang IDeviceBuildInfo yang berisi file ke flashdisk

Melempar
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

memiliki Partisi

protected boolean hasPartition (ITestDevice device, 
                String partition)

Periksa dengan bootloader apakah partisi yang ditentukan ada atau tidak

Parameter
device ITestDevice : yang ITestDevice untuk beroperasi pada

partition String : nama partisi yang akan diperiksa

Kembali
boolean

Melempar
DeviceNotAvailableException

praFlashSetup

protected void preFlashSetup (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Lakukan pengaturan pra-flash tambahan yang diperlukan. Tidak ada operasi kecuali diganti.

Parameter
device ITestDevice : yang ITestDevice untuk mempersiapkan

deviceBuild IDeviceBuildInfo : yang IDeviceBuildInfo berisi file build

Melempar
com.android.tradefed.device.DeviceNotAvailableException
TargetSetupError
DeviceNotAvailableException

verifikasiDiperlukanPapan

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

Pastikan jenis produk perangkat mendukung build-to-be-flash.

Implementasi basis akan memverifikasi bahwa deviceProductType yang termasuk dalam IFlashingResourcesParser.getRequiredBoards() koleksi. Subclass dapat ditimpa sesuai keinginan.

Parameter
device ITestDevice : yang ITestDevice untuk melintas

resourceParser IFlashingResourcesParser : yang IFlashingResourcesParser

deviceProductType String : para device 's jenis produk

Melempar
TargetSetupError jika info papan yang diperlukan build tidak cocok dengan perangkat

hapus cache

protected void wipeCache (ITestDevice device)

Bersihkan partisi cache pada perangkat.

Parameter
device ITestDevice : yang ITestDevice ke flashdisk

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal mem-flash cache

hapus partisi

protected void wipePartition (ITestDevice device, 
                String partition)

Hapus partisi yang ditentukan dengan `fastboot erase <name>`

Parameter
device ITestDevice : yang ITestDevice untuk beroperasi pada

partition String : nama partisi yang akan dihapus

Melempar
DeviceNotAvailableException
TargetSetupError