IBuildInfo

public interface IBuildInfo

com.android.tradefed.build.IBuildInfo


Giữ thông tin về bản dựng đang được thử nghiệm.

Bản 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 không được phiên bản.

String UNKNOWN_BUILD_ID

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

Phương pháp công cộng

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

abstract void addBuildAttribute (String attributeName, String attributeValue)

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

default void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

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

abstract void cleanUp ()

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

abstract void cleanUp ( doNotDelete) cleanUp ( doNotDelete)

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

abstract IBuildInfo clone ()

Nhân bản đối tượng IBuildInfo .

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

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

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

abstract String getBuildFlavor ()

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

abstract String getBuildId ()

Trả về mã định danh duy nhất của bản dựng đang được thử nghiệm.

abstract String getBuildTargetName ()

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

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

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

default File getFile ( BuildInfoKey.BuildInfoFileKey key)

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

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 thuộc tính hiện được đặt trên IBuildInfo .

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

abstract String getTestTag ()

Trả về một tên duy nhất cho các bài kiểm tra đ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 có 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.

default VersionedFile getVersionedFile ( BuildInfoKey.BuildInfoFileKey key)

Phương thức trợ giúp để truy xuất VersionedFile với BuildInfoFileKey nhất định.

default VersionedFile getVersionedFile (String name)

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

default getVersionedFileKeys ()

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

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

default void removeBuildAttribute (String attributeName)

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

abstract void setBuildBranch (String branch)

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

abstract void setBuildFlavor (String buildFlavor)

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

abstract void setBuildId (String buildId)

Đặt mã định danh duy nhất của bản dựng đang được thử nghiệm.

abstract void setDeviceSerial (String serial)

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

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

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

abstract void setTestTag (String testTag)

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

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

default BuildInformation.BuildInfo toProto ()

Tuần tự hóa một phiên bản 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 không được phiên bản.

Giá trị hiện có: ""

UNKNOWN_BUILD_ID

public static final String UNKNOWN_BUILD_ID

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

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

Phương pháp công cộng

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

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

dọn dẹp

public abstract void cleanUp ( doNotDelete)

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

Thông số
doNotDelete

dòng vô tính

public abstract IBuildInfo clone ()

Nhân bản đối tượng IBuildInfo .

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

Trả lại
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 được liên kết với bản dựng này.

có được file

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

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

Trả lại

getProperties

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

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

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 abstract 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 abstract void setBuildFlavor (String buildFlavor)

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

setBuildId

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

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