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 để 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 ID bản dựng không xác định.

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 được liên kết của nó.

abstract void addBuildAttribute (String attributeName, String attributeValue)

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

default void addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes)

Thêm thuộc tính xây 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 ()

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

default getAppPackageFiles ()

Nhận một 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 với BuildInfoFileKey đã cho.

abstract getFiles ()

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

abstract getProperties ()

Trả về một 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 cho các tạo phẩm bản dựng 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 pháp trợ giúp để truy xuất phiên bản tệp với 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 đã cho.

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 qua getFile(BuildInfoFileKey) .

default getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key)

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

default void removeBuildAttribute (String attributeName)

Xóa một 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 sê-ri 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 đã 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 chạy.

default File stageRemoteFile (String fileName, File workingDir)

Tạo một tệp là một phần của các 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 để 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 ID bản dựng không xác định.

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

Thông số
appPackageFile File

version String

thêmBuildAttribute

public abstract void addBuildAttribute (String attributeName, 
                String attributeValue)

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

thêmBuildAttributes

public void addBuildAttributes ( buildAttributes)

Thêm thuộc tính xây 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 ()

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

trả lại
IBuildInfo

getAppPackageFiles

public  getAppPackageFiles ()

Nhận một 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

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.

trả lại
một ERROR(/Map) của các thuộc tính bản dựng. Sẽ không null , nhưng có thể trống.

getBuildChi nhánh

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 đặ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.

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 os)-(bản dựng biến thể). tức là chung-linux-userdebug

trả lại
String hương vị bản 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 có giá trị 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.

Một 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 hương vị bản dựng và tên nhánh. [tức là (tên chi 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 với 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 s được lưu trữ trong BuildInfo này.

trả lại

getProperties

public abstract  getProperties ()

Trả về một bản sao của các 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 tạo phẩm bản dựng bị trì hoãn tải xuống.

trả lại

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.

trả lại
String

getVersion

public String getVersion (BuildInfoKey.BuildInfoFileKey key)

Phương pháp trợ giúp để truy xuất phiên bản tệp với 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

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.

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 đã cho.

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 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 s được liên kết với BuildInfoFileKey đã cho. 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ỏBuildAttribute

public void removeBuildAttribute (String attributeName)

Xóa một tên thuộc tính nhất định 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

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 có giá trị rỗng.

Thông số
buildId String

setDeviceNối tiếp

public abstract void setDeviceSerial (String serial)

Đặt sê-ri 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 đã 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 chạy.

Thông số
testTag String

giai đoạnTừ xaTệp

public File stageRemoteFile (String fileName, 
                File workingDir)

Tạo một tệp là một phần của các 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): Xóa giao diện này và trình gọi của nó khi các mô-đun theo yêu cầu của thử nghiệm có thể được xây dựng phù hợp để xuất ra chính thư mục của mô-đun thử nghiệm.

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 để tạo tập tin.

trả lại
File đối tượng ERROR(/File) của tệp được dàn dựng 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