BuildInfo

public class BuildInfo
extends Object implements IBuildInfo

java.lang.Object
↳	com.android.tradefed.build.BuildInfo

Các lớp con trực tiếp đã biết AppBuildInfo, DeviceBuildInfo, FolderBuildInfo, OtatoolsBuildInfo AppBuildInfo IBuildInfo đại diện cho một ứng dụng Android và(các) gói kiểm thử của ứng dụng đó.  DeviceBuildInfo IBuildInfo đại diện cho một bản dựng thiết bị Android hoàn chỉnh và (không bắt buộc) các chương trình kiểm thử của bản dựng đó.  FolderBuildInfo Cách triển khai cụ thể của IFolderBuildInfo.  OtatoolsBuildInfo IBuildInfo chứa các cấu phần phần mềm otatools.

Các lớp con gián tiếp đã biết AppDeviceBuildInfo, ClusterBuildInfo, DeviceFolderBuildInfo, OtaDeviceBuildInfo AppDeviceBuildInfo Lớp này không còn được dùng nữa. Sử dụng trực tiếp IDeviceBuildInfo.  ClusterBuildInfo Lớp IBuildInfo cho các bản dựng được chuyển từ TFC.  DeviceFolderBuildInfo IDeviceBuildInfo cũng chứa các cấu phần phần mềm bản dựng khác trong một thư mục trên hệ thống tệp cục bộ.  OtaDeviceBuildInfo IDeviceBuildInfo dùng để kiểm thử bản cập nhật qua mạng không dây.

---

Cách triển khai chung của IBuildInfo cần được liên kết với ITestDevice.

Tóm tắt

Hàm khởi tạo công khai
BuildInfo() Tạo BuildInfo bằng cách sử dụng các giá trị thuộc tính mặc định.
BuildInfo(String buildId, String buildTargetName) Tạo một BuildInfo

Phương thức công khai
void	addAppPackageFile(File appPackageFile, String version) Thêm tệp apk cục bộ và phiên bản liên kết của tệp đó.
void	addBuildAttribute(String attributeName, String attributeValue) Thêm thuộc tính bản dựng.
void	addBuildAttributes( buildAttributes) Thêm thuộc tính bản dựng
void	allowStagingRemoteFile(boolean stageRemoteFile) Đặt quyền cho phép lưu trữ các tệp từ xa.
void	cleanUp() Dọn dẹp mọi tệp bản dựng tạm thời
void	cleanUp( doNotClean) Phiên bản cleanUp() trong đó một số tệp không bị xoá.
IBuildInfo	clone()
final void	copyAllFileFrom(BuildInfo build) Sao chép tất cả VersionedFile từ một bản dựng nhất định vào bản dựng này.
boolean	equals(Object obj)
static IBuildInfo	fromProto(BuildInformation.BuildInfo protoBuild) Thao tác nghịch đảo với toProto() để lấy lại thực thể.
	getAppPackageFiles() Lấy bản sao của tập hợp(các) tệp apk ứng dụng cục bộ và phiên bản của các tệp đó.
	getBuildAttributes() Nhận một tập hợp cặp tên-giá trị của các thuộc tính bổ sung mô tả bản dựng.
String	getBuildBranch() Phương thức không bắt buộc để trả về nhánh kiểm soát nguồn mà bản dựng đang được kiểm thử được tạo từ đó.
String	getBuildFlavor() Phương thức không bắt buộc để trả về loại bản dựng đang được kiểm thử.
String	getBuildId() Trả về giá trị nhận dạng duy nhất của bản dựng đang được kiểm thử.
String	getBuildTargetName() Trả về tên đầy đủ của bản dựng đang được kiểm thử.
String	getDeviceSerial()
File	getFile(String name) Phương thức trợ giúp để truy xuất tệp có tên đã cho.
File	getFile(BuildInfoKey.BuildInfoFileKey key) Phương thức trợ giúp để truy xuất tệp có BuildInfoFileKey đã cho.
	getFiles() Trả về tất cả VersionedFile được lưu trữ trong BuildInfo này.
	getProperties() Trả về bản sao của các thuộc tính hiện được đặt trên IBuildInfo.
	getRemoteFiles() Nhận đường dẫn cho các cấu phần phần mềm bản dựng bị trì hoãn tải xuống.
