Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.
Halaman ini diterjemahkan oleh Cloud Translation API.
Switch to English

FastbootDeviceFlasher

public class FastbootDeviceFlasher
extends Object implements IDeviceFlasher

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


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

Ringkasan

Fields

public static final String BASEBAND_IMAGE_NAME

Konstruktor publik

FastbootDeviceFlasher ()

Metode publik

void flash (ITestDevice device, IDeviceBuildInfo deviceBuild)

Flash dibangun di atas perangkat.

CommandStatus getSystemFlashingStatus ()

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

IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

void overrideDeviceOptions (ITestDevice device)

Ganti opsi untuk perangkat.

void setDataWipeSkipList ( dataWipeSkipList) setDataWipeSkipList ( dataWipeSkipList)

Setel daftar jalur di bawah /data untuk menghindari pembersihan saat menggunakan ITestsZipInstaller

Perhatikan bahwa perincian daftar lewati adalah turunan langsung dari /data .

void setFlashOptions ( flashOptions) setFlashOptions ( flashOptions)

Menetapkan daftar opsi untuk dilewati dengan perintah flash / update.

void setFlashingResourcesRetriever ( IFlashingResourcesRetriever retriever)

Menyetel mekanisme agar flasher dapat mengambil file sumber daya untuk di-flash.

void setForceSystemFlash (boolean forceSystemFlash)

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

void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

void setUserDataFlashOption ( IDeviceFlasher.UserDataFlashOption flashOption)

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

void setWipeTimeout (long timeout)

Setel batas waktu untuk menghapus data.

boolean shouldFlashRamdisk ()

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

Metode yang dilindungi

void checkAndFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)

Jika perlu, flash gambar pita dasar 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 image sistem pada perangkat.

boolean checkShouldFlashBaseband (ITestDevice device, IDeviceBuildInfo deviceBuild)

Periksa apakah baseband pada perangkat yang disediakan perlu di-flash.

IFlashingResourcesParser createFlashingResourcesParser ( IDeviceBuildInfo localBuild, DeviceDescriptor descriptor)

Metode pabrik untuk membuat IFlashingResourcesParser .

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

Hook untuk mengizinkan subclass mengunduh file gambar kustom tambahan jika diperlukan.

void downloadFlashingResources (ITestDevice device, IDeviceBuildInfo localBuild)

Unduh file gambar berkedip tambahan 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 gambar baseband yang diberikan dan reboot kembali ke bootloader

void flashBootloader (ITestDevice device, File bootloaderImageFile)

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

void flashExtraImages (ITestDevice device, IDeviceBuildInfo deviceBuild)

Flash partisi khusus perangkat apa pun sebelum menginstal sistem dan melakukan 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 gambar sistem pada perangkat.

void flashUserData (ITestDevice device, IDeviceBuildInfo deviceBuild)

Flash partisi data pengguna pada perangkat.

void flashUserDataFromDeviceImageFile (ITestDevice device, IDeviceBuildInfo deviceBuild)

Ekstrak userdata.img dari file image perangkat dan flash 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 yang mendukung A / B).

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

Metode pembantu untuk mendapatkan versi gambar saat ini di perangkat.

IRunUtil getRunUtil ()

Dipaparkan untuk pengujian.

void handleUserDataFlashing (ITestDevice device, IDeviceBuildInfo deviceBuild)

Tangani flashing partisi userdata / 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-flashing tambahan yang diperlukan.

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

Verifikasi bahwa jenis produk perangkat mendukung build-to-be-flash.

void wipeCache (ITestDevice device)

Hapus partisi cache di perangkat.

void wipePartition (ITestDevice device, String partition)

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

Fields

BASEBAND_IMAGE_NAME

public static final String BASEBAND_IMAGE_NAME

Konstruktor publik

FastbootDeviceFlasher

public FastbootDeviceFlasher ()

Metode publik

flash

public void flash (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flash dibangun di atas perangkat.

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

Parameter
device ITestDevice : ITestDevice akan di-flash

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo akan di-flash

Melempar
DeviceNotAvailableException
TargetSetupError

getSystemFlashingStatus

public CommandStatus getSystemFlashingStatus ()

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

Perhatikan bahwa jika partisi sistem tidak di-flash (sistem sudah memiliki build yang akan di-flash) status perintah mungkin null

Kembali
CommandStatus

getUserDataFlashOption

public IDeviceFlasher.UserDataFlashOption getUserDataFlashOption ()

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

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

overrideDeviceOptions

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)
.dll

Setel daftar jalur di bawah /data untuk menghindari pembersihan saat menggunakan ITestsZipInstaller

