ビルド情報

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 : ビルド ターゲット名

公開メソッド

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

ローカル apk ファイルとそれに関連付けられたバージョンを追加します。 apk は、このメソッドによって追加された順序でgetAppPackageFiles()から返されることに注意してください。

パラメーター
appPackageFile File

version String

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

ビルド属性を追加します。これにより、既存の attributeName をオーバーライドすることはできません。

パラメーター
attributeName String : 一意の属性名

attributeValue String : 属性値

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

ビルド属性を追加する

パラメーター
buildAttributes : 追加する属性のマップ

掃除

public void cleanUp ()

一時ビルド ファイルをクリーンアップする

掃除

public void cleanUp ( doNotClean)

一部のファイルが削除されないcleanUp()のバージョン。

パラメーター
doNotClean

クローン

public IBuildInfo clone ()

戻り値
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

特定のビルドからすべてのVersionedFileをこのビルドにコピーします。

パラメーター
build BuildInfo

等しい

public boolean equals (Object obj)

パラメーター
obj Object

戻り値
boolean

fromプロト

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

インスタンスを取得するためのtoProto()の逆操作。

パラメーター
protoBuild BuildInformation.BuildInfo

戻り値
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

ローカル アプリの apk ファイルとそのバージョンのセットのコピーを取得します。返される順序は、apk がIAppBuildInfoに追加された順序と一致します。

戻り値

getBuildAttributes

public  getBuildAttributes ()

ビルドを説明する追加属性の名前と値のペアのセットを取得します。

戻り値
ビルド属性のERROR(/Map) 。 nullにはなりませんが、空になる場合があります。

getBuildBranch

public String getBuildBranch ()

テスト対象のビルドが生成されたソース管理ブランチを返すオプションのメソッド。

戻り値
Stringビルド ブランチ、または設定されていない/適用されない場合はnull

getBuildFlavor

public String getBuildFlavor ()

テスト中のビルドのタイプを返すオプションのメソッド。

Android プラットフォーム ビルドの一般的な実装は、(ビルド製品)-(ビルド OS)-(ビルド バリアント) を返すことです。つまり、generic-linux-userdebug

戻り値
Stringビルドフレーバーまたは設定されていない/適用されない場合はnull

getBuildId

public String getBuildId ()

テスト対象のビルドの一意の識別子を返します。 null であってはなりません。デフォルトはUNKNOWN_BUILD_IDです。

戻り値
String

getBuildTargetName

public String getBuildTargetName ()

テスト中のビルドの完全な名前を返します。

一般的な実装は、ビルド フレーバーとブランチ名の組み合わせからビルド ターゲット名を作成することです。 [ie (ブランチ名)-(ビルドフレーバー)]

戻り値
String

getDeviceSerial

public String getDeviceSerial ()

戻り値
String

getFile

public File getFile (String name)

指定された名前のファイルを取得するヘルパー メソッド。

戻り値
File画像ファイル、または見つからない場合はnull

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

指定されたBuildInfoFileKeyでファイルを取得するヘルパー メソッド。

パラメーター
key BuildInfoKey.BuildInfoFileKey : 要求されたBuildInfoFileKey 。

戻り値
File画像ファイル、または見つからない場合はnull

getFiles

public  getFiles ()

このBuildInfoに格納されているすべてのVersionedFileを返します。

戻り値

getProperties

public  getProperties ()

IBuildInfoに現在設定されているプロパティのコピーを返します。

戻り値

getRemoteFiles

public  getRemoteFiles ()

ダウンロードが遅延しているビルド アーティファクトのパスを取得します。

戻り値

getTestTag

public String getTestTag ()

実行中のテストの一意の名前を返します。

戻り値
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

指定されたBuildInfoFileKeyでファイル バージョンを取得するヘルパー メソッド。

パラメーター
key BuildInfoKey.BuildInfoFileKey : 要求されたBuildInfoFileKey 。

戻り値
Stringイメージのバージョン、または見つからない場合はnull

getVersion

public String getVersion (String name)

