Thông tin IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo

Lưu giữ thông tin về bản dựng đang được kiểm thử.

Tóm tắt

Hằng số

String REMOTE_FILE_PREFIX

Tiền tố được sử dụng trong tên để cho biết tệp được đặt ở chế độ tải xuống bị trì hoãn.

String REMOTE_FILE_VERSION

Tệp từ xa chưa được tạo phiên bản.

String UNKNOWN_BUILD_ID

Giá trị mặc định khi không xác định được mã bản dựng.

Phương thức công khai

default 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 đó.

abstract void addBuildAttribute(String attributeName, String attributeValue)

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

default void addBuildAttributes( buildAttributes)

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

default void allowStagingRemoteFile(boolean stageRemoteFile)

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

abstract void cleanUp()

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

abstract void cleanUp( doNotDelete)

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

abstract IBuildInfo clone()

Sao chép đối tượng IBuildInfo.

default 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 đó.

abstract 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.

abstract 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ừ.

abstract 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ử.

abstract String getBuildId()

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

abstract String getBuildTargetName()

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

abstract String getDeviceSerial()
abstract File getFile(String name)

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

default 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.

abstract getFiles()

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

abstract getProperties()

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

default 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.

abstract 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.

default 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.

abstract 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.

default VersionedFile getVersionedFile(BuildInfoKey.BuildInfoFileKey key)

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

default VersionedFile getVersionedFile(String name)

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

default getVersionedFileKeys()

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

default 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.

default void removeBuildAttribute(String attributeName)

Xoá một attributeName nhất định khỏi hoạt động theo dõi.

abstract void setBuildBranch(String branch)

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

abstract void setBuildFlavor(String buildFlavor)

Thiết lập phiên bản bản dựng.

abstract 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ử.

abstract void setDeviceSerial(String serial)

Thiết lập sê-ri ITestDevice liên kết với bản dựng này.

abstract 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.

default 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.

abstract void setProperties(BuildInfoProperties... properties)

Đặt BuildInfoProperties cho thực thể IBuildInfo.

abstract void setTestTag(String testTag)

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

default 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.

default BuildInformation.BuildInfo toProto()

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

Hằng số

REMOTE_FILE_PREFIX

public static final String REMOTE_FILE_PREFIX

Tiền tố được sử dụng trong tên để cho biết tệp được đặt ở chế độ tải xuống bị trì hoãn.

Giá trị không đổi: "remote_file:"

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

Tệp từ xa chưa được tạo phiên bản.

Giá trị không đổi: ""

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

Giá trị mặc định khi không xác định được mã bản dựng.

Giá trị không đổi: "-1"

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 abstract 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 abstract void cleanUp ()

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

dọn dẹp

public abstract void cleanUp ( doNotDelete)

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

Tham số
doNotDelete

sao chép

public abstract IBuildInfo clone ()

Sao chép đối tượng IBuildInfo.

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 abstract  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 abstract 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 abstract 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 abstract 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 abstract 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 abstract String getDeviceSerial ()

Giá trị trả về
String sê-ri ITestDevice mà bản dựng này được thực thi trên đó. Trả về null nếu không có thiết bị nào liên kết với bản dựng này.

getFile

public abstract 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 abstract  getFiles ()

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

Giá trị trả về

getProperties

public abstract  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 abstract 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 abstract 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.

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

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 abstract void setBuildBranch (String branch)

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

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

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

Thiết lập phiên bản bản dựng.

setBuildId

public abstract 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 abstract 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 abstract 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 abstract 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 abstract 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