建構資訊

public class BuildInfo
extends Object implements IBuildInfo

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


應與ITestDevice關聯的IBuildInfo的通用實作。

概括

公共構造函數

BuildInfo ()

使用預設屬性值建立BuildInfo

BuildInfo (String buildId, String buildTargetName)

創建BuildInfo

公共方法

void addAppPackageFile (File appPackageFile, String version)

新增本機 apk 檔案及其關聯版本。

void addBuildAttribute (String attributeName, String attributeValue)

添加建置屬性。

void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

添加建置屬性

void cleanUp ()

清理所有臨時建置文件

void cleanUp ( doNotClean) cleanUp ( doNotClean)

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

IBuildInfo clone ()

final void copyAllFileFrom ( BuildInfo build)

將給定版本中的所有VersionedFile複製到此版本。

boolean equals (Object obj)

static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

toProto()的逆操作以取得實例。

getAppPackageFiles ()

取得本機應用程式 apk 檔案集及其版本的副本。

getBuildAttributes ()

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

String getBuildBranch ()

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

String getBuildFlavor ()

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

String getBuildId ()

傳回被測版本的唯一識別碼。

String getBuildTargetName ()

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

String getDeviceSerial ()

File getFile (String name)

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

File getFile ( BuildInfoKey.BuildInfoFileKey key)

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

getFiles ()

傳回此BuildInfo中儲存的所有VersionedFile

getProperties ()

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

getRemoteFiles ()

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

String getTestTag ()

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

String getVersion ( BuildInfoKey.BuildInfoFileKey key)

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

String getVersion (String name)

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

VersionedFile getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)

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

final VersionedFile getVersionedFile (String name)

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

getVersionedFileKeys ()

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

final getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

用於檢索與給定BuildInfoFileKey關聯的VersionedFile清單的幫助程序方法。

int hashCode ()

void removeBuildAttribute (String attributeName)

從追蹤中刪除給定的 attributeName。

void setBuildBranch (String branch)

設定建置分支

void setBuildFlavor (String buildFlavor)

設定建構風格。

void setBuildId (String buildId)

設定被測版本的唯一識別碼。

void setDeviceSerial (String serial)

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

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

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

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

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

void setProperties ( BuildInfoProperties... properties)

設定IBuildInfo實例的BuildInfoProperties

void setTestTag (String testTag)

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

File stageRemoteFile (String fileName, File workingDir)

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

BuildInformation.BuildInfo toProto ()

將 BuildInfo 實例序列化到 protobuf 中。

String toString ()

受保護的方法

void addAllBuildAttributes ( BuildInfo build)

從其他建構複製建置屬性、分支和風格的輔助方法。

void addAllFiles ( BuildInfo build)

從其他版本複製所有文件的幫助程序方法。

boolean applyBuildProperties ( VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)

允許應用一些IBuildInfo.BuildInfoProperties並可能進行不同的處理。

MultiMap <String, String> getAttributesMultiMap ()
getVersionedFileMap ()
MultiMap <String, VersionedFile > getVersionedFileMapFull ()

公共構造函數

建構資訊

public BuildInfo ()

使用預設屬性值建立BuildInfo

建構資訊

public BuildInfo (String buildId, 
                String buildTargetName)

創建BuildInfo

參數
buildId String : 建置 ID

buildTargetName String : 建置目標名稱

公共方法

新增應用程式包文件

public void addAppPackageFile (File appPackageFile, 
                String version)

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

參數
appPackageFile File

version String

添加建置屬性

public void addBuildAttribute (String attributeName, 
                String attributeValue)

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

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

attributeValue String : 屬性值

添加建置屬性

public void addBuildAttributes ( buildAttributes)

添加建置屬性

參數
buildAttributes :要新增的屬性圖

清理

public void cleanUp ()

清理所有臨時建置文件

清理

public void cleanUp ( doNotClean)

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

參數
doNotClean

複製

public IBuildInfo clone ()

退貨
IBuildInfo

複製所有文件自