Perhatikan bahwa perincian daftar lewati adalah turunan langsung dari /data .

Parameter
dataWipeSkipList

setFlashOptions

public void setFlashOptions ( flashOptions)

Menetapkan daftar opsi untuk dilewati dengan perintah flash / update.

setFlashingResourcesRetriever

public void setFlashingResourcesRetriever (IFlashingResourcesRetriever retriever)

Menyetel mekanisme agar flasher dapat mengambil file sumber daya untuk mem-flash.

Parameter
retriever IFlashingResourcesRetriever : IFlashingResourcesRetriever untuk digunakan

setForceSystemFlash

public void setForceSystemFlash (boolean forceSystemFlash)

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

setShouldFlashRamdisk

public void setShouldFlashRamdisk (boolean shouldFlashRamdisk)

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

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

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

setWipeTimeout

public void setWipeTimeout (long timeout)

Setel batas waktu untuk menghapus data.

Parameter
timeout long

shouldFlashRamdisk

public boolean shouldFlashRamdisk ()

Memeriksa apakah flasher diatur agar memiliki ramdisk tambahan 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 gambar pita dasar pada perangkat. Hanya akan mem-flash baseband jika versi saat ini di perangkat! = Versi yang diperlukan

Parameter
device ITestDevice : ITestDevice akan di-flash

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo yang berisi gambar pita dasar untuk di-flash

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal 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 : ITestDevice akan di-flash

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo yang berisi image bootloader untuk di-flash

Kembali
boolean true jika bootloader di-flash, false jika 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 image sistem pada perangkat.

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

Terlepas dari jalur yang dipilih, perangkat setelah eksekusi metode harus melakukan booting ke dalam ruang pengguna.

Parameter
device ITestDevice : ITestDevice akan di-flash

systemBuildId String : ID build saat ini yang berjalan di perangkat

systemBuildFlavor String : ragam build saat ini yang berjalan di perangkat

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo yang berisi image sistem untuk di-flash

Kembali
boolean true jika sistem di-flash, false jika dilewati

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

checkShouldFlashBaseband

