建構資訊
public class BuildInfo
extends Object
implements IBuildInfo
java.lang.Object | |
↳ | com.android.tradefed.build.BuildInfo |
應與ITestDevice
關聯的IBuildInfo
的通用實作。
概括
公共構造函數 | |
---|---|
BuildInfo () 使用預設屬性值建立 | |
BuildInfo (String buildId, String buildTargetName) |
公共方法 | |
---|---|
void | addAppPackageFile (File appPackageFile, String version) 新增本機 apk 檔案及其關聯版本。 |
void | addBuildAttribute (String attributeName, String attributeValue) 添加建置屬性。 |
void | addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) 添加建置屬性 |
void | allowStagingRemoteFile (boolean stageRemoteFile) 設定允許暫存遠端檔案的權限。 |
void | cleanUp () 清理所有臨時建置文件 |
void | cleanUp ( doNotClean) cleanUp ( doNotClean) |
IBuildInfo | clone () |
final void | copyAllFileFrom ( BuildInfo build) 將給定版本中的所有 |
boolean | equals (Object obj) |
static IBuildInfo | fromProto (BuildInformation.BuildInfo protoBuild) |
getAppPackageFiles () 取得本機應用程式 apk 檔案集及其版本的副本。 | |
getBuildAttributes () 取得一組描述建構的附加屬性的名稱/值對。 | |
String | getBuildBranch () 傳回產生正在測試的版本的原始碼控制分支的可選方法。 |
String | getBuildFlavor () 傳回正在測試的建置類型的可選方法。 |
String | getBuildId () 傳回被測版本的唯一識別碼。 |
String | getBuildTargetName () 傳回正在測試的建置的完整名稱。 |
String | getDeviceSerial () |
File | getFile (String name) 用於檢索具有給定名稱的文件的幫助程序方法。 |
File | getFile ( BuildInfoKey.BuildInfoFileKey key) 使用給定的 |
getFiles () 傳回此 | |
getProperties () 傳回目前在 | |
getRemoteFiles () 取得延遲下載的建置工件的路徑。 | |
String | getTestTag () 傳回正在運行的測試的唯一名稱。 |
String | getVersion ( BuildInfoKey.BuildInfoFileKey key) 使用給定的 |
String | getVersion (String name) 用於檢索具有給定名稱的文件版本的幫助程序方法。 |
VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) 使用給定的 |
final VersionedFile | getVersionedFile (String name) 用於檢索具有給定名稱的 |
getVersionedFileKeys () 傳回可用來透過 | |
final | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) 用於檢索與給定 |
int | hashCode () |
void | removeBuildAttribute (String attributeName) 從追蹤中刪除給定的 attributeName。 |
void | setBuildBranch (String branch) 設定建置分支 |
void | setBuildFlavor (String buildFlavor) 設定建構風格。 |
void | setBuildId (String buildId) 設定被測版本的唯一識別碼。 |
void | setDeviceSerial (String serial) 設定與此建置關聯的 |
void | setFile (String name, File file, String version) 在此建置資訊中儲存具有給定名稱的檔案。 |
void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) 在此建置資訊中儲存給定 |
void | setProperties ( BuildInfoProperties... properties) |
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) 允許應用一些 |
MultiMap <String, String> | getAttributesMultiMap () |
getVersionedFileMap () | |
MultiMap <String, VersionedFile > | getVersionedFileMapFull () |
公共構造函數
建構資訊
public BuildInfo (String buildId, String buildTargetName)
參數 | |
---|---|
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 allowStagingRemoteFile (boolean stageRemoteFile)
設定允許暫存遠端檔案的權限。
參數 | |
---|---|
stageRemoteFile | boolean |
清理
public void cleanUp ()
清理所有臨時建置文件
複製所有文件自
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 |
取得應用程式包文件
publicgetAppPackageFiles ()
取得本機應用程式 apk 檔案集及其版本的副本。傳回的順序與將 apk 新增至IAppBuildInfo
的順序相符。
退貨 | |
---|---|
取得建置分支
public String getBuildBranch ()
傳回產生正在測試的版本的原始碼控制分支的可選方法。
退貨 | |
---|---|
String | 建置分支或null 如果未設定/不適用 |
獲取BuildFlavor
public String getBuildFlavor ()
傳回正在測試的建置類型的可選方法。
Android 平台建置的常見實作是返回(建置產品)-(建置作業系統)-(建置變體)。即通用-linux-userdebug退貨 | |
---|---|
String | 建造風格或null 如果未設定/不適用 |
取得建置目標名稱
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 |
取得遠端文件
publicgetRemoteFiles ()
取得延遲下載的建置工件的路徑。
退貨 | |
---|---|
取得測試標籤
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 finalgetVersionedFiles (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,並且應跳過進一步的處理。否則為假。 |
取得版本化文件映射
protectedgetVersionedFileMap ()
退貨 | |
---|---|
取得版本化檔案映射完整
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
退貨 | |
---|---|
MultiMap <String, VersionedFile > |