String	getTestTag() Trả về một tên duy nhất cho các chương trình kiểm thử đang chạy.
String	getVersion(BuildInfoKey.BuildInfoFileKey key) Phương thức trợ giúp để truy xuất phiên bản tệp đã cho BuildInfoFileKey.
String	getVersion(String name) Phương thức trợ giúp để truy xuất phiên bản tệp có tên đã cho.
VersionedFile	getVersionedFile(BuildInfoKey.BuildInfoFileKey key) Phương thức trợ giúp để truy xuất VersionedFile bằng một BuildInfoFileKey nhất định.
final VersionedFile	getVersionedFile(String name) Phương thức trợ giúp để truy xuất VersionedFile có tên nhất định.
	getVersionedFileKeys() Trả về tập hợp các khoá có sẵn để truy vấn VersionedFile thông qua getFile(BuildInfoFileKey).
final	getVersionedFiles(BuildInfoKey.BuildInfoFileKey key) Phương thức trợ giúp để truy xuất danh sách VersionedFile được liên kết với một BuildInfoFileKey nhất định.
int	hashCode()
void	removeBuildAttribute(String attributeName) Xoá một attributeName nhất định khỏi tính năng theo dõi.
void	setBuildBranch(String branch) Đặt nhánh bản dựng
void	setBuildFlavor(String buildFlavor) Đặt phiên bản bản dựng.
void	setBuildId(String buildId) Đặt giá trị nhận dạng duy nhất của bản dựng đang được kiểm thử.
void	setDeviceSerial(String serial) Đặt số sê-ri ITestDevice liên kết với bản dựng này.
void	setFile(String name, File file, String version) Lưu trữ một tệp có tên đã cho trong thông tin bản dựng này.
void	setFile(BuildInfoKey.BuildInfoFileKey key, File file, String version) Lưu trữ một tệp được cung cấp BuildInfoFileKey trong thông tin bản dựng này.
void	setProperties(BuildInfoProperties... properties) Đặt BuildInfoProperties cho thực thể IBuildInfo.
void	setTestTag(String testTag) Đặt tên duy nhất cho các chương trình kiểm thử đang chạy.
File	stageRemoteFile(String fileName, File workingDir) Đặt một tệp thuộc về các tệp từ xa trong thư mục gốc của thông tin bản dựng.
BuildInformation.BuildInfo	toProto() Tuần tự hoá thực thể BuildInfo thành protobuf.
String	toString()

Phương thức được bảo vệ
void	addAllBuildAttributes(BuildInfo build) Phương thức trợ giúp để sao chép các thuộc tính bản dựng, nhánh và phiên bản của bản dựng khác.
void	addAllFiles(BuildInfo build) Phương thức trợ giúp để sao chép tất cả tệp từ bản dựng khác.
boolean	applyBuildProperties(VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) Cho phép áp dụng một số IBuildInfo.BuildInfoProperties và có thể xử lý theo cách khác.
MultiMap<String, String>	getAttributesMultiMap()
	getVersionedFileMap()
MultiMap<String, VersionedFile>	getVersionedFileMapFull()

Hàm khởi tạo công khai

BuildInfo

public BuildInfo ()

Tạo BuildInfo bằng cách sử dụng các giá trị thuộc tính mặc định.

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Tạo một BuildInfo

Tham số
buildId	String: mã bản dựng
buildTargetName	String: tên mục tiêu bản dựng

Phương thức công khai

addAppPackageFile

public void addAppPackageFile (File appPackageFile, 
                String version)

Thêm tệp apk cục bộ và phiên bản liên kết của tệp đó. Xin lưu ý rằng các tệp apk sẽ được trả về từ getAppPackageFiles() theo thứ tự mà phương thức này thêm các tệp apk đó.

Tham số
appPackageFile	File
version	String

addBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Thêm thuộc tính bản dựng. Điều này không cho phép ghi đè attributeName hiện có.

Tham số
attributeName	String: tên thuộc tính duy nhất
attributeValue	String: giá trị thuộc tính

addBuildAttributes

public void addBuildAttributes ( buildAttributes)

Thêm thuộc tính bản dựng

Tham số
buildAttributes	: Bản đồ các thuộc tính cần thêm

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Đặt quyền cho phép lưu trữ các tệp từ xa.

Tham số
stageRemoteFile	boolean

cleanUp

public void cleanUp ()

Dọn dẹp mọi tệp bản dựng tạm thời

cleanUp

public void cleanUp ( doNotClean)

Phiên bản cleanUp() trong đó một số tệp không bị xoá.

Tham số
doNotClean

nhân bản

public IBuildInfo clone ()

Giá trị trả về
IBuildInfo

copyAllFileFrom

public final void copyAllFileFrom (BuildInfo build)

Sao chép tất cả VersionedFile từ một bản dựng nhất định vào bản dựng này.

