為配合主幹穩定開發模型，並確保生態系統的平台穩定性，我們將自 2026 年起，在第 2 季和第 4 季將原始碼發布至 AOSP。如要建構及貢獻 AOSP，請使用 android-latest-release。android-latest-release 資訊清單分支版本一律會參照推送至 Android 開放原始碼計畫的最新版本。詳情請參閱「Android 開放原始碼計畫變更」。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

DeviceBuildInfo

public class DeviceBuildInfo
extends BuildInfo implements IDeviceBuildInfo

java.lang.Object
↳	com.android.tradefed.build.BuildInfo
	↳	com.android.tradefed.build.DeviceBuildInfo

已知的直接子類別

AppDeviceBuildInfo、DeviceFolderBuildInfo、OtaDeviceBuildInfo

AppDeviceBuildInfo	這個類別已淘汰。直接使用 `IDeviceBuildInfo`。
DeviceFolderBuildInfo	`IDeviceBuildInfo`，其中也包含本機檔案系統目錄中的其他建構構件。
OtaDeviceBuildInfo	用於無線更新測試。`IDeviceBuildInfo`

已知間接子類別

ClusterBuildInfo

ClusterBuildInfo 從 TFC 管道建構的 IBuildInfo 類別。

IBuildInfo，代表完整的 Android 裝置建構作業，以及 (選用) 相關測試。

摘要

公用建構函式
`DeviceBuildInfo()`
`DeviceBuildInfo(BuildInfo buildInfo)`
`DeviceBuildInfo(String buildId, String buildTargetName)`

公用方法
`void`	`cleanUp()` 清理所有暫時建構檔案
`void`	`cleanUp(List<File> doNotClean)` `cleanUp()` 版本，其中部分檔案未刪除。
`File`	`getBasebandImageFile()` 取得本機基頻映像檔。
`String`	`getBasebandVersion()` 取得基頻版本。
`File`	`getBootloaderImageFile()` 取得本機開機載入程式映像檔。
`String`	`getBootloaderVersion()` 取得系統啟動載入程式版本。
`String`	`getDeviceBuildFlavor()` 選用方法，可傳回測試中的平台建構類型。
`String`	`getDeviceBuildId()` 傳回受測平台版本的專屬 ID。
`File`	`getDeviceImageFile()` 取得本機裝置映像檔 zip 檔案。
`String`	`getDeviceImageVersion()` 取得本機裝置映像檔的 zip 版本。
`File`	`getMkbootimgFile()` 取得用於建立核心映像檔的 mkbootimg 檔案。
`String`	`getMkbootimgVersion()` 取得 mkbootimg 版本。
`File`	`getOtaPackageFile()` 取得裝置 OTA 套件的 ZIP 檔案。
`String`	`getOtaPackageVersion()` 取得裝置 OTA 套件的 ZIP 版本。
`File`	`getRamdiskFile()` 取得用於建立核心映像檔的 RAM 磁碟檔案。
`String`	`getRamdiskVersion()` 取得 ramdisk 版本。
`File`	`getTestsDir()` 取得解壓縮的 tests.zip 檔案內容的本機路徑。
`String`	`getTestsDirVersion()` 取得解壓縮的 tests.zip 版本。
`File`	`getTrustyImageFile()` 取得本機可信映像檔。
`String`	`getTrustyVersion()` 取得 trusty 版本。
`File`	`getUserDataImageFile()` 取得本機測試使用者資料映像檔。
`String`	`getUserDataImageVersion()` 取得本機測試使用者資料映像檔版本。
`void`	`setBasebandImage(File basebandFile, String version)` 為裝置版本設定基頻映像檔。
`void`	`setBootloaderImageFile(File bootloaderImgFile, String version)` 為裝置建構作業設定系統啟動載入程式映像檔。
`void`	`setDeviceBuildFlavor(String deviceBuildFlavor)` 如果與 `setBuildFlavor(String)` 不同，請為建構資訊的裝置部分設定建構風味。
`void`	`setDeviceImageFile(File deviceImageFile, String version)` 設定要使用的裝置系統映像檔。
`void`	`setMkbootimgFile(File mkbootimg, String version)` 設定用於建立核心映像檔的 mkbootimg 檔案。
`void`	`setOtaPackageFile(File otaFile, String version)` 設定裝置 OTA 套件 zip 檔案。
`void`	`setRamdiskFile(File ramdisk, String version)` 取得用於建立核心映像檔的 RAM 磁碟檔案。
`void`	`setTestsDir(File testsDir, String version)` 設定解壓縮的 tests.zip 檔案內容的本機路徑。
`void`	`setUserDataImageFile(File userDataFile, String version)` 設定要使用的使用者資料映像檔。
`final void`	`unmountAll()` 卸載已掛接的裝置映像檔。

公用建構函式

DeviceBuildInfo

public DeviceBuildInfo ()

DeviceBuildInfo

public DeviceBuildInfo (BuildInfo buildInfo)

參數
`buildInfo`	`BuildInfo`

DeviceBuildInfo

public DeviceBuildInfo (String buildId, 
                String buildTargetName)

參數
`buildId`	`String`
`buildTargetName`	`String`

公用方法

cleanUp

public void cleanUp ()

清理所有暫時建構檔案

cleanUp

public void cleanUp (List<File> doNotClean)

