Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

DeviceFlashPreparer

public abstract class DeviceFlashPreparer
extends BaseTargetPreparer implements IConfigurationReceiver, ITestLoggerReceiver

java.lang.Object
↳	com.android.tradefed.targetprep.BaseTargetPreparer
	↳	com.android.tradefed.targetprep.DeviceFlashPreparer

Subclass langsung yang dikenal

FastbootUpdateBootstrapPreparer

FastbootUpdateBootstrapPreparer ITargetPreparer yang melakukan staging file yang ditentukan (bootloader, radio, zip image perangkat) ke IDeviceBuildInfo untuk mem-flash perangkat dengan FastbootDeviceFlasher, lalu memasukkan atribut perangkat pasca-booting ke info build untuk tujuan pelaporan hasil.

ITargetPreparer yang mem-flash image pada hardware Android fisik.

Ringkasan

Konstruktor publik
`DeviceFlashPreparer()`

Metode publik
`void`	`addAllowedBranchForTransitionInIncremental(String branch)`
`void`	`addBranchTransitionInIncremental(String origin, String destination)`
`IBuildInfo`	`getBuild(TestInformation testInfo)` Gabungkan getBuildInfo sehingga kita memiliki perubahan untuk menggantinya untuk skenario tertentu.
`ITestLogger`	`getTestLogger()`
`boolean`	`isIncrementalFlashingEnabled()`
`boolean`	`isIncrementalFlashingForceDisabled()`
`void`	`setAllowCrossReleaseFlashing(boolean allowCrossReleaseFlashing)`
`void`	`setAllowUnzipBaseline(boolean allowUnzipBaseline)`
`void`	`setApplySnapshot(boolean applySnapshot)`
`void`	`setConfiguration(IConfiguration configuration)` Memasukkan `IConfiguration` yang digunakan.
`void`	`setIgnoreHostOptions(boolean ignoreHostOptions)`
`void`	`setTestLogger(ITestLogger testLogger)` Memasukkan instance `ITestLogger`
`void`	`setUp(TestInformation testInfo)`
`void`	`setUpdateBootloaderFromUserspace(boolean updateBootloaderFromUserspace)`
`void`	`setUseIncrementalNewFlow(boolean useIncrementalNewFlow)`
`void`	`setUserDataFlashOption(IDeviceFlasher.UserDataFlashOption flashOption)` Menetapkan opsi userdata-flash
`void`	`setWipeAfterApplySnapshot(boolean wipeAfterApplySnapshot)`
`void`	`tearDown(TestInformation testInfo, Throwable e)`
`void`	`useMerkleTreeComparison(boolean enableMerkleTreeComparison)`

Metode yang dilindungi
`void`	`checkDeviceProductType(ITestDevice device, IDeviceBuildInfo deviceBuild)` Pemeriksaan yang mungkin dilakukan sebelum flashing untuk memastikan perangkat sesuai dengan yang diharapkan dibandingkan dengan info build.
`abstract IDeviceFlasher`	`createFlasher(ITestDevice device)` Buat `IDeviceFlasher` untuk digunakan.
`long`	`getDeviceBootWaitTime()` Mendapatkan waktu tunggu booting perangkat
`IHostOptions`	`getHostOptions()` Mendapatkan instance `IHostOptions` yang akan digunakan.
`void`	`reportFlashMetrics(String branch, String buildFlavor, String buildId, String serial, long queueTime, long flashingTime, CommandStatus flashingStatus)` Melaporkan data pengaturan waktu flash perangkat ke backend metrik
`void`	`setSkipPostFlashBuildIdCheck(boolean skipPostFlashBuildIdCheck)`
`void`	`setUseIncrementalFlashing(boolean incrementalFlashing)`

Konstruktor publik

DeviceFlashPreparer

public DeviceFlashPreparer ()

Metode publik

addAllowedBranchForTransitionInIncremental

public void addAllowedBranchForTransitionInIncremental (String branch)

Parameter
`branch`	`String`

addBranchTransitionInIncremental

public void addBranchTransitionInIncremental (String origin, 
                String destination)

Parameter
`origin`	`String`
`destination`	`String`

getBuild

public IBuildInfo getBuild (TestInformation testInfo)

Gabungkan getBuildInfo sehingga kita memiliki perubahan untuk menggantinya untuk skenario tertentu.

Parameter
`testInfo`	`TestInformation`

Hasil
`IBuildInfo`

getTestLogger

public ITestLogger getTestLogger ()

Hasil
`ITestLogger`

isIncrementalFlashingEnabled

public boolean isIncrementalFlashingEnabled ()

Hasil
`boolean`

isIncrementalFlashingForceDisabled

public boolean isIncrementalFlashingForceDisabled ()

