ビルド情報

public class BuildInfo
extends Object implements IBuildInfo

java.lang.オブジェクト
↳	com.android.tradefed.build.BuildInfo

既知の直接サブクラス AppBuildInfo 、 DeviceBuildInfo 、 FolderBuildInfo 、 OhtatoolsBuildInfo アプリビルド情報 Android アプリケーションとそのテスト パッケージを表すIBuildInfo 。 デバイスビルド情報 完全な Android デバイスのビルドと (オプションで) そのテストを表すIBuildInfo 。 フォルダー構築情報 IFolderBuildInfoの具体的な実装。 OhtatoolsBuildInfo otatools アーティファクトを含むIBuildInfo 。

既知の間接サブクラス AppDeviceBuildInfo 、 ClusterBuildInfo 、 DeviceFolderBuildInfo 、 OtaDeviceBuildInfo AppDeviceBuildInfo このクラスは廃止されました。 IDeviceBuildInfo直接使用します。 クラスタービルド情報 TFC からパイプされたビルドのIBuildInfoクラス。 デバイスフォルダービルド情報 ローカル ファイル システム上のディレクトリに含まれる他のビルド アーティファクトも含まれるIDeviceBuildInfo 。 オタデバイスビルド情報 無線アップデートのテストに使用されるIDeviceBuildInfo 。

---

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) 指定された属性名を追跡から削除します。
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

すべてのファイルからコピー

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

getAppPackageFiles

public  getAppPackageFiles ()

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

戻り値

getBuildAttributes

public  getBuildAttributes ()

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

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

getBuildブランチ

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

getデバイスシリアル

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を返します。

戻り値

getProperties

public  getProperties ()

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

戻り値

getRemoteFiles

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

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

ビルド属性を削除する

public void removeBuildAttribute (String 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のシリアル番号。

セットファイル

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 : ファイルのバージョン

setProperties

public void setProperties (BuildInfoProperties... properties)

IBuildInfoインスタンスのBuildInfoPropertiesを設定します。以前に設定された既存のプロパティをオーバーライドします。

パラメーター
properties	BuildInfoProperties : 追加するプロパティのリスト。

テストタグを設定

public void setTestTag (String testTag)

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

パラメーター
testTag	String

stageRemoteファイル

public File stageRemoteFile (String fileName, 
                File workingDir)

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

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

パラメーター
fileName	String : リモート ファイルに配置されるファイルの名前。
workingDir	File : ファイルをステージングするディレクトリのERROR(/File)オブジェクト。

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

プロトへ

public BuildInformation.BuildInfo toProto ()

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

戻り値
BuildInformation.BuildInfo

toString

public String toString ()

戻り値
String

保護されたメソッド

すべてのビルド属性を追加

protected void addAllBuildAttributes (BuildInfo build)

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

パラメーター
build	BuildInfo

すべてのファイルを追加

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 の場合、プロパティを適用し、それ以降の処理をスキップする必要があります。それ以外の場合は false。

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

戻り値
MultiMap <String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

戻り値

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

戻り値
MultiMap <String, VersionedFile >