本頁面由 Cloud Translation API 翻譯而成。

建構資訊

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

已知的間接子類

AppBuildInfo 、 AppDeviceBuildInfo 、 BuildInfo 、 ClusterBuildInfo 、 DeviceBuildInfo 、 DeviceFolderBuildInfo 、 FolderBuildInfo 、 IAppBuildInfo 、 IDeviceBuildInfo 、 IFolderBuilInfodInfo 、

應用程式建構訊息	表示 Android 應用程式及其測試套件的`IBuildInfo` 。
應用程式設備建構訊息	該類已被棄用。直接使用`IDeviceBuildInfo` 。
建構資訊	應與`ITestDevice`關聯的`IBuildInfo`的通用實作。
集群建構資訊	用於從 TFC 管道傳輸的建置的`IBuildInfo`類別。
設備建置資訊	表示完整 Android 裝置建置及其（可選）測試的`IBuildInfo` 。
設備資料夾建置資訊	`IDeviceBuildInfo`也包含本機檔案系統上的目錄中所包含的其他建置工件。
資料夾建置資訊	`IFolderBuildInfo`的具體實作。
IApp建置資訊	該介面已被棄用。直接使用`IBuildInfo` 。
設備建置資訊	表示完整 Android 裝置建置及其（可選）測試的`IBuildInfo` 。
資料夾建置資訊	一個簡單的抽象`IBuildInfo` ，其建置工件包含在本機檔案系統目錄中。
OtaDeviceBuildInfo	用於無線更新測試的`IDeviceBuildInfo` 。
Otatools建置訊息	包含 otatools 工件的`IBuildInfo` 。

儲存有關被測版本的資訊。

概括

常數
`String`	`REMOTE_FILE_PREFIX` 名稱中使用的前綴表示該檔案被設定為延遲下載。
`String`	`REMOTE_FILE_VERSION` 遠端文件沒有版本控制。
`String`	`UNKNOWN_BUILD_ID` 建置 ID 未知時的預設值。

公共方法
`default void`	`addAppPackageFile (File appPackageFile, String version)` 新增本機 apk 檔案及其關聯版本。
`abstract void`	`addBuildAttribute (String attributeName, String attributeValue)` 添加建置屬性。
`default void`	`addBuildAttributes ( buildAttributes)` `addBuildAttributes ( buildAttributes)` 添加建置屬性
`abstract void`	`cleanUp ()` 清理所有臨時建置文件
`abstract void`	`cleanUp ( doNotDelete)` `cleanUp ( doNotDelete)` `cleanUp()`的版本，其中某些檔案不會被刪除。
`abstract IBuildInfo`	`clone ()` 克隆`IBuildInfo`物件。
`default`	`getAppPackageFiles ()` 取得本機應用程式 apk 檔案集及其版本的副本。
`abstract`	`getBuildAttributes ()` 取得一組描述建構的附加屬性的名稱/值對。
`abstract String`	`getBuildBranch ()` 傳回產生正在測試的版本的原始碼控制分支的可選方法。
`abstract String`	`getBuildFlavor ()` 傳回正在測試的建置類型的可選方法。
`abstract String`	`getBuildId ()` 傳回被測版本的唯一識別碼。
`abstract String`	`getBuildTargetName ()` 傳回正在測試的建置的完整名稱。
`abstract String`	`getDeviceSerial ()`
`abstract File`	`getFile (String name)` 用於檢索具有給定名稱的文件的幫助程序方法。
`default File`	`getFile ( BuildInfoKey.BuildInfoFileKey key)` 使用給定的`BuildInfoFileKey`檢索檔案的幫助程序方法。
`abstract`	`getFiles ()` 傳回此`BuildInfo`中儲存的所有`VersionedFile` 。
`abstract`	`getProperties ()` 傳回目前在`IBuildInfo`上設定的屬性的副本。
`default`	`getRemoteFiles ()` 取得延遲下載的建置工件的路徑。
`abstract String`	`getTestTag ()` 傳回正在運行的測試的唯一名稱。
`default String`	`getVersion ( BuildInfoKey.BuildInfoFileKey key)` 使用給定的`BuildInfoFileKey`檢索檔案版本的幫助程序方法。
`abstract String`	`getVersion (String name)` 用於檢索具有給定名稱的文件版本的幫助程序方法。
`default VersionedFile`	`getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)` 使用給定的`BuildInfoFileKey`檢索`VersionedFile`幫助程序方法。
`default VersionedFile`	`getVersionedFile (String name)` 用於檢索具有給定名稱的`VersionedFile`幫助程式方法。
`default`	`getVersionedFileKeys ()` 傳回可用來透過`getFile(BuildInfoFileKey)`查詢`VersionedFile`鍵集。
`default`	`getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)` 用於檢索與給定`BuildInfoFileKey`關聯的`VersionedFile`清單的幫助程序方法。
`default void`	`removeBuildAttribute (String attributeName)` 從追蹤中刪除給定的 attributeName。
`abstract void`	`setBuildBranch (String branch)` 設定建置分支
`abstract void`	`setBuildFlavor (String buildFlavor)` 設定建構風格。
`abstract void`	`setBuildId (String buildId)` 設定被測版本的唯一識別碼。
`abstract void`	`setDeviceSerial (String serial)` 設定與此建置關聯的`ITestDevice`序號。
`abstract void`	`setFile (String name, File file, String version)` 在此建置資訊中儲存具有給定名稱的檔案。
`default void`	`setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version)` 在此建置資訊中儲存給定`BuildInfoFileKey`檔案。
`abstract void`	`setProperties ( BuildInfoProperties... properties)` 設定`IBuildInfo`實例的`BuildInfoProperties` 。
`abstract void`	`setTestTag (String testTag)` 設定正在運行的測試的唯一名稱。
`default File`	`stageRemoteFile (String fileName, File workingDir)` 將屬於建置資訊根目錄中遠端檔案一部分的檔案暫存。
`default BuildInformation.BuildInfo`	`toProto ()` 將 BuildInfo 實例序列化到 protobuf 中。

