选项

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)

公共方法

说明

public String description ()

该选项的简单说明。

返回
String

重要程度

public Option.Importance importance ()

该选项的重要程度。

被视为“重要”的选项将显示在缩写帮助输出中。不重要选项的帮助仅会显示在完整帮助文本中。

返回
Option.Importance

isTimeVal

public boolean isTimeVal ()

该选项是否表示时间值。

如果这是一个时间值,系统将解析特定于时间的后缀。此标志的字段 必须longLong,才能有效。否则,系统将抛出 ConfigurationException

默认单位为毫秒。配置框架将接受 s(秒,1000 毫秒)、m(分钟,60 秒)、h(小时,60 分钟)或 d(天,24 小时)。

单位可以混用,但每个单位最多只能出现一次,并且 所有出现的单位都必须按比例递减的顺序列出。因此,例如,h 只能出现在 m 之前,并且只能出现在 d 之后。具体来说, “1d2h3m4s5ms”将是一个有效的时间值,“4”或“4ms”也是如此。所有嵌入的 空格都会被舍弃。

返回
boolean

必填

public boolean mandatory ()

该选项是必填还是可选。

如果从所有来源解析选项后,必填字段满足以下任一条件,配置框架将抛出 ConfigurationException

  • 该字段为 null
  • 该字段为空 Collection

返回
boolean

名称

public String name ()

该选项的必填唯一名称。

这将映射到以两个“-”字符为前缀的命令行实参。 例如,名称为“help”的 Option 将在 命令行中指定为“--help”。

名称不得包含英文冒号 (:)。

返回
String

requiredForRerun

public boolean requiredForRerun ()

是否需要该选项来编译指令以重新运行测试。

结果报告器可能会尝试编译有关如何重新运行测试的指令,并将该 消息包含在结果中。该指令应包含适用于测试 重新运行的所有选项。此属性用于指明是否应将该选项包含在此类 指令中。

返回
boolean

shortName

public char shortName ()

该选项的可选缩写名称。 这将映射到以单个“-”为前缀的命令行实参。 例如,“-h”,其中 h = shortName。 “0”保留用于表示该选项没有 shortName。

返回
char

updateRule

public OptionUpdateRule updateRule ()

控制多次指定选项时的行为。 请注意,对于 CollectionMap 类型的选项,此规则将被 完全忽略。

返回
OptionUpdateRule