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