常數

遠端文件前綴

public static final String REMOTE_FILE_PREFIX

名稱中使用的前綴表示該檔案被設定為延遲下載。

常數值：“remote_file：”

遠端檔案版本

public static final String REMOTE_FILE_VERSION

遠端文件沒有版本控制。

常數值：“”

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

建置 ID 未知時的預設值。

常數值：“-1”

公共方法

新增應用程式包文件

public void addAppPackageFile (File appPackageFile, 
                String version)

新增本機 apk 檔案及其關聯版本。請注意，apk 將從getAppPackageFiles()傳回，依照此方法新增的順序。

參數
`appPackageFile`	`File`
`version`	`String`

添加建置屬性

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

添加建置屬性。這不允許覆蓋現有的 attributeName。

參數
`attributeName`	`String` : 唯一的屬性名稱
`attributeValue`	`String` : 屬性值

添加建置屬性

public void addBuildAttributes ( buildAttributes)

添加建置屬性

參數
`buildAttributes`	：要新增的屬性圖

清理

public abstract void cleanUp ()

清理所有臨時建置文件

清理

public abstract void cleanUp ( doNotDelete)

cleanUp()的版本，其中某些檔案不會被刪除。

參數
`doNotDelete`

複製

public abstract IBuildInfo clone ()

克隆IBuildInfo物件。

退貨
`IBuildInfo`

取得應用程式包文件

public  getAppPackageFiles ()

取得本機應用程式 apk 檔案集及其版本的副本。傳回的順序與將 apk 新增至IAppBuildInfo順序相符。

退貨

取得建置屬性

public abstract  getBuildAttributes ()

取得一組描述建構的附加屬性的名稱/值對。

退貨
	建構屬性的`ERROR(/Map)` 。不會為`null` ，但可能為空。

取得建置分支

public abstract String getBuildBranch ()

傳回產生正在測試的版本的原始碼控制分支的可選方法。

退貨
`String`	建置分支或`null`如果未設定/不適用

獲取BuildFlavor

public abstract String getBuildFlavor ()

傳回正在測試的建置類型的可選方法。

Android 平台建置的常見實作是返回（建置產品）-（建置作業系統）-（建置變體）。即通用-linux-userdebug

退貨
`String`	建造風格或`null`如果未設定/不適用

取得建置ID

public abstract String getBuildId ()

傳回被測版本的唯一識別碼。永遠不該為空。預設為UNKNOWN_BUILD_ID 。

退貨
`String`

取得建置目標名稱

public abstract String getBuildTargetName ()

傳回正在測試的建置的完整名稱。

常見的實作是根據建構風格和分支名稱的組合來建構建立目標名稱。 [即（分支名稱）-（建構風味）]

退貨
`String`

取得設備序號

public abstract String getDeviceSerial ()

退貨
`String`	執行此建置的`ITestDevice`序號。如果沒有裝置與此版本關聯，則傳回`null` 。

取得文件

public abstract File getFile (String name)

用於檢索具有給定名稱的文件的幫助程序方法。

退貨
`File`	圖像文件，如果未找到則為`null`

取得文件

public File getFile (BuildInfoKey.BuildInfoFileKey key)

使用給定的BuildInfoFileKey檢索檔案的幫助程序方法。

參數
`key`	`BuildInfoKey.BuildInfoFileKey` ：請求的`BuildInfoFileKey` 。

