Opción
public abstract @interface Option
implements Annotation
com.android.tradefed.config.Opción |
Anota un campo como si representara una opción IConfiguration
.
Resumen
Constantes | |
---|---|
char | NO_SHORT_NAME
|
Métodos públicos | |
---|---|
String | description () Descripción fácil de usar de la opción. |
Option.Importance | importance () La importancia de la opción. |
boolean | isTimeVal () Si la opción representa un valor de tiempo. |
boolean | mandatory () Si la opción es obligatoria u opcional. |
String | name () El nombre único obligatorio para esta opción. |
boolean | requiredForRerun () Si se necesita la opción para compilar instrucciones para volver a ejecutar una prueba. |
char | shortName () Nombre abreviado opcional para la opción. |
OptionUpdateRule | updateRule () Controla el comportamiento cuando se especifica una opción varias veces. |
Constantes
NO_SHORT_NAME
public static final char NO_SHORT_NAME
Valor constante: 48 (0x00000030)
Métodos públicos
descripción
public String description ()
Descripción fácil de usar de la opción.
Devoluciones | |
---|---|
String |
importancia
public Option.Importance importance ()
La importancia de la opción.
Una opción considerada "importante" se mostrará en el resultado de ayuda abreviado. La ayuda para una opción sin importancia solo se mostrará en el texto de ayuda completo.Devoluciones | |
---|---|
Option.Importance |
esTimeVal
public boolean isTimeVal ()
Si la opción representa un valor de tiempo.
Si se trata de un valor de tiempo, se analizarán los sufijos específicos de tiempo. El campolong
o Long
para que esta bandera sea válida. De lo contrario, se generará una ConfigurationException
.
La unidad predeterminada es milisegundos. El marco de configuración aceptará s
para segundos (1000 milisegundos), m
para minutos (60 segundos), h
para horas (60 minutos) o d
para días (24 horas).
Las unidades se pueden mezclar y combinar, siempre y cuando cada unidad aparezca como máximo una vez, y siempre que todas las unidades que aparezcan se enumeren en orden de escala decreciente. Entonces, por ejemplo, h
solo puede aparecer antes m
y solo puede aparecer después de d
. Como ejemplo específico, "1d2h3m4s5ms" sería un valor de tiempo válido, al igual que "4" o "4ms". Todos los espacios en blanco incrustados se descartan.
Devoluciones | |
---|---|
boolean |
obligatorio
public boolean mandatory ()
Si la opción es obligatoria u opcional.
El marco de configuración generará unaConfigurationException
si se cumple alguna de las siguientes condiciones en un campo obligatorio después de que se hayan analizado las opciones de todas las fuentes:- El campo es
null
. - El campo es un
ERROR(/Collection)
vacío.
Devoluciones | |
---|---|
boolean |
nombre
public String name ()
El nombre único obligatorio para esta opción.
Esto se asignará a un argumento de línea de comando con el prefijo dos caracteres '-'. Por ejemplo, unaOption
con el nombre 'ayuda' se especificaría con '--help' en la línea de comando. Los nombres no pueden contener dos puntos, por ejemplo, ':'.Devoluciones | |
---|---|
String |
requerido para volver a ejecutar
public boolean requiredForRerun ()
Si se necesita la opción para compilar instrucciones para volver a ejecutar una prueba.
El reportero de resultados puede intentar compilar instrucciones sobre cómo volver a ejecutar una prueba e incluir el mensaje en el resultado. La instrucción incluirá todas las opciones aplicables a la repetición de una prueba. Este atributo se utiliza para indicar si la opción se incluirá en dicha instrucción.
Devoluciones | |
---|---|
boolean |
nombre corto
public char shortName ()
Nombre abreviado opcional para la opción. Esto se asignará a un argumento de línea de comando con el prefijo '-'. por ejemplo, "-h" donde h = nombre corto. '0' está reservado para indicar que la opción no tiene un nombre corto.
Devoluciones | |
---|---|
char |
actualizarRegla
public OptionUpdateRule updateRule ()
Controla el comportamiento cuando se especifica una opción varias veces. Tenga en cuenta que esta regla se ignora por completo para las opciones que son ERROR(/Collection)
s o ERROR(/Map)
s.
Devoluciones | |
---|---|
OptionUpdateRule |