Lựa chọn
public abstract @interface Option
implements Annotation
com.android.tradefed.config.Option |
Chú thích một trường đại diện cho tùy chọn IConfiguration
.
Bản tóm tắt
hằng số | |
---|---|
char | NO_SHORT_NAME
|
Phương thức công khai | |
---|---|
String | description () Mô tả thân thiện với người dùng của tùy chọn. |
Option.Importance | importance () Tầm quan trọng của quyền chọn. |
boolean | isTimeVal () Cho dù tùy chọn đại diện cho một giá trị thời gian. |
boolean | mandatory () Cho dù tùy chọn là bắt buộc hay tùy chọn. |
String | name () Tên duy nhất bắt buộc cho tùy chọn này. |
boolean | requiredForRerun () Liệu tùy chọn có cần thiết để biên dịch hướng dẫn chạy lại kiểm tra hay không. |
char | shortName () Tên viết tắt tùy chọn cho tùy chọn. |
OptionUpdateRule | updateRule () Kiểm soát hành vi khi một tùy chọn được chỉ định nhiều lần. |
hằng số
NO_SHORT_NAME
public static final char NO_SHORT_NAME
Giá trị không đổi: 48 (0x00000030)
Phương thức công khai
Sự miêu tả
public String description ()
Mô tả thân thiện với người dùng của tùy chọn.
trả lại | |
---|---|
String |
tầm quan trọng
public Option.Importance importance ()
Tầm quan trọng của quyền chọn.
Một tùy chọn được coi là 'quan trọng' sẽ được hiển thị trong đầu ra trợ giúp viết tắt. Trợ giúp cho một tùy chọn không quan trọng sẽ chỉ được hiển thị trong văn bản trợ giúp đầy đủ.trả lại | |
---|---|
Option.Importance |
isTimeVal
public boolean isTimeVal ()
Cho dù tùy chọn đại diện cho một giá trị thời gian.
Nếu đây là một giá trị thời gian, thì các hậu tố theo thời gian cụ thể sẽ được phân tích cú pháp. Cánh đồnglong
hoặc Long
để cờ này hợp lệ. Nếu không, một ConfigurationException
sẽ được ném ra.
Đơn vị mặc định là mili. Khung cấu hình sẽ chấp nhận s
cho giây (1000 millis), m
cho phút (60 giây), h
cho giờ (60 phút) hoặc d
cho ngày (24 giờ).
Các đơn vị có thể được trộn lẫn và kết hợp, miễn là mỗi đơn vị xuất hiện nhiều nhất một lần và miễn là tất cả các đơn vị xuất hiện được liệt kê theo thứ tự tỷ lệ giảm dần. Vì vậy, chẳng hạn, h
chỉ có thể xuất hiện trước m
và chỉ có thể xuất hiện sau d
. Ví dụ cụ thể, "1d2h3m4s5ms" sẽ là giá trị thời gian hợp lệ, cũng như "4" hoặc "4ms". Tất cả khoảng trắng được nhúng sẽ bị loại bỏ.
trả lại | |
---|---|
boolean |
bắt buộc
public boolean mandatory ()
Cho dù tùy chọn là bắt buộc hay tùy chọn.
Khung cấu hình sẽ đưa ra mộtConfigurationException
nếu một trong hai điều sau đây đúng với trường bắt buộc sau khi các tùy chọn đã được phân tích cú pháp từ tất cả các nguồn:- Trường là
null
. - Trường trống
ERROR(/Collection)
.
trả lại | |
---|---|
boolean |
tên
public String name ()
Tên duy nhất bắt buộc cho tùy chọn này.
Điều này sẽ ánh xạ tới một đối số dòng lệnh có tiền tố là hai ký tự '-'. Ví dụ: mộtOption
có tên 'trợ giúp' sẽ được chỉ định bằng '--help' trên dòng lệnh. Tên không được chứa dấu hai chấm, ví dụ ':'.trả lại | |
---|---|
String |
bắt buộcForRerun
public boolean requiredForRerun ()
Liệu tùy chọn có cần thiết để biên dịch hướng dẫn chạy lại kiểm tra hay không.
Người báo cáo kết quả có thể cố gắng biên dịch hướng dẫn về cách chạy lại xét nghiệm và đưa thông báo vào kết quả. Hướng dẫn sẽ bao gồm tất cả các tùy chọn áp dụng cho chạy lại thử nghiệm. Thuộc tính này được sử dụng để cho biết liệu tùy chọn có được bao gồm trong hướng dẫn đó hay không.
trả lại | |
---|---|
boolean |
tên ngắn
public char shortName ()
Tên viết tắt tùy chọn cho tùy chọn. Điều này sẽ ánh xạ tới một đối số dòng lệnh có tiền tố là một '-'. ví dụ: "-h" trong đó h = shortName. '0' được dành riêng để có nghĩa là tùy chọn không có tên ngắn.
trả lại | |
---|---|
char |
quy tắc cập nhật
public OptionUpdateRule updateRule ()
Kiểm soát hành vi khi một tùy chọn được chỉ định nhiều lần. Lưu ý rằng quy tắc này bị bỏ qua hoàn toàn đối với các tùy chọn là ERROR(/Collection)
s hoặc ERROR(/Map)
s.
trả lại | |
---|---|
OptionUpdateRule |