指定された名前のファイル バージョンを取得するヘルパー メソッド。

戻り値
Stringイメージのバージョン、または見つからない場合はnull

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

指定されたBuildInfoFileKeyでVersionedFileを取得するヘルパー メソッド。

パラメーター
key BuildInfoKey.BuildInfoFileKey : 要求されたBuildInfoFileKey 。

戻り値
VersionedFileバージョン管理されたファイル、または見つからない場合はnull

getVersionedFile

public final VersionedFile getVersionedFile (String name)

指定された名前のVersionedFileを取得するヘルパー メソッド。

戻り値
VersionedFileバージョン管理されたファイル、または見つからない場合はnull

getVersionedFileKeys

public  getVersionedFileKeys ()

getFile(BuildInfoFileKey)を介してVersionedFileを照会するために使用できるキーのセットを返します。

戻り値

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

特定のBuildInfoFileKeyに関連付けられたVersionedFileのリストを取得するヘルパー メソッド。キーがリストの保存を許可する場合。

パラメーター
key BuildInfoKey.BuildInfoFileKey : 要求されたBuildInfoFileKey 。

戻り値
バージョン管理されたファイル、または見つからない場合はnull

ハッシュコード

public int hashCode ()

戻り値
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

特定の attributeName を追跡から削除します。

パラメーター
attributeName String : 追跡を停止する属性

setBuildBranch

public void setBuildBranch (String branch)

ビルドブランチを設定する

パラメーター
branch String : ブランチ名

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

ビルド フレーバーを設定します。

setBuildId

public void setBuildId (String buildId)

テスト対象のビルドの一意の識別子を設定します。 null であってはなりません。

パラメーター
buildId String

setDeviceSerial

public void setDeviceSerial (String serial)

このビルドに関連付けられたITestDeviceシリアルを設定します。

パラメーター
serial String : このビルドが実行されたITestDeviceのシリアル番号。

setFile

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

このビルド情報に指定された名前のファイルを保存します。

パラメーター
name String : ファイルの一意の名前

file File : ローカルERROR(/File)

version String : ファイルのバージョン

setFile

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 : 追加するプロパティのリスト。

setTestTag

public void setTestTag (String testTag)

実行中のテストの一意の名前を設定します。

パラメーター
testTag String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

ビルド情報のルート ディレクトリにあるリモート ファイルの一部であるファイルをステージングします。

TODO(b/138416078): テストに必要なモジュールを適切にビルドして、テスト モジュールのディレクトリ自体に出力できる場合は、このインターフェイスとその呼び出し元を削除します。

パラメーター
fileName String : リモート ファイルに配置するファイルの名前。

workingDir File : ファイルをステージングするディレクトリのERROR(/File)オブジェクト。

戻り値
Fileローカルの workingDir にステージングされたファイルのERROR(/File)オブジェクト。

toProto

public BuildInformation.BuildInfo toProto ()

BuildInfo インスタンスを protobuf にシリアル化します。

戻り値
BuildInformation.BuildInfo

toString

public String toString ()

戻り値
String

保護されたメソッド

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

ビルド属性、ブランチ、およびフレーバーを他のビルドからコピーするためのヘルパー メソッド。

パラメーター
build BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

他のビルドからすべてのファイルをコピーするヘルパー メソッド。

各ビルドがファイルへの一意のファイル パスを持つように、ファイルへの新しいハードリンクを作成します。

パラメーター
build BuildInfo

スロー
ハードリンクの作成時に例外がスローされた場合。

applyBuildProperties

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

IBuildInfo.BuildInfoPropertiesの一部を適用し、場合によっては別の処理を実行できるようにします。

パラメーター
origFileConsidered VersionedFile : 現在見ているVersionedFile 。

build IBuildInfo : 複製される元のビルド

receiver IBuildInfo : 情報を受け取るビルド。

戻り値
booleanプロパティを適用し、以降の処理をスキップする必要がある場合は true。それ以外の場合は偽。

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

戻り値
MultiMap <String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

戻り値

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

戻り値
MultiMap <String, VersionedFile >