退貨
`File`	圖像文件，如果未找到則為`null`

取得文件

public abstract  getFiles ()

傳回此BuildInfo中儲存的所有VersionedFile 。

退貨

取得屬性

public abstract  getProperties ()

傳回目前在IBuildInfo上設定的屬性的副本。

退貨

取得遠端文件

public  getRemoteFiles ()

取得延遲下載的建置工件的路徑。

退貨

取得測試標籤

public abstract String getTestTag ()

傳回正在運行的測試的唯一名稱。

退貨
`String`

取得版本號

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

使用給定的BuildInfoFileKey檢索檔案版本的幫助程序方法。

參數
`key`	`BuildInfoKey.BuildInfoFileKey` ：請求的`BuildInfoFileKey` 。

退貨
`String`	圖像版本或`null`如果未找到

取得版本號

public abstract String getVersion (String name)

用於檢索具有給定名稱的文件版本的幫助程序方法。

退貨
`String`	圖像版本或`null`如果未找到

取得版本化文件

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

使用給定的BuildInfoFileKey檢索VersionedFile幫助程序方法。

參數
`key`	`BuildInfoKey.BuildInfoFileKey` ：請求的`BuildInfoFileKey` 。

退貨
`VersionedFile`	版本控製文件，如果未找到則為`null`

取得版本化文件

public VersionedFile getVersionedFile (String name)

用於檢索具有給定名稱的VersionedFile幫助程式方法。

退貨
`VersionedFile`	版本控製文件，如果未找到則為`null`

取得版本化文件金鑰

public  getVersionedFileKeys ()

傳回可用來透過getFile(BuildInfoFileKey)查詢VersionedFile鍵集。

退貨

取得版本化文件

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

用於檢索與給定BuildInfoFileKey關聯的VersionedFile清單的幫助程序方法。如果該鍵允許儲存清單。

參數
`key`	`BuildInfoKey.BuildInfoFileKey` ：請求的`BuildInfoFileKey` 。

退貨
	版本控製文件，如果未找到則為`null`

刪除建置屬性

public void removeBuildAttribute (String attributeName)

從追蹤中刪除給定的 attributeName。

參數
`attributeName`	`String` : 停止追蹤的屬性

設定建置分支

public abstract void setBuildBranch (String branch)

設定建置分支

參數
`branch`	`String` : 分支名稱

設定建構風格

public abstract void setBuildFlavor (String buildFlavor)

設定建構風格。

設定建置ID

public abstract void setBuildId (String buildId)

設定被測版本的唯一識別碼。永遠不該為空。

參數
`buildId`	`String`

設定設備序號

public abstract void setDeviceSerial (String serial)

設定與此建置關聯的ITestDevice序號。

參數
`serial`	`String` ：執行此建置的`ITestDevice`的序號。

設定檔案

public abstract void setFile (String name, 
                File file, 
                String version)

在此建置資訊中儲存具有給定名稱的檔案。

參數
`name`	`String` : 檔案的唯一名稱
`file`	`File` ：本地`ERROR(/File)`
`version`	`String` ：檔案版本

設定檔案

public void setFile (BuildInfoKey.BuildInfoFileKey key, 
                File file, 
                String version)

在此建置資訊中儲存給定BuildInfoFileKey檔案。

參數
`key`	`BuildInfoKey.BuildInfoFileKey` ：基於`BuildInfoFileKey`檔案的唯一名稱。
`file`	`File` ：本地`ERROR(/File)`
`version`	`String` ：檔案版本

設定屬性

public abstract void setProperties (BuildInfoProperties... properties)

設定IBuildInfo實例的BuildInfoProperties 。覆蓋之前設定的任何現有屬性。

參數
`properties`	`BuildInfoProperties` ：要新增的屬性清單。

設定測試標籤

public abstract void setTestTag (String testTag)

設定正在運行的測試的唯一名稱。

參數
`testTag`	`String`

階段遠端文件

public File stageRemoteFile (String fileName, 
                File workingDir)

將屬於建置資訊根目錄中遠端檔案一部分的檔案暫存。

TODO(b/138416078)：當可以正確建構測試所需的模組並輸出到測試模組的目錄本身時，請刪除此介面及其呼叫者。

參數
`fileName`	`String` ：要位於遠端檔案中的檔案的名稱。
`workingDir`	`File` ：用於暫存檔案的目錄的`ERROR(/File)`物件。

退貨
`File`	在本地工作目錄中暫存的檔案的`ERROR(/File)`物件。

原型

public BuildInformation.BuildInfo toProto ()

將 BuildInfo 實例序列化到 protobuf 中。

退貨
`BuildInformation.BuildInfo`