protected boolean checkShouldFlashBaseband (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Periksa apakah baseband pada perangkat yang disediakan perlu di-flash.

Parameter
device ITestDevice : ITestDevice akan diperiksa

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo yang berisi gambar pita dasar untuk diperiksa

Kembali
boolean

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

createFlashingResourcesParser

protected IFlashingResourcesParser createFlashingResourcesParser (IDeviceBuildInfo localBuild, 
                DeviceDescriptor descriptor)

Metode pabrik untuk membuat IFlashingResourcesParser .

Dipaparkan untuk pengujian unit.

Parameter
localBuild IDeviceBuildInfo : IDeviceBuildInfo akan diurai

descriptor DeviceDescriptor : deskriptor perangkat yang sedang di-flash.

Kembali
IFlashingResourcesParser sebuah IFlashingResourcesParser dibuat dengan metode pabrik.

Melempar
TargetSetupError

downloadExtraImageFiles

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

Hook untuk mengizinkan subclass mendownload file gambar kustom tambahan jika diperlukan.

Parameter
resourceParser IFlashingResourcesParser : IFlashingResourcesParser

retriever IFlashingResourcesRetriever : IFlashingResourcesRetriever

localBuild IDeviceBuildInfo : IDeviceBuildInfo

Melempar
TargetSetupError

downloadFlashingResources

protected void downloadFlashingResources (ITestDevice device, 
                IDeviceBuildInfo localBuild)

Unduh file gambar berkedip tambahan yang diperlukan

Parameter
device ITestDevice : ITestDevice untuk mendownload resource

localBuild IDeviceBuildInfo : IDeviceBuildInfo akan diisi. Menganggap 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 : ITestDevice menjalankan perintah

cmdArgs String : argumen yang akan diberikan ke fastboot

Kembali
String String output stderr dari perintah jika tidak kosong. Jika tidak mengembalikan 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

executeLongFastbootCmd

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

Metode pembantu untuk menjalankan perintah fastboot yang sudah berjalan lama.

Catatan: Sebagian besar perintah fastboot biasanya dijalankan dalam waktu tunggu yang diizinkan oleh ITestDevice#executeFastbootCommand(String...) . Namun, ketika beberapa perangkat mem-flash perangkat sekaligus, perintah fastboot bisa memakan waktu lebih lama dari biasanya.

Parameter
device ITestDevice : ITestDevice menjalankan perintah

cmdArgs String : argumen yang akan diberikan ke fastboot

Kembali
String String output stderr dari perintah jika tidak kosong. Jika tidak, kembalikan stdout Beberapa perintah fastboot aneh karena 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 gambar baseband yang diberikan dan reboot kembali ke bootloader

Parameter
device ITestDevice : ITestDevice akan di-flash

basebandImageFile File : gambar baseband ERROR(/File)

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

flashBootloader

protected void flashBootloader (ITestDevice device, 
                File bootloaderImageFile)

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

Parameter
device ITestDevice : ITestDevice akan di-flash

bootloaderImageFile File : gambar bootloader ERROR(/File)

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal flash

flashExtraImages

protected void flashExtraImages (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)
.dll

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

Parameter
device ITestDevice : ITestDevice akan di-flash

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo berisi file build

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

flashPartition

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

Flash partisi individual perangkat

Parameter
device ITestDevice : ITestDevice akan di-flash

imgFile File : ERROR(/File) mengarah ke gambar yang akan di-flash

partition String : nama partisi yang akan di-flash

Melempar
DeviceNotAvailableException
TargetSetupError

flashRamdiskIfNeeded

protected void flashRamdiskIfNeeded (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Parameter
device ITestDevice

deviceBuild IDeviceBuildInfo

Melempar
DeviceNotAvailableException
TargetSetupError

flashSystem

protected void flashSystem (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Flash gambar sistem pada perangkat.

Parameter
device ITestDevice : ITestDevice akan di-flash

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo akan di-flash

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika perintah fastboot gagal

flashUserData

protected void flashUserData (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)
.dll

Flash partisi data pengguna pada perangkat.

Parameter
device ITestDevice : ITestDevice akan di-flash

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo yang berisi file yang akan di-flash

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

flashUserDataFromDeviceImageFile

protected void flashUserDataFromDeviceImageFile (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Ekstrak userdata.img dari file image perangkat dan flash ke perangkat

Parameter
device ITestDevice : ITestDevice akan di-flash

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo yang berisi file yang akan di-flash

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-nya adalah 'bootloader'. Subclass harus diganti jika perlu.

Kembali
String

getBootloaderFilePrefix

protected String getBootloaderFilePrefix (ITestDevice device)

Dapatkan awalan file bootloader.

Default-nya adalah getBootPartitionName() . Subclass harus diganti jika perlu.

Parameter
device ITestDevice : ITestDevice akan di-flash

Kembali
String

Melempar
DeviceNotAvailableException jika perangkat tidak tersedia
TargetSetupError jika gagal mendapatkan awalan

getCurrentSlot

protected String getCurrentSlot (ITestDevice device)

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

Parameter
device ITestDevice : ITestDevice menjalankan perintah.

Kembali
String "a", "b" atau null (jika perangkat tidak mendukung 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 : ITestDevice menjalankan perintah

imageName String : nama gambar yang akan diambil.

Kembali
String String output stdout dari perintah

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

getRunUtil

protected IRunUtil getRunUtil ()

Dipaparkan untuk pengujian.

Kembali
IRunUtil

handleUserDataFlashing

protected void handleUserDataFlashing (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Tangani flashing partisi userdata / cache

Parameter
device ITestDevice : ITestDevice akan di-flash

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo yang berisi file yang akan di-flash

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

hasPartition

protected boolean hasPartition (ITestDevice device, 
                String partition)

Periksa dengan bootloader apakah partisi yang ditentukan ada atau tidak

Parameter
device ITestDevice : ITestDevice untuk dioperasikan

partition String : nama partisi yang akan diperiksa

Kembali
boolean

Melempar
DeviceNotAvailableException

preFlashSetup

protected void preFlashSetup (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Lakukan pengaturan pra-flashing tambahan yang diperlukan. Tanpa operasi kecuali diganti.

Parameter
device ITestDevice : ITestDevice harus disiapkan

deviceBuild IDeviceBuildInfo : IDeviceBuildInfo berisi file build

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

verifikasiRequiredBoards

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

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

Implementasi dasar akan memverifikasi bahwa deviceProductType disertakan dalam IFlashingResourcesParser#getRequiredBoards() . Subkelas dapat diganti sesuai keinginan.

Parameter
device ITestDevice : ITestDevice akan di-flash

resourceParser IFlashingResourcesParser : IFlashingResourcesParser

deviceProductType String : jenis produk device

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

wipeCache

protected void wipeCache (ITestDevice device)

Hapus partisi cache di perangkat.

Parameter
device ITestDevice : ITestDevice akan di-flash

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

wipePartition

protected void wipePartition (ITestDevice device, 
                String partition)

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

Parameter
device ITestDevice : ITestDevice untuk dioperasikan

partition String : nama partisi yang akan dihapus

Melempar
DeviceNotAvailableException
TargetSetupError