Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

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

Các lớp lồng nhau

enum IBuildInfo.BuildInfoProperties

Một số thuộc tính mà IBuildInfo có thể phải điều chỉnh một số cách xử lý của nó.

Hằng số

String REMOTE_FILE_PREFIX

Tiền tố được sử dụng trong tên để cho biết tệp được đặt để tải xuống chậm.

String REMOTE_FILE_VERSION

Tệp từ xa không được tạo phiên bản.

String UNKNOWN_BUILD_ID

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

Phương pháp công khai

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

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 bản dựng tạm thời

abstract void cleanUp ( doNotDelete) cleanUp ( doNotDelete)

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

abstract IBuildInfo clone ()

Sao chép đố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 điều khiển nguồn mà bản dựng đang được kiểm tra được tạo ra từ đó.

abstract String getBuildFlavor ()

Phương thức tùy chọn để trả về loại bản dựng đang được kiểm tra.

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 tệp có tên đã cho.

default File getFile ( BuildInfoKey.BuildInfoFileKey key)

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

abstract getFiles ()

Trả về tất cả các phiên bản được lưu trữ trong VersionedFile BuildInfo .

abstract getProperties ()

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

default getRemoteFiles ()

Nhận đường dẫn để xây dựng các tạo tác bị trì hoãn tải xuống.

abstract String getTestTag ()

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

default String getVersion ( BuildInfoKey.BuildInfoFileKey key)

Phương thức người trợ giúp để truy xuất phiên bản tệp với BuildInfoFileKey .

abstract String getVersion (String name)

Phương thức người 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 của người trợ giúp để lấy một Phiên bản đã được BuildInfoFileKey VersionedFile định.

default VersionedFile getVersionedFile (String name)

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

default getVersionedFileKeys ()

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

default getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

Phương thức trợ giúp để truy xuất danh sách các phiên bản được liên kết với một VersionedFile nhất BuildInfoFileKey .

default void removeBuildAttribute (String attributeName)

Xóa một Thuộc tính đã cho 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 số nhận dạng 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 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 đã cho 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 được 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ự một 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 để tải xuống chậm.

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

REMOTE_FILE_VERSION

public static final String REMOTE_FILE_VERSION

Tệp từ xa không được tạo 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 ID bản dựng không xác định.

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

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

Thông số
appPackageFile File

version String

addBuildAttribute

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

addBuildAttributes

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

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ị xóa.

Thông số
doNotDelete

dòng vô tính

public abstract IBuildInfo clone ()

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

Lợi nhuận
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ự đã trả lại khớp với thứ tự mà các apk đã được thêm vào IAppBuildInfo .

Lợi nhuận

getBuildAttributes

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.

Lợi nhuận
một ERROR(/Map) của các thuộc tính xây 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 điều khiển nguồn mà bản dựng đang được kiểm tra được tạo ra từ đó.

Lợi nhuận
String nhánh xây dựng hoặc null nếu không được đặt / không áp dụng

getBuildFlavor

public abstract String getBuildFlavor ()

Phương thức tùy chọn để trả về loại bản dựng đang được kiểm tra.

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

Lợi nhuận
String hương vị 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ờ được rỗng. Mặc định là UNKNOWN_BUILD_ID .

Lợi nhuận
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 của hương vị bản dựng và tên nhánh. [tức là (tên chi nhánh) - (tạo hương vị)]

Lợi nhuận
String

getDeviceSerial

public abstract String getDeviceSerial ()

Lợi nhuận
String sê-ri ITestDevice mà bản dựng này đã được thực thi. 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 tệp có tên đã cho.

Lợi nhuận
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 người trợ giúp để truy xuất tệp với BuildInfoFileKey .

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

Lợi nhuận
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ả các phiên bản được lưu trữ trong VersionedFile BuildInfo .

Lợi nhuận

getProperties

public abstract  getProperties ()

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

Lợi nhuận

getRemoteFiles

public  getRemoteFiles ()

Nhận đường dẫn để xây dựng các tạo tác bị trì hoãn tải xuống.

Lợi nhuận

getTestTag

public abstract String getTestTag ()

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

Lợi nhuận
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Phương thức người trợ giúp để truy xuất phiên bản tệp với BuildInfoFileKey .

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

Lợi nhuận
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 người trợ giúp để truy xuất phiên bản tệp có tên đã cho.

Lợi nhuận
String phiên bản hình ảnh hoặc null nếu không tìm thấy

getVersonedFile

public VersionedFile getVersionedFile (BuildInfoKey.BuildInfoFileKey key)

Phương thức của người trợ giúp để lấy một Phiên bản đã được BuildInfoFileKey VersionedFile định.

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

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

getVersonedFile

public VersionedFile getVersionedFile (String name)

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

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

getVersonedFileKeys

public  getVersionedFileKeys ()

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

Lợi nhuận

getVersonedFiles

public  getVersionedFiles (BuildInfoKey.BuildInfoFileKey key)

Phương thức trợ giúp để truy xuất danh sách các phiên bản được liên kết với một VersionedFile nhất BuildInfoFileKey . 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.

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

removeBuildAttribute

public void removeBuildAttribute (String attributeName)

Xóa một Thuộc tính đã cho khỏi theo dõi.

Thông số
attributeName String : thuộc tính để ngừ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

setBuildFlavor

public abstract void setBuildFlavor (String buildFlavor)

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

setBuildId

public abstract void setBuildId (String buildId)

Đặt số nhận dạng duy nhất của bản dựng đang được thử nghiệm. Không bao giờ được rỗng.

Thông số
buildId String

setDeviceSerial

public abstract void setDeviceSerial (String serial)

Đặt nối tiếp ITestDevice 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 đã 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 abstract 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 abstract void setTestTag (String testTag)

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

Thông số
testTag String

stageRemoteFile

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.

VIỆC CẦN LÀM (b / 138416078): Loại bỏ giao diện này và trình gọi của nó khi các mô-đun được yêu cầu bởi một thử nghiệm có thể được xây dựng đúng đầu ra cho chính thư mục của mô-đun thử nghiệm.

Thông số
fileName String : Tên của tệp sẽ đượ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.

Lợi nhuận
File đối tượng ERROR(/File) của tệp được tổ chức trong workingDir cục bộ.

toProto

public BuildInformation.BuildInfo toProto ()

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

Lợi nhuận
BuildInformation.BuildInfo