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 Một IBuildInfo đại diện cho một ứng dụng Android và (các) gói thử nghiệm của nó. Thiết bịBuildInfo Một IBuildInfo đại diện cho một thiết bị Android hoàn chỉnh và (tùy chọn) các thử nghiệm của nó. Thư mụcBuildInfo Triển khai cụ thể IFolderBuildInfo . OtatoolsBuildThông tin Một IBuildInfo chứa các tạo phẩm otatools.

Các lớp con gián tiếp đã biết AppDeviceBuildInfo , ClusterBuildInfo , DeviceFolderBuildInfo , OtaDeviceBuildInfo AppDeviceBuildThông tin Lớp này không được dùng nữa. Sử dụng IDeviceBuildInfo trực tiếp. ClusterBuildThông tin Một lớp IBuildInfo dành cho các bản dựng được tạo từ TFC. DeviceFolderBuildInfo Một IDeviceBuildInfo cũng chứa các tạo phẩm xây dựng khác có trong một thư mục trên hệ thống tệp cục bộ. OtaDeviceBuildThông tin Một IDeviceBuildInfo được sử dụng để kiểm tra cập nhật qua mạng.

---

Triển khai chung của IBuildInfo nên được liên kết với ITestDevice .

Bản tóm tắt

nhà thầu công cộng
BuildInfo () Tạo BuildInfo bằng các giá trị thuộc tính mặc định.
BuildInfo (String buildId, String buildTargetName) Tạo 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 được liên kết của nó.
void	addBuildAttribute (String attributeName, String attributeValue) Thêm một thuộc tính xây dựng.
void	addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) Thêm thuộc tính xây dựng
void	cleanUp () Dọn dẹp mọi tệp bản dựng tạm thời
void	cleanUp ( doNotClean) cleanUp ( doNotClean) Phiên bản của cleanUp() trong đó một số tệp không bị xóa.
IBuildInfo	clone ()
final void	copyAllFileFrom ( BuildInfo build) Sao chép tất cả VersionedFile từ một bản dựng nhất định sang bản này.
boolean	equals (Object obj)
static IBuildInfo	fromProto (BuildInformation.BuildInfo protoBuild) Thao tác ngược với toProto() để lấy lại phiên bản.
	getAppPackageFiles () Nhận một bản sao của tập hợp (các) tệp apk ứng dụng cục bộ và các phiên bản của chúng.
	getBuildAttributes () Nhận một tập hợp các 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 pháp tùy chọn để trả về nhánh kiểm soát nguồn mà bản dựng đang được thử nghiệm được tạo ra từ đó.
String	getBuildFlavor () Phương pháp tùy chọn để trả về loại bản dựng đang được thử nghiệm.
String	getBuildId () Trả về mã định danh duy nhất của bản dựng đang được thử nghiệm.
String	getBuildTargetName () Trả lại tên đầy đủ cho bản dựng đang được thử nghiệm.
String	getDeviceSerial ()
File	getFile (String name) Phương thức trợ giúp để truy xuất một tệp có tên đã cho.
File	getFile ( BuildInfoKey.BuildInfoFileKey key) Phương thức trợ giúp để truy xuất tệp với BuildInfoFileKey đã cho.
	getFiles () Trả về tất cả VersionedFile s được lưu trữ trong BuildInfo này.
	getProperties () Trả về một 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 tạo phẩm bản dựng bị trì hoãn tải xuống.
String	getTestTag () Trả lại một tên duy nhất cho các bài kiểm tra đang được chạy.
String	getVersion ( BuildInfoKey.BuildInfoFileKey key) Phương pháp trợ giúp để truy xuất phiên bản tệp với BuildInfoFileKey đã cho.
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 với BuildInfoFileKey đã cho.
final VersionedFile	getVersionedFile (String name) Phương thức trợ giúp để truy xuất VersionedFile có tên đã cho.
	getVersionedFileKeys () Trả về bộ khóa có sẵn để truy vấn VersionedFile qua getFile(BuildInfoFileKey) .
