建構資訊
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) 添加建置屬性 |
default void | allowStagingRemoteFile (boolean stageRemoteFile) 設定允許暫存遠端檔案的權限。 |
abstract void | cleanUp () 清理所有臨時建置文件 |
abstract void | cleanUp ( doNotDelete) cleanUp ( doNotDelete) |
abstract IBuildInfo | clone () 克隆 |
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) 使用給定的 |
abstract | getFiles () 傳回此 |
abstract | getProperties () 傳回目前在 |
default | getRemoteFiles () 取得延遲下載的建置工件的路徑。 |
abstract String | getTestTag () 傳回正在運行的測試的唯一名稱。 |
default String | getVersion ( BuildInfoKey.BuildInfoFileKey key) 使用給定的 |
abstract String | getVersion (String name) 用於檢索具有給定名稱的文件版本的幫助程序方法。 |
default VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) 使用給定的 |
default VersionedFile | getVersionedFile (String name) 用於檢索具有給定名稱的 |
default | getVersionedFileKeys () 傳回可用來透過 |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) 用於檢索與給定 |
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) 設定與此建置關聯的 |
abstract void | setFile (String name, File file, String version) 在此建置資訊中儲存具有給定名稱的檔案。 |
default void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) 在此建置資訊中儲存給定 |
abstract void | setProperties ( BuildInfoProperties... properties) |
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 void allowStagingRemoteFile (boolean stageRemoteFile)
設定允許暫存遠端檔案的權限。
參數 | |
---|---|
stageRemoteFile | boolean |
清理
public abstract void cleanUp ()
清理所有臨時建置文件
取得應用程式包文件
publicgetAppPackageFiles ()
取得本機應用程式 apk 檔案集及其版本的副本。傳回的順序與將 apk 新增至IAppBuildInfo
的順序相符。
退貨 | |
---|---|
取得建置分支
public abstract String getBuildBranch ()
傳回產生正在測試的版本的原始碼控制分支的可選方法。
退貨 | |
---|---|
String | 建置分支或null 如果未設定/不適用 |
獲取BuildFlavor
public abstract String getBuildFlavor ()
傳回正在測試的建置類型的可選方法。
Android 平台建置的常見實作是返回(建置產品)-(建置作業系統)-(建置變體)。即通用-linux-userdebug退貨 | |
---|---|
String | 建造風格或null 如果未設定/不適用 |
取得建置目標名稱
public abstract String getBuildTargetName ()
傳回正在測試的建置的完整名稱。
常見的實作是根據建構風格和分支名稱的組合來建構建立目標名稱。 [即(分支名稱)-(建構風味)]退貨 | |
---|---|
String |
取得文件
public abstract File getFile (String name)
用於檢索具有給定名稱的文件的幫助程序方法。
退貨 | |
---|---|
File | 圖像文件,如果未找到則為null |
取得文件
public File getFile (BuildInfoKey.BuildInfoFileKey key)
使用給定的BuildInfoFileKey
檢索檔案的幫助程序方法。
參數 | |
---|---|
key | BuildInfoKey.BuildInfoFileKey :請求的BuildInfoFileKey 。 |
退貨 | |
---|---|
File | 圖像文件,如果未找到則為null |
取得遠端文件
publicgetRemoteFiles ()
取得延遲下載的建置工件的路徑。
退貨 | |
---|---|
取得測試標籤
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 |
取得版本化文件
publicgetVersionedFiles (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 |