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 |
abstract IBuildInfo | clone () Nhân bản đối tượng |
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 |
abstract | getFiles () Trả về tất cả |
abstract | getProperties () Trả về một bản sao của các thuộc tính hiện được đặt trên |
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 |
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 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 |
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 |
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 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 |
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 |
getAppPackageFiles
publicgetAppPackageFiles ()
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 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 | |
---|---|
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-userdebugtrả 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 abstractgetFiles ()
Trả về tất cả VersionedFile
s được lưu trữ trong BuildInfo
này.
trả lại | |
---|---|
getProperties
public abstractgetProperties ()
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
publicgetRemoteFiles ()
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
publicgetVersionedFileKeys ()
Trả về bộ khóa có sẵn để truy vấn VersionedFile
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
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 |