Tham số
build	BuildInfo

bằng

public boolean equals (Object obj)

Tham số
obj	Object

Giá trị trả về
boolean

fromProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Thao tác nghịch đảo với toProto() để lấy lại thực thể.

Tham số
protoBuild	BuildInformation.BuildInfo

Giá trị trả về
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Lấy bản sao của tập hợp(các) tệp apk ứng dụng cục bộ và phiên bản của các tệp đó. Thứ tự trả về khớp với thứ tự các tệp apk được thêm vào IAppBuildInfo.

Giá trị trả về

getBuildAttributes

public  getBuildAttributes ()

Nhận một tập hợp cặp tên-giá trị của các thuộc tính bổ sung mô tả bản dựng.

Giá trị trả về
	ERROR(/Map) của các thuộc tính bản dựng. Sẽ không phải là null, nhưng có thể để trống.

getBuildBranch

public String getBuildBranch ()

Phương thức không bắt buộc để trả về nhánh kiểm soát nguồn mà bản dựng đang được kiểm thử được tạo từ đó.

Giá trị trả về
String	nhánh bản dựng hoặc null nếu không được đặt/không áp dụng

getBuildFlavor

public String getBuildFlavor ()

Phương thức không bắt buộc để trả về loại bản dựng đang được kiểm thử.

Một cách triển khai phổ biến cho các bản dựng nền tảng Android là trả về (build product)-(build os)-(build variant). ie generic-linux-userdebug

Giá trị trả về
String	phiên bản xây dựng hoặc null nếu không được đặt/không áp dụng

getBuildId

public String getBuildId ()

Trả về giá trị nhận dạng duy nhất của bản dựng đang được kiểm thử. Không được để trống. Giá trị mặc định là UNKNOWN_BUILD_ID.

Giá trị trả về
String

getBuildTargetName

public String getBuildTargetName ()

Trả về tên đầy đủ của bản dựng đang được kiểm thử.

Một cách triển khai phổ biến là tạo tên mục tiêu bản dựng từ tổ hợp phiên bản bản dựng và tên nhánh. [tức là (tên nhánh)-(phiên bản)]

Giá trị trả về
String

getDeviceSerial

public String getDeviceSerial ()

Giá trị trả về
String

getFile

public File getFile (String name)

Phương thức trợ giúp để truy xuất tệp có tên đã cho.

Giá trị trả về
File	tệp hình ảnh hoặc null nếu không tìm thấy

getFile

public File getFile (BuildInfoKey.BuildInfoFileKey key)

Phương thức trợ giúp để truy xuất tệp có BuildInfoFileKey đã cho.

Tham số
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey được yêu cầu.

Giá trị trả về
File	tệp hình ảnh hoặc null nếu không tìm thấy

getFiles

public  getFiles ()

Trả về tất cả VersionedFile được lưu trữ trong BuildInfo này.

Giá trị trả về

getProperties

public  getProperties ()

Trả về bản sao của các thuộc tính hiện được đặt trên IBuildInfo.

Giá trị trả về

getRemoteFiles

public  getRemoteFiles ()

Nhận đường dẫn cho các cấu phần phần mềm bản dựng bị trì hoãn tải xuống.

Giá trị trả về

getTestTag

public String getTestTag ()

Trả về một tên duy nhất cho các chương trình kiểm thử đang chạy.

Giá trị trả về
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Phương thức trợ giúp để truy xuất phiên bản tệp đã cho BuildInfoFileKey.

Tham số
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey được yêu cầu.

Giá trị trả về
String	phiên bản hình ảnh hoặc null nếu không tìm thấy

getVersion

public String getVersion (String name)

Phương thức trợ giúp để truy xuất phiên bản tệp có tên đã cho.

Giá trị trả về
String	phiên bản hình ảnh hoặc null nếu không tìm thấy

getVersionedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Phương thức trợ giúp để truy xuất VersionedFile bằng một BuildInfoFileKey nhất định.

Tham số
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey được yêu cầu.

Giá trị trả về
VersionedFile	Tệp có phiên bản hoặc null nếu không tìm thấy

getVersionedFile

public final VersionedFile getVersionedFile (String name)

Phương thức trợ giúp để truy xuất VersionedFile có tên nhất định.

Giá trị trả về
VersionedFile	Tệp có phiên bản hoặc null nếu không tìm thấy

getVersionedFileKeys

public  getVersionedFileKeys ()

Trả về tập hợp các khoá có sẵn để truy vấn VersionedFile thông qua getFile(BuildInfoFileKey).

