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 khai | |
---|---|
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 |
default void | allowStagingRemoteFile (boolean stageRemoteFile) Đặt quyền cho phép dàn dựng các tập tin từ xa. |
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 |
abstract IBuildInfo | clone () Nhân bản đối tượng |
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ó |
abstract | getFiles () Trả về tất cả |
abstract | getProperties () Trả về bản sao của thuộc tính hiện được đặt trên |
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ó |
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 |
default VersionedFile | getVersionedFile (String name) Phương thức trợ giúp để truy xuất |
default | getVersionedFileKeys () Trả về bộ khóa có sẵn để truy vấn |
default | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Phương thức trợ giúp để truy xuất danh sách |
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 |
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 |
abstract void | setProperties ( BuildInfoProperties... properties) Đặt |
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 khai
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 |
allowStagingRemoteFile
public void allowStagingRemoteFile (boolean stageRemoteFile)
Đặt quyền cho phép dàn dựng các tập tin từ xa.
Thông số | |
---|---|
stageRemoteFile | boolean |
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 |
getAppPackageFiles
publicgetAppPackageFiles ()
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 abstractgetBuildAttributes ()
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-userdebugTrả 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 abstractgetFiles ()
Trả về tất cả VersionedFile
được lưu trữ trong BuildInfo
này.
Trả lại | |
---|---|
getProperties
public abstractgetProperties ()
Trả về bản sao của thuộc tính hiện được đặt trên IBuildInfo
.
Trả lại | |
---|---|
getRemoteFiles
publicgetRemoteFiles ()
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
publicgetVersionedFileKeys ()
Trả về bộ khóa có sẵn để truy vấn VersionedFile
thông qua getFile(BuildInfoFileKey)
.
Trả lại | |
---|---|
getVersionedFiles
publicgetVersionedFiles (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 |