final	getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Phương thức trợ giúp để truy xuất danh sách VersionedFile s được liên kết với BuildInfoFileKey đã cho.
int	hashCode ()
void	removeBuildAttribute (String attributeName) Xóa một tên thuộc tính nhất định khỏi theo dõi.
void	setBuildBranch (String branch) Đặt nhánh xây dựng
void	setBuildFlavor (String buildFlavor) Đặt hương vị xây dựng.
void	setBuildId (String buildId) Đặt mã định danh duy nhất của bản dựng đang được thử nghiệm.
void	setDeviceSerial (String serial) Đặt sê-ri ITestDevice được 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 phiên bản IBuildInfo .
void	setTestTag (String testTag) Đặt tên duy nhất cho các bài kiểm tra đang chạy.
File	stageRemoteFile (String fileName, File workingDir) Tạo một tệp là một phần của 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ự hóa một phiên bản BuildInfo thành một protobuf.
String	toString ()

phương pháp được bảo vệ
void	addAllBuildAttributes ( BuildInfo build) Phương thức trợ giúp để sao chép các thuộc tính, nhánh và hương vị của bản dựng từ bản dựng khác.
void	addAllFiles ( BuildInfo build) Phương thức trợ giúp để sao chép tất cả cá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ể thực hiện xử lý khác.
MultiMap <String, String>	getAttributesMultiMap ()
	getVersionedFileMap ()
MultiMap <String, VersionedFile >	getVersionedFileMapFull ()

nhà thầu công cộng

BuildInfo

public BuildInfo ()

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

BuildInfo

public BuildInfo (String buildId, 
                String buildTargetName)

Tạo BuildInfo

Thông số
buildId	String : id bản dựng
buildTargetName	String : tên mục tiêu xây 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 được liên kết của nó. Lưu ý rằng các gói ứng dụng sẽ được trả về từ getAppPackageFiles() theo thứ tự mà chúng được thêm vào bằng phương pháp này.

Thông số
appPackageFile	File
version	String

thêmBuildAttribute

public void addBuildAttribute (String attributeName, 
                String attributeValue)

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

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

thêmBuildAttributes

public void addBuildAttributes ( buildAttributes)

Thêm thuộc tính xây dựng

Thông số
buildAttributes	: Bản đồ các thuộc tính sẽ được thêm vào

dọn dẹp

public void cleanUp ()

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

dọn dẹp

public void cleanUp ( doNotClean)

Phiên bản của cleanUp() trong đó một số tệp không bị xóa.

Thông số
doNotClean

dòng vô tính

public IBuildInfo clone ()

trả lại
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 sang bản này.

Thông số
build	BuildInfo

bằng

public boolean equals (Object obj)

Thông số
obj	Object

trả lại
boolean

từProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Thao tác ngược với toProto() để lấy lại phiên bản.

Thông số
protoBuild	BuildInformation.BuildInfo

trả lại
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

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

trả lại

getBuildAttributes

public  getBuildAttributes ()

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

trả lại
	một ERROR(/Map) của các thuộc tính bản dựng. Sẽ không null , nhưng có thể trống.

getBuildChi nhánh

public String getBuildBranch ()

Phương pháp tùy chọn để trả về nhánh kiểm soát nguồn mà bản dựng đang được thử nghiệm được tạo ra từ đó.

trả lại
String	nhánh xây dựng hoặc null nếu không đặt/không áp dụng

getBuildHương vị

public String getBuildFlavor ()

Phương pháp tùy chọn để trả về loại bản dựng đang được thử nghiệm.

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ề (bản dựng sản phẩm)-(bản dựng os)-(bản dựng biến thể). tức là chung-linux-userdebug

trả lại
String	hương vị bản dựng hoặc null nếu không được đặt/không áp dụng

getBuildId

public String getBuildId ()

Trả về mã định danh duy nhất của bản dựng đang được thử nghiệm. Không bao giờ nên có giá trị rỗng. Mặc định là UNKNOWN_BUILD_ID .

trả lại
String

getBuildTargetName

public String getBuildTargetName ()

Trả lại tên đầy đủ cho bản dựng đang được thử nghiệm.

Một cách triển khai phổ biến là xây dựng tên mục tiêu bản dựng từ sự kết hợp giữa hương vị bản dựng và tên nhánh. [tức là (tên chi nhánh)-(xây dựng hương vị)]

trả lại
String

getDeviceSerial

public String getDeviceSerial ()

trả lại
String

có được file

public File getFile (String name)

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

trả lại
File	tệp hình ảnh hoặc null nếu không tìm thấy

có được file

public File getFile (BuildInfoKey.BuildInfoFileKey key)

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

Thông số
key	BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey được yêu cầu.

trả lại
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 s được lưu trữ trong BuildInfo này.