Giá trị trả về

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Phương thức trợ giúp để truy xuất danh sách VersionedFile được liên kết với một BuildInfoFileKey nhất định. Nếu khoá cho phép lưu trữ danh sách.

Tham số
key	BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey được yêu cầu.

Giá trị trả về
	Tệp có phiên bản hoặc null nếu không tìm thấy

hashCode

public int hashCode ()

Giá trị trả về
int

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Xoá một attributeName nhất định khỏi tính năng theo dõi.

Tham số
attributeName	String: thuộc tính để ngừng theo dõi

setBuildBranch

public void setBuildBranch (String branch)

Đặt nhánh bản dựng

Tham số
branch	String: tên nhánh

setBuildFlavor

public void setBuildFlavor (String buildFlavor)

Đặt phiên bản bản dựng.

setBuildId

public void setBuildId (String buildId)

Đặt giá trị nhận dạng duy nhất của bản dựng đang được kiểm thử. Không được để trống.

Tham số
buildId	String

setDeviceSerial

public void setDeviceSerial (String serial)

Đặt số sê-ri ITestDevice liên kết với bản dựng này.

Tham số
serial	String: số sê-ri của ITestDevice mà bản dựng này được thực thi.

setFile

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

Lưu trữ một tệp có tên đã cho trong thông tin bản dựng này.

Tham số
name	String: tên duy nhất của tệp
file	File: ERROR(/File) cục bộ
version	String: phiên bản tệp

setFile

public void setFile (BuildInfoKey.BuildInfoFileKey key, 
                File file, 
                String version)

Lưu trữ một tệp được cung cấp BuildInfoFileKey trong thông tin bản dựng này.

Tham số
key	BuildInfoKey.BuildInfoFileKey: tên duy nhất của tệp dựa trên BuildInfoFileKey.
file	File: ERROR(/File) cục bộ
version	String: phiên bản tệp

setProperties

public void setProperties (BuildInfoProperties... properties)

Đặt BuildInfoProperties cho thực thể IBuildInfo. Ghi đè mọi thuộc tính hiện có đã đặt trước đó.

Tham số
properties	BuildInfoProperties: Danh sách thuộc tính cần thêm.

setTestTag

public void setTestTag (String testTag)

Đặt tên duy nhất cho các chương trình kiểm thử đang chạy.

Tham số
testTag	String

stageRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

Đặt một tệp thuộc về các tệp từ xa trong thư mục gốc của thông tin bản dựng.

TODO(b/138416078): Xoá giao diện này và phương thức gọi của giao diện đó khi các mô-đun mà kiểm thử yêu cầu có thể được tạo đúng cách thành đầu ra cho chính thư mục của mô-đun kiểm thử.

Tham số
fileName	String: Tên của tệp sẽ nằm trong các tệp từ xa.
workingDir	File: đối tượng ERROR(/File) của thư mục để đưa tệp vào giai đoạn.

Giá trị trả về
File	đối tượng ERROR(/File) của tệp được sắp xếp trong workingDir cục bộ.

toProto

public BuildInformation.BuildInfo toProto ()

Tuần tự hoá thực thể BuildInfo thành protobuf.

Giá trị trả về
BuildInformation.BuildInfo

toString

public String toString ()

Giá trị trả về
String

Phương thức được bảo vệ

addAllBuildAttributes

protected void addAllBuildAttributes (BuildInfo build)

Phương thức trợ giúp để sao chép các thuộc tính bản dựng, nhánh và phiên bản của bản dựng khác.

Tham số
build	BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

Phương thức trợ giúp để sao chép tất cả tệp từ bản dựng khác.

Tạo đường liên kết cứng mới đến các tệp để mỗi bản dựng sẽ có một đường dẫn tệp duy nhất đến tệp đó.

Tham số
build	BuildInfo

Gửi
	nếu một ngoại lệ được gửi khi tạo đường liên kết cứng.

applyBuildProperties

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

Cho phép áp dụng một số IBuildInfo.BuildInfoProperties và có thể xử lý theo cách khác.

Tham số
origFileConsidered	VersionedFile: VersionedFile đang được xem.
build	IBuildInfo: bản dựng gốc đang được sao chép
receiver	IBuildInfo: bản dựng nhận thông tin.

Giá trị trả về
boolean	Đúng nếu chúng ta đã áp dụng các thuộc tính và bỏ qua việc xử lý thêm. Nếu không thì giá trị sẽ là false.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

Giá trị trả về
MultiMap<String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

Giá trị trả về

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

Giá trị trả về
MultiMap<String, VersionedFile>