Thông tin bản dựng
public class BuildInfo
extends Object
implements IBuildInfo
java.lang.Object | |
↳ | com.android.tradefed.build.BuildInfo |
Triển khai chung IBuildInfo
cần được liên kết với ITestDevice
.
Bản tóm tắt
Nhà thầu xây dựng công cộng | |
---|---|
BuildInfo () Tạo | |
BuildInfo (String buildId, String buildTargetName) Tạo |
Phương pháp công khai | |
---|---|
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ó. |
void | addBuildAttribute (String attributeName, String attributeValue) Thêm thuộc tính xây dựng. |
void | addBuildAttributes ( buildAttributes) addBuildAttributes ( buildAttributes) Thêm thuộc tính bản dựng |
void | allowStagingRemoteFile (boolean stageRemoteFile) Đặt quyền cho phép dàn dựng các tập tin từ xa. |
void | cleanUp () Dọn dẹp mọi tập tin xây dựng tạm thời |
void | cleanUp ( doNotClean) cleanUp ( doNotClean) Phiên bản |
IBuildInfo | clone () |
final void | copyAllFileFrom ( BuildInfo build) Sao chép tất cả |
boolean | equals (Object obj) |
static IBuildInfo | fromProto (BuildInformation.BuildInfo protoBuild) Thao tác nghịch đảo với |
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. | |
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. | |
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ừ đó. |
String | getBuildFlavor () Phương pháp tùy chọn để trả về loại bản dựng đang được thử nghiệm. |
String | getBuildId () Trả về mã định danh duy nhất của bản dựng đang được thử nghiệm. |
String | getBuildTargetName () Trả lại tên đầy đủ cho bản dựng đang được thử nghiệm. |
String | getDeviceSerial () |
File | getFile (String name) Phương thức trợ giúp để truy xuất một tệp có tên đã cho. |
File | getFile ( BuildInfoKey.BuildInfoFileKey key) Phương thức trợ giúp để truy xuất tệp có |
getFiles () Trả về tất cả | |
getProperties () Trả về bản sao của thuộc tính hiện được đặt trên | |
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. | |
String | getTestTag () Trả về một tên duy nhất cho các bài kiểm tra đang chạy. |
String | getVersion ( BuildInfoKey.BuildInfoFileKey key) Phương thức trợ giúp để truy xuất phiên bản tệp có |
String | getVersion (String name) Phương thức trợ giúp để truy xuất phiên bản tệp có tên đã cho. |
VersionedFile | getVersionedFile ( BuildInfoKey.BuildInfoFileKey key) Phương thức trợ giúp để truy xuất |
final VersionedFile | getVersionedFile (String name) Phương thức trợ giúp để truy xuất |
getVersionedFileKeys () Trả về bộ khóa có sẵn để truy vấn | |
final | getVersionedFiles ( BuildInfoKey.BuildInfoFileKey key) Phương thức trợ giúp để truy xuất danh sách |
int | hashCode () |
void | removeBuildAttribute (String attributeName) Xóa tên thuộc tính nhất định khỏi theo dõi. |
void | setBuildBranch (String branch) Đặt nhánh xây dựng |
void | setBuildFlavor (String buildFlavor) Đặt hương vị xây dựng. |
void | setBuildId (String buildId) Đặt mã định danh duy nhất của bản dựng đang được thử nghiệm. |
void | setDeviceSerial (String serial) Đặt nối tiếp |
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. |
void | setFile ( BuildInfoKey.BuildInfoFileKey key, File file, String version) Lưu trữ một tệp được cung cấp |
void | setProperties ( BuildInfoProperties... properties) Đặt |
void | setTestTag (String testTag) Đặt tên duy nhất cho các bài kiểm tra đang chạy. |
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. |
BuildInformation.BuildInfo | toProto () Tuần tự hóa một phiên bản BuildInfo thành một protobuf. |
String | toString ()
|
Phương pháp được bảo vệ | |
---|---|
void | addAllBuildAttributes ( BuildInfo build) Phương thức trợ giúp để sao chép các thuộc tính, nhánh và hương vị của bản dựng từ bản dựng khác. |
void | addAllFiles ( BuildInfo build) Phương pháp trợ giúp để sao chép tất cả các tệp từ bản dựng khác. |
boolean | applyBuildProperties ( VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver) Cho phép áp dụng một số |
MultiMap <String, String> | getAttributesMultiMap () |
getVersionedFileMap () | |
MultiMap <String, VersionedFile > | getVersionedFileMapFull () |
Nhà thầu xây dựng công cộng
Thông tin bản dựng
public BuildInfo ()
Tạo BuildInfo
bằng cách sử dụng các giá trị thuộc tính mặc định.
Thông tin bản dựng
public BuildInfo (String buildId, String buildTargetName)
Tạo BuildInfo
Thông số | |
---|---|
buildId | String : id bản dựng |
buildTargetName | String : tên mục tiêu xây dựng |
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 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 void cleanUp ()
Dọn dẹp mọi tập tin xây dựng tạm thời
dọn dẹp
public void cleanUp (doNotClean)
Phiên bản cleanUp()
trong đó một số tệp không bị xóa.
Thông số | |
---|---|
doNotClean |
sao chépAllFileFrom
public final void copyAllFileFrom (BuildInfo build)
Sao chép tất cả VersionedFile
từ một bản dựng nhất định sang bản dựng này.
Thông số | |
---|---|
build | BuildInfo |
bằng
public boolean equals (Object obj)
Thông số | |
---|---|
obj | Object |
Trả lại | |
---|---|
boolean |
từProto
public static IBuildInfo fromProto (BuildInformation.BuildInfo protoBuild)
Thao tác nghịch đảo với toProto()
để lấy lại phiên bản.
Thông số | |
---|---|
protoBuild | BuildInformation.BuildInfo |
Trả lại | |
---|---|
IBuildInfo |
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
publicgetBuildAttributes ()
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 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 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 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 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 String getDeviceSerial ()
Trả lại | |
---|---|
String |
có được file
public 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 |
getProperties
publicgetProperties ()
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 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 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 final 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
public finalgetVersionedFiles (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 |
Mã Băm
public int hashCode ()
Trả lại | |
---|---|
int |
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 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 void setBuildFlavor (String buildFlavor)
Đặt hương vị xây dựng.
setBuildId
public 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 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 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 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 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ộ. |
tớiProto
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 |
toString
public String toString ()
Trả lại | |
---|---|
String |
Phương pháp được bảo vệ
addAllBuildAttribution
protected void addAllBuildAttributes (BuildInfo build)
Phương thức trợ giúp để sao chép các thuộc tính, nhánh và hương vị của bản dựng từ bản dựng khác.
Thông số | |
---|---|
build | BuildInfo |
thêmTất cả các tập tin
protected void addAllFiles (BuildInfo build)
Phương pháp trợ giúp để sao chép tất cả các tệp từ bản dựng khác.
Tạo liên kết cứng mới tới các tệp để mỗi bản dựng sẽ có một đường dẫn tệp duy nhất tới tệp.
Thông số | |
---|---|
build | BuildInfo |
Ném | |
---|---|
| nếu có ngoại lệ được đưa ra khi tạo liên kết cứng. |
áp dụngBuildProperties
protected boolean applyBuildProperties (VersionedFile origFileConsidered, IBuildInfo build, IBuildInfo receiver)
Cho phép áp dụng một số IBuildInfo.BuildInfoProperties
và có thể thực hiện một cách xử lý khác.
Thông số | |
---|---|
origFileConsidered | VersionedFile : Phiên bản hiện đang được xem xét VersionedFile . |
build | IBuildInfo : bản dựng ban đầu đang được sao chép |
receiver | IBuildInfo : bản dựng nhận thông tin. |
Trả lại | |
---|---|
boolean | Đúng nếu chúng ta áp dụng các thuộc tính và việc xử lý tiếp theo sẽ bị bỏ qua. Sai nếu không. |
getAttributMultiMap
protected MultiMap<String, String> getAttributesMultiMap ()
Trả lại | |
---|---|
MultiMap <String, String> |
getVersionedFileMap
protectedgetVersionedFileMap ()
Trả lại | |
---|---|
getVersionedFileMapFull
protected MultiMap<String, VersionedFile> getVersionedFileMapFull ()
Trả lại | |
---|---|
MultiMap <String, VersionedFile > |