オプション

public abstract @interface Option
implements Annotation

com.android.tradefed.config.Option


IConfiguration オプションを表すフィールドにアノテーションを付けます。

概要

定数

char NO_SHORT_NAME

パブリック メソッド

String description()

オプションのわかりやすい説明。

Option.Importance importance()

オプションの重要度。

boolean isTimeVal()

オプションが時間値を表すかどうか。

boolean mandatory()

オプションが必須か任意か。

String name()

このオプションに必須の一意の名前。

boolean requiredForRerun()

テストを再実行する命令をコンパイルするためにオプションが必要かどうか。

char shortName()

オプションの略称(省略可)。

OptionUpdateRule updateRule()

オプションが複数回指定された場合の動作を制御します。

定数

NO_SHORT_NAME

public static final char NO_SHORT_NAME

定数値: 48 (0x00000030)

パブリック メソッド

description

public String description ()

オプションのわかりやすい説明。

戻り値
String

重要度

public Option.Importance importance ()

オプションの重要性。

「重要」とみなされるオプションは、省略されたヘルプ出力に表示されます。重要でないオプションのヘルプは、完全なヘルプテキストにのみ表示されます。

戻り値
Option.Importance

isTimeVal

public boolean isTimeVal ()

オプションが時間値を表すかどうか。

時刻値の場合は、時刻固有の接尾辞が解析されます。このフラグが有効になるには、フィールドが long または Long である必要があります。そうでない場合は、ConfigurationException がスローされます。

デフォルトの単位はミリ秒です。構成フレームワークは、s を秒(1,000 ミリ秒)、m を分(60 秒)、h を時間(60 分)、d を日(24 時間)に使用します。

各ユニットが最大 1 回表示され、表示されるすべてのユニットがスケールの降順で並べられている限り、ユニットを組み合わせて使用できます。たとえば、hm の前にのみ、または d の後にのみ表示できます。具体的な例として、「1d2h3m4s5ms」は有効な時間値です。また、「4」や「4ms」も有効です。埋め込まれた空白はすべて破棄されます。

戻り値
boolean

必須

public boolean mandatory ()

オプションが必須か省略可能か。

すべてのソースからオプションが解析された後、必須フィールドに次のいずれかが当てはまる場合、構成フレームワークは ConfigurationException をスローします。

戻り値
boolean

name

public String name ()

このオプションに必須の一意の名前。

これは、2 つの「-」文字が接頭辞として付いたコマンドライン引数にマッピングされます。たとえば、Option の名前が「help」の場合は、コマンドラインで「--help」を指定します。

名前にコロンを指定することはできません(例: ':')。

戻り値
String

requiredForRerun

public boolean requiredForRerun ()

テストを再実行する命令をコンパイルするためにオプションが必要かどうか。

結果レポーターは、テストの再実行方法に関する命令をコンパイルし、結果を結果に含めることがあります。手順には、テストの再実行に適用されるすべてのオプションを含める必要があります。この属性は、そのような命令にオプションを含めるかどうかを示すために使用されます。

戻り値
boolean

shortName

public char shortName ()

オプションの省略名(省略可)。これは、1 つの「-」で始まるコマンドライン引数にマッピングされます。 例: 「-h」で、h は shortName です。 「0」は、オプションに shortName がないことを意味する予約済み値です。

戻り値
char

updateRule

public OptionUpdateRule updateRule ()

オプションが複数回指定された場合の動作を制御します。なお、このルールは、ERROR(/Collection) または ERROR(/Map) であるオプションでは完全に無視されます。

戻り値
OptionUpdateRule