建構資訊

public interface IBuildInfo

com.android.tradefed.build.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