cleanUp() 版本，其中部分檔案未刪除。

參數
`doNotClean`	`List`

getBasebandImageFile

public File getBasebandImageFile ()

取得本機基頻映像檔。

傳回
`File`

getBasebandVersion

public String getBasebandVersion ()

取得基頻版本。

傳回
`String`

getBootloaderImageFile

public File getBootloaderImageFile ()

取得本機開機載入程式映像檔。

傳回
`File`

getBootloaderVersion

public String getBootloaderVersion ()

取得系統啟動載入程式版本。

傳回
`String`

getDeviceBuildFlavor

public String getDeviceBuildFlavor ()

可選用方法，用於傳回測試中的平台建構類型。

傳回
`String`

getDeviceBuildId

public String getDeviceBuildId ()

傳回受測平台版本的專屬 ID。一律不得為空值。預設值為 IBuildInfo.UNKNOWN_BUILD_ID。

傳回
`String`	`getDeviceImageVersion()` if not `null`, else `IBuildInfo.UNKNOWN_BUILD_ID`

另請參閱：

getDeviceImageVersion()

getDeviceImageFile

public File getDeviceImageFile ()

取得本機裝置映像檔 zip 檔案。傳回值可以是目錄，也就是未壓縮的裝置映像檔 zip 檔案。請注意，如果是目錄，則可能是已掛接的唯讀虛擬檔案系統，這會限制可套用至目錄或其內容的作業。

傳回
`File`

getDeviceImageVersion

public String getDeviceImageVersion ()

取得本機裝置映像檔的 zip 版本。

傳回
`String`

getMkbootimgFile

public File getMkbootimgFile ()

取得用於建立核心映像檔的 mkbootimg 檔案。

傳回
`File`

getMkbootimgVersion

public String getMkbootimgVersion ()

取得 mkbootimg 版本。

傳回
`String`

getOtaPackageFile

public File getOtaPackageFile ()

取得裝置 OTA 套件的 ZIP 檔案。

傳回
`File`

getOtaPackageVersion

public String getOtaPackageVersion ()

取得裝置的 OTA 套件 ZIP 版本。

傳回
`String`

getRamdiskFile

public File getRamdiskFile ()

取得用於建立核心映像檔的 RAM 磁碟檔案。

傳回
`File`

getRamdiskVersion

public String getRamdiskVersion ()

取得 ramdisk 版本。

傳回
`String`

getTestsDir

public File getTestsDir ()

取得解壓縮的 tests.zip 檔案內容的本機路徑。

傳回
`File`

getTestsDirVersion

public String getTestsDirVersion ()

取得解壓縮的 tests.zip 版本。

傳回
`String`

getTrustyImageFile

public File getTrustyImageFile ()

取得本機可信的映像檔。

傳回
`File`

getTrustyVersion

public String getTrustyVersion ()

取得 trusty 版本。

傳回
`String`

getUserDataImageFile

public File getUserDataImageFile ()

取得本機測試使用者資料映像檔。

傳回
`File`

getUserDataImageVersion

public String getUserDataImageVersion ()

取得本機測試使用者資料映像檔版本。

傳回
`String`

setBasebandImage

public void setBasebandImage (File basebandFile, 
                String version)

為裝置建構作業設定基頻映像檔。

參數
`basebandFile`	`File`：基頻映像檔 `File`
`version`	`String`：基頻版本

setBootloaderImageFile

public void setBootloaderImageFile (File bootloaderImgFile, 
                String version)

為裝置建構作業設定系統啟動載入程式映像檔。

參數
`bootloaderImgFile`	`File`：系統啟動載入程式映像檔 `File`
`version`	`String`：系統啟動載入程式版本

setDeviceBuildFlavor

public void setDeviceBuildFlavor (String deviceBuildFlavor)

如果與 setBuildFlavor(String) 不同，請為建構資訊的裝置部分設定建構風味。

參數
`deviceBuildFlavor`	`String`：裝置建構版本

setDeviceImageFile

public void setDeviceImageFile (File deviceImageFile, 
                String version)

設定要使用的裝置系統映像檔。

參數
`version`	`String`

setMkbootimgFile

public void setMkbootimgFile (File mkbootimg, 
                String version)

設定用於建立核心映像檔的 mkbootimg 檔案。

參數
`mkbootimg`	`File`
`version`	`String`

setOtaPackageFile

public void setOtaPackageFile (File otaFile, 
                String version)

設定裝置 OTA 套件的 zip 檔案。

參數
`otaFile`	`File`
`version`	`String`

setRamdiskFile

public void setRamdiskFile (File ramdisk, 
                String version)

取得用於建立核心映像檔的 RAM 磁碟檔案。

參數
`ramdisk`	`File`
`version`	`String`

setTestsDir

public void setTestsDir (File testsDir, 
                String version)

設定解壓縮的 tests.zip 檔案內容的本機路徑。

參數
`version`	`String`

setUserDataImageFile

public void setUserDataImageFile (File userDataFile, 
                String version)

設定要使用的使用者資料映像檔。

參數
`version`	`String`

unmountAll

public final void unmountAll ()

卸載已掛接的裝置映像檔。

在 DeviceBuildInfo 物件遭到毀損前卸載裝置映像檔，對於因檔案共用 (例如已對此呼叫 copyAllFileFrom()) 而無法呼叫 cleanUp() 的情況很有用。