public final void copyAllFileFrom (BuildInfo build)

將給定版本中的所有VersionedFile複製到此版本。

參數
build BuildInfo

等於

public boolean equals (Object obj)

參數
obj Object

退貨
boolean

來自原型

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

toProto()的逆操作以取得實例。

參數
protoBuild BuildInformation.BuildInfo

退貨
IBuildInfo

取得應用程式包文件

public  getAppPackageFiles ()

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

退貨

取得建置屬性

public  getBuildAttributes ()

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

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

取得建置分支

public String getBuildBranch ()

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

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

獲取BuildFlavor

public String getBuildFlavor ()

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

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

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

取得建置ID

public String getBuildId ()

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

退貨
String

取得建置目標名稱

public String getBuildTargetName ()

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

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

退貨
String

取得設備序號

public String getDeviceSerial ()

退貨
String

取得文件

public File getFile (String name)

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

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

取得文件

public File getFile (BuildInfoKey.BuildInfoFileKey key)

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

參數
key BuildInfoKey.BuildInfoFileKey :請求的BuildInfoFileKey

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

取得文件

public  getFiles ()

傳回此BuildInfo中儲存的所有VersionedFile

退貨

取得屬性

public  getProperties ()

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

退貨

取得遠端文件

public  getRemoteFiles ()

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

退貨

取得測試標籤

public String getTestTag ()

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

退貨
String

取得版本號

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

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

參數
key BuildInfoKey.BuildInfoFileKey :請求的BuildInfoFileKey

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

取得版本號

public String getVersion (String name)

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

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

取得版本化文件

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

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

參數
key BuildInfoKey.BuildInfoFileKey :請求的BuildInfoFileKey

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

取得版本化文件

public final VersionedFile getVersionedFile (String name)

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

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

取得版本化文件金鑰

public  getVersionedFileKeys ()

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

退貨

取得版本化文件

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

參數
key BuildInfoKey.BuildInfoFileKey :請求的BuildInfoFileKey

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

哈希碼

public int hashCode ()

退貨
int

刪除建置屬性

public void removeBuildAttribute (String attributeName)

從追蹤中刪除給定的 attributeName。

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

設定建置分支

public void setBuildBranch (String branch)

設定建置分支

參數
branch String : 分支名稱

設定建構風格

public void setBuildFlavor (String buildFlavor)

設定建構風格。

設定建置ID

public void setBuildId (String buildId)

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

參數
buildId String

設定設備序號

public void setDeviceSerial (String serial)

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

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

設定檔案

public 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 void setProperties (BuildInfoProperties... properties)

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

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

設定測試標籤

public 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

到字串

public String toString ()

退貨
String

受保護的方法

添加所有建置屬性

protected void addAllBuildAttributes (BuildInfo build)

從其他建構複製建置屬性、分支和風格的輔助方法。

參數
build BuildInfo

新增所有文件

protected void addAllFiles (BuildInfo build)

從其他版本複製所有文件的幫助程序方法。

創建到文件的新硬鏈接,以便每個構建都將具有該文件的唯一文件路徑。

參數
build BuildInfo

投擲
如果建立硬連結時拋出異常。

應用建置屬性

protected boolean applyBuildProperties (VersionedFile origFileConsidered, 
                IBuildInfo build, 
                IBuildInfo receiver)

允許應用一些IBuildInfo.BuildInfoProperties並可能進行不同的處理。

參數
origFileConsidered VersionedFile :目前檢視的VersionedFile

build IBuildInfo :正在克隆的原始構建

receiver IBuildInfo :接收資訊的建置。

退貨
boolean如果我們應用了這些屬性,則為 true,並且應跳過進一步的處理。否則為假。

取得屬性多重映射

protected MultiMap<String, String> getAttributesMultiMap ()

退貨
MultiMap <String, String>

取得版本化文件映射

protected  getVersionedFileMap ()

退貨

取得版本化檔案映射完整

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

退貨
MultiMap <String, VersionedFile >