Thông tin bản dựng

public class BuildInfo
extends Object implements IBuildInfo

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

Cách triển khai chung của một IBuildInfo cần được liên kết bằng ITestDevice.

Tóm tắt

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

BuildInfo()

Tạo BuildInfo bằ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 thử nghiệm 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 của 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 cụ thể vào bản dựng này.

boolean equals(Object obj)

static IBuildInfo fromProto(BuildInformation.BuildInfo protoBuild)

Đảo ngược thao tác đối với toProto() để lấy lại thực thể.

getAppPackageFiles()

Tải một bản sao của tập hợp(các) tệp APK ứng dụng trên máy và phiên bản của những tệp đó.

getBuildAttributes()

Lấy một tập hợp cặp tên-giá trị gồm 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 điều khiển 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 đủ cho 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 cụ thể.

File getFile(BuildInfoKey.BuildInfoFileKey key)

Phương thức trợ giúp để truy xuất tệp bằng một BuildInfoFileKey cho sẵn.

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 thiết lập trên IBuildInfo.

getRemoteFiles()

Nhận đường dẫn dành 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 riêng biệ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 bằng một 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 sẵn.

VersionedFile getVersionedFile(BuildInfoKey.BuildInfoFileKey key)

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

final VersionedFile getVersionedFile(String name)

Phương thức trợ giúp để truy xuất VersionedFile bằng tên cụ thể.

getVersionedFileKeys()

Trả về tập hợp các khoá 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 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 hoạt động theo dõi.

void setBuildBranch(String branch)

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

void setBuildFlavor(String buildFlavor)

Thiết lập 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)

Thiết lập 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ữ tệp có tên cụ thể 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 riêng biệt cho các chương trình kiểm thử đang chạy.

File stageRemoteFile(String fileName, File workingDir)

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

BuildInformation.BuildInfo toProto()

Tuần tự hoá một thực thể BuildInfo thành một 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 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 một cách xử lý khác.

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

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

Thông tin bản dựng

public BuildInfo ()

Tạo BuildInfo bằ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 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 đó. Lưu ý rằng APK sẽ được trả về từ getAppPackageFiles() theo thứ tự thêm bằng phương thức này.

Tham số
appPackageFile File

version String

addBuildAttributes

public void addBuildAttribute (String attributeName, 
                String attributeValue)

Thêm thuộc tính bản dựng. Thao tác này không cho phép ghi đè một 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

thêmBuildAttributes

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 sẽ được thêm

allowStagingRemoteFile

public void allowStagingRemoteFile (boolean stageRemoteFile)

Đặt quyền để cho phép thử nghiệm các tệp từ xa.

Tham số
stageRemoteFile boolean

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ị xoá.

Tham số
doNotClean

sao chép

public IBuildInfo clone ()

Giá trị trả về
IBuildInfo

sao chépTất cả tệpTừ

public final void copyAllFileFrom (BuildInfo build)

Sao chép tất cả VersionedFile từ một bản dựng cụ thể 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

từProto

public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)

Đảo ngược thao tác đối với toProto() để lấy lại thực thể.

Tham số
protoBuild BuildInformation.BuildInfo

Giá trị trả về
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Tải một bản sao của tập hợp(các) tệp APK ứng dụng trên máy và phiên bản của những tệp đó. Đơn đặt hàng bị trả lại khớp với thứ tự thêm tệp APK vào IAppBuildInfo.

Giá trị trả về

nhậnBuildAttributes

public  getBuildAttributes ()

Lấy một tập hợp cặp tên-giá trị gồm các thuộc tính bổ sung mô tả bản dựng.

Giá trị trả về
ERROR(/Map) của thuộc tính bản dựng. Giá trị này 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 điều khiển 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 đặt/không áp dụng

tạo hương vị

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

Giá trị trả về
String phiên bản bản dựng hoặc null nếu không đặ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 có giá trị rỗng. Giá trị mặc định là UNKNOWN_BUILD_ID.

Giá trị trả về
String

getBuildTargetName

public String getBuildTargetName ()

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

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 bản dựng)]

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 cụ thể.

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 bằng một BuildInfoFileKey cho sẵn.

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 thiết lập trên IBuildInfo.

Giá trị trả về

getRemoteFiles

public  getRemoteFiles ()

Nhận đường dẫn dành 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 riêng biệ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 bằng một BuildInfoFileKey đã cho.

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 cụ thể.

Tham số
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey được yêu cầu.
Giá trị trả về
VersionedFile Tệp đã tạo 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 bằng tên cụ thể.

Giá trị trả về
VersionedFile Tệp đã tạo 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 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 liên kết với một BuildInfoFileKey nhất định. Nếu khoá cho phép lưu trữ một danh sách.

Tham số
key BuildInfoKey.BuildInfoFileKey: BuildInfoFileKey được yêu cầu.
Giá trị trả về
Tệp đã tạo phiên bản hoặc null nếu không tìm thấy

hashCode

public int hashCode ()

Giá trị trả về
int

removeBuildAttributes

public void removeBuildAttribute (String attributeName)

Xoá một attributeName nhất định khỏi hoạt độ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)

Thiết lập 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 có giá trị rỗng.

Tham số
buildId String

setDeviceSerial

public void setDeviceSerial (String serial)

Thiết lập 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ữ tệp có tên cụ thể 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 riêng biệ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 đè bất kỳ thuộc tính hiện có được đặt trước đó.

Tham số
properties BuildInfoProperties: Danh sách các cơ sở lưu trú cần thêm.

setTestTag

public void setTestTag (String testTag)

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

Tham số
testTag String

giai đoạn Từ xa

public File stageRemoteFile (String fileName, 
                File workingDir)

Đưa một tệp thuộc tệp từ xa vào 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 nó khi các mô-đun được yêu cầu trong bài kiểm thử có thể được tạo đầu ra đúng cách vào chính thư mục của mô-đun kiểm thử.

Tham 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 để bố trí tệp.
Giá trị trả về
File đối tượng ERROR(/File) của tệp được thử nghiệm trong workDir cục bộ.

toProto

public BuildInformation.BuildInfo toProto ()

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

Giá trị trả về
BuildInformation.BuildInfo

toString

public String toString ()

Giá trị trả về
String

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

thêmTất cả thuộc tính bản dựng

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 từ bản dựng khác.

Tham số
build BuildInfo

addTất cả các tệp

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 đườ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 .

Tham số
build BuildInfo

Gửi
nếu xảy ra ngoại lệ khi tạo đường 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.

Tham số
origFileConsidered VersionedFile: VersionedFile hiện đã đượ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. Sai nếu không.

nhận thuộc tính đa bản đồ

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>