Hasil
`boolean`

setAllowCrossReleaseFlashing

public void setAllowCrossReleaseFlashing (boolean allowCrossReleaseFlashing)

Parameter
`allowCrossReleaseFlashing`	`boolean`

setAllowUnzipBaseline

public void setAllowUnzipBaseline (boolean allowUnzipBaseline)

Parameter
`allowUnzipBaseline`	`boolean`

setApplySnapshot

public void setApplySnapshot (boolean applySnapshot)

Parameter
`applySnapshot`	`boolean`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Memasukkan IConfiguration yang digunakan.

Parameter
`configuration`	`IConfiguration`

setIgnoreHostOptions

public void setIgnoreHostOptions (boolean ignoreHostOptions)

Parameter
`ignoreHostOptions`	`boolean`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Memasukkan instance ITestLogger

Parameter
`testLogger`	`ITestLogger`

setUp

public void setUp (TestInformation testInfo)

Parameter
`testInfo`	`TestInformation`

Menampilkan
`BuildError`
`DeviceNotAvailableException`
`TargetSetupError`

setUpdateBootloaderFromUserspace

public void setUpdateBootloaderFromUserspace (boolean updateBootloaderFromUserspace)

Parameter
`updateBootloaderFromUserspace`	`boolean`

setUseIncrementalNewFlow

public void setUseIncrementalNewFlow (boolean useIncrementalNewFlow)

Parameter
`useIncrementalNewFlow`	`boolean`

setUserDataFlashOption

public void setUserDataFlashOption (IDeviceFlasher.UserDataFlashOption flashOption)

Menetapkan opsi userdata-flash

setWipeAfterApplySnapshot

public void setWipeAfterApplySnapshot (boolean wipeAfterApplySnapshot)

Parameter
`wipeAfterApplySnapshot`	`boolean`

tearDown

public void tearDown (TestInformation testInfo, 
                Throwable e)

Parameter
`testInfo`	`TestInformation`
`e`	`Throwable`

Menampilkan
`DeviceNotAvailableException`

useMerkleTreeComparison

public void useMerkleTreeComparison (boolean enableMerkleTreeComparison)

Parameter
`enableMerkleTreeComparison`	`boolean`

Metode yang dilindungi

checkDeviceProductType

protected void checkDeviceProductType (ITestDevice device, 
                IDeviceBuildInfo deviceBuild)

Pemeriksaan yang mungkin dilakukan sebelum flashing untuk memastikan perangkat sesuai dengan yang diharapkan dibandingkan dengan info build.

Parameter
`device`	`ITestDevice`: `ITestDevice` yang akan di-flash.
`deviceBuild`	`IDeviceBuildInfo`: `IDeviceBuildInfo` yang digunakan untuk flash.

Menampilkan
	com.android.tradefed.targetprep.BuildError
	com.android.tradefed.device.DeviceNotAvailableException
`BuildError`
`DeviceNotAvailableException`

createFlasher

protected abstract IDeviceFlasher createFlasher (ITestDevice device)

Buat IDeviceFlasher untuk digunakan. Subclass dapat mengganti

Parameter
`device`	`ITestDevice`

Hasil
`IDeviceFlasher`

Menampilkan
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getDeviceBootWaitTime

protected long getDeviceBootWaitTime ()

Mendapatkan waktu tunggu booting perangkat

Hasil
`long`

getHostOptions

protected IHostOptions getHostOptions ()

Mendapatkan instance IHostOptions yang akan digunakan.

Ditampilkan untuk pengujian unit

Hasil
`IHostOptions`

reportFlashMetrics

protected void reportFlashMetrics (String branch, 
                String buildFlavor, 
                String buildId, 
                String serial, 
                long queueTime, 
                long flashingTime, 
                CommandStatus flashingStatus)

Melaporkan data pengaturan waktu flash perangkat ke backend metrik

Parameter
`branch`	`String`: cabang tempat build perangkat berasal
`buildFlavor`	`String`: ragam build dari build perangkat
`buildId`	`String`: nomor build build perangkat
`serial`	`String`: nomor seri perangkat
`queueTime`	`long`: waktu yang dihabiskan untuk menunggu batas flash tersedia
`flashingTime`	`long`: waktu yang dihabiskan untuk mem-flash zip image perangkat
`flashingStatus`	`CommandStatus`: status eksekusi perintah flashing

setSkipPostFlashBuildIdCheck

protected void setSkipPostFlashBuildIdCheck (boolean skipPostFlashBuildIdCheck)

Parameter
`skipPostFlashBuildIdCheck`	`boolean`

setUseIncrementalFlashing

protected void setUseIncrementalFlashing (boolean incrementalFlashing)

Parameter
`incrementalFlashing`	`boolean`