trả lại

getProperties

public  getProperties ()

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

trả lại

getRemoteFiles

public  getRemoteFiles ()

Nhận đường dẫn cho các tạo phẩm bản dựng bị trì hoãn tải xuống.

trả lại

getTestTag

public String getTestTag ()

Trả lại một tên duy nhất cho các bài kiểm tra đang được chạy.

trả lại
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Phương pháp trợ giúp để truy xuất phiên bản tệp với BuildInfoFileKey đã cho.

Thông số
key	BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey được yêu cầu.

trả lại
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.

trả lại
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 với BuildInfoFileKey đã cho.

Thông số
key	BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey được yêu cầu.

trả lại
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 đã cho.

trả lại
VersionedFile	Tệp được phiên bản hoặc null nếu không tìm thấy

getVersionedFileKeys

public  getVersionedFileKeys ()

Trả về bộ khóa có sẵn để truy vấn VersionedFile qua getFile(BuildInfoFileKey) .

trả lại

getVersionedFiles

public final  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

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

Thông số
key	BuildInfoKey.BuildInfoFileKey : BuildInfoFileKey được yêu cầu.

trả lại
	Tệp được phiên bản hoặc null nếu không tìm thấy

Mã Băm

public int hashCode ()

trả lại
int

loại bỏBuildAttribute

public void removeBuildAttribute (String attributeName)

Xóa một tên thuộc tính nhất định khỏi theo dõi.

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

setBuildBranch

public void setBuildBranch (String branch)

Đặt nhánh xây dựng

Thông số
branch	String : tên chi nhánh

setBuildHương vị

public void setBuildFlavor (String buildFlavor)

Đặt hương vị xây dựng.

setBuildId

public void setBuildId (String buildId)

Đặt mã định danh duy nhất của bản dựng đang được thử nghiệm. Không bao giờ nên có giá trị rỗng.

Thông số
buildId	String

setDeviceNối tiếp

public void setDeviceSerial (String serial)

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

Thông 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.

Thông số
name	String : tên duy nhất của tệp
file	File : ERROR(/File)
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.

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

setProperties

public void setProperties (BuildInfoProperties... properties)

Đặt BuildInfoProperties cho phiên bản IBuildInfo . Ghi đè bất kỳ thuộc tính hiện có nào được đặt trước đó.

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

setTestTag

public void setTestTag (String testTag)

Đặt tên duy nhất cho các bài kiểm tra đang chạy.

Thông số
testTag	String

giai đoạnTừ xaTệp

public File stageRemoteFile (String fileName, 
                File workingDir)

Tạo một tệp là một phần của các tệp từ xa trong thư mục gốc của thông tin bản dựng.

VIỆC CẦN LÀM(b/138416078): Xóa giao diện này và trình gọi của nó khi các mô-đun theo yêu cầu của thử nghiệm có thể được xây dựng phù hợp để xuất ra chính thư mục của mô-đun thử nghiệm.

Thông số
fileName	String : Tên của tệp được đặt trong các tệp từ xa.
workingDir	File : một đối tượng ERROR(/File) của thư mục để tạo tập tin.

trả lại
File	đối tượng ERROR(/File) của tệp được dàn dựng trong workingDir cục bộ.

toProto

public BuildInformation.BuildInfo toProto ()

Tuần tự hóa một phiên bản BuildInfo thành một protobuf.

trả lại
BuildInformation.BuildInfo

toString

public String toString ()

trả lại
String

phương pháp đượ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, nhánh và hương vị của bản dựng từ bản dựng khác.

Thông số
build	BuildInfo

addAllFiles

protected void addAllFiles (BuildInfo build)

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

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

Thông số
build	BuildInfo

ném
	nếu một ngoại lệ được đưa ra khi tạo liên kết cứng.

áp dụngBuildProperties

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

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

Thông số
origFileConsidered	VersionedFile : VersionedFile hiện được xem xét .
build	IBuildInfo : bản dựng gốc đang được nhân bản
receiver	IBuildInfo : bản dựng nhận thông tin.

trả lại
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. Sai nếu không.

getAttributesMultiMap

protected MultiMap<String, String> getAttributesMultiMap ()

trả lại
MultiMap <String, String>

getVersionedFileMap

protected  getVersionedFileMap ()

trả lại

getVersionedFileMapFull

protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()

trả lại
MultiMap <String, VersionedFile >