Thông tin bản dựng

public class BuildInfo
extends Object implements IBuildInfo

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


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

Bản tóm tắt

Nhà thầu xây dựng công cộng

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 BuildInfo

Phương pháp công khai

void addAppPackageFile (File appPackageFile, String version)

Thêm tệp apk cục bộ và phiên bản liên quan của nó.

void addBuildAttribute (String attributeName, String attributeValue)

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

void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

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

void cleanUp ()

Dọn dẹp mọi tập tin xây dựng tạm thời

void cleanUp ( doNotClean) cleanUp ( doNotClean)

Phiên bản 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 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 phiên bản.

getAppPackageFiles ()

Nhận 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 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 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 xây dựng bị trì hoãn tải xuống.

String getTestTag ()

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

String getVersion ( BuildInfoKey.BuildInfoFileKey key)

Phương thức trợ giúp để truy xuất phiên bản tệp có 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 nhất định.

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 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)

Xóa 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 nối tiếp 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 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 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 pháp 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 một cách xử lý khác.

MultiMap <String, String> getAttributesMultiMap ()
getVersionedFileMap ()
MultiMap <String, VersionedFile > getVersionedFileMapFull ()

Nhà thầu xây dựng công cộng

Thông tin bản dựng

public BuildInfo ()

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

Thông tin bản dựng

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 pháp 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 quan của nó. Lưu ý rằng các gói ứng dụng sẽ được trả về từ getAppPackageFiles() theo thứ tự chúng được thêm vào bằng phương thức này.

Thông số
appPackageFile File

version String

addBuildAttribution

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Thêm thuộc tính xây dựng. Điều này không cho phép ghi đè 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

addBuildAttribution

public void addBuildAttributes ( buildAttributes)

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

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

dọn dẹp

public void cleanUp ()

Dọn dẹp mọi tập tin xây dựng tạm thời

dọn dẹp

public void cleanUp ( doNotClean)

Phiên bản 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

sao chépAllFileFrom

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 dựng 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 nghịch đảo 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 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

getBuildAttribution

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
ERROR(/Map) của thuộc tính bản dựng. Sẽ không null , nhưng có thể trống.

getBuildBranch

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 được đặ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.

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 hệ điều hành)-(bản dựng biến thể). tức là generic-linux-userdebug

Trả lại
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ề mã định danh duy nhất của bản dựng đang được thử nghiệm. Không bao giờ nên 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.

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 phiên bản bản dựng và tên nhánh. [tức là (tên 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 có 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 được lưu trữ trong BuildInfo này.

Trả lại

getProperties

public  getProperties ()

Trả về bản sao của 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 cấu phần phần mềm xây dựng bị trì hoãn tải xuống.

Trả lại

getTestTag

public String getTestTag ()

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

Trả lại
String

lấy phiên bản

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Phương thức trợ giúp để truy xuất phiên bản tệp có 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

lấy phiên bản

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 nhất định.

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 thông 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 được liên kết với một BuildInfoFileKey nhất định. 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ỏBuildAttribution

public void removeBuildAttribute (String attributeName)

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

Thông số
attributeName String : thuộc tính dừ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 rỗng.

Thông số
buildId String

setDeviceSerial

public void setDeviceSerial (String serial)

Đặt nối tiếp 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 trong thông tin bản dựng này.

Thông số
name String : tên duy nhất của tập tin

file File : ERROR(/File)

version String : phiên bản tập tin

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 tin

setProperties

public void setProperties (BuildInfoProperties... properties)

Đặt BuildInfoProperties cho phiên bản IBuildInfo . Ghi đè mọi thuộc tính hiện có được đặt trước đó.

Thông 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 bài kiểm tra đang chạy.

Thông số
testTag String

giai đoạnRemoteFile

public File stageRemoteFile (String fileName, 
                File workingDir)

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

TODO(b/138416078): Xóa giao diện này và lệnh gọi của nó khi các mô-đun được yêu cầu bởi quá trình kiểm tra có thể được tạo đầu ra chính xác cho chính thư mục của mô-đun kiểm tra.

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 để sắp xếp tệp.

Trả lại
File đối tượng ERROR(/File) của tệp được sắp xếp trong WorkingDir cục bộ.

tớiProto

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ệ

addAllBuildAttribution

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

thêmTất cả các tập tin

protected void addAllFiles (BuildInfo build)

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

Tạo 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 có 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 một cách xử lý khác.

Thông số
origFileConsidered VersionedFile : Phiên bản hiện đang được xem xét VersionedFile .

build IBuildInfo : bản dựng ban đầu đang được sao chép

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à việc xử lý tiếp theo sẽ bị bỏ qua. Sai nếu không.

getAttributMultiMap

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 >