Este es un módulo de nivel superior para crear transiciones de configuración y compilar descriptores de configuración que describen qué tipo de configuración de compilación (si hay) es una regla.
P. ej., la siguiente regla se marca como una configuración de compilación mediante la configuración del parámetro build_setting
de la función rule()
. Específicamente, es una configuración de compilación de tipo int
y es un flag
, lo que significa que se puede llamar a esta configuración de compilación desde la línea de comandos.
my_rule = rule( implementation = _impl, build_setting = config.int(flag = True), ... )
Miembros
bool
BuildSetting config.bool(flag=False)Una configuración de compilación de tipo booleano
Parámetros
Parámetro | Descripción |
---|---|
flag
|
el valor predeterminado es False Indica si se puede llamar o no a esta configuración de compilación en la línea de comandos. |
exec
ExecTransitionFactory config.exec(exec_group=None)Crea una transición de ejecución.
Parámetros
Parámetro | Descripción |
---|---|
exec_group
|
cadena o None ;
el valor predeterminado es None Es el nombre del grupo de ejecución cuya plataforma de ejecución usará esta transición. Si no se proporciona, esta transición de ejecución usará la plataforma de ejecución predeterminada del destino. |
int
BuildSetting config.int(flag=False)Un parámetro de configuración de compilación de tipo número entero
Parámetros
Parámetro | Descripción |
---|---|
flag
|
el valor predeterminado es False Indica si se puede llamar o no a esta configuración de compilación en la línea de comandos. |
string
BuildSetting config.string(flag=False, allow_multiple=False)Es un parámetro de configuración de compilación de tipo de cadena.
Parámetros
Parámetro | Descripción |
---|---|
flag
|
El valor predeterminado es False Indica si se puede llamar a este parámetro de configuración de compilación en la línea de comandos. |
allow_multiple
|
el valor predeterminado es False Este campo es obsoleto; utiliza una configuración string_list con repeatable = True en su lugar. Si se establece, esta marca se puede establecer varias veces en la línea de comandos. El valor de la marca al que se accede en las transiciones y la función de implementación de parámetros de configuración de compilación será una lista de cadenas. El pedido de inserción y los valores repetidos se mantienen. Esta lista se puede procesar posteriormente en la función de implementación de la configuración de compilación si se desea un comportamiento diferente.
|
string_list
BuildSetting config.string_list(flag=False, repeatable=False)Es un parámetro de configuración de compilación de tipo lista de cadenas. En la línea de comandos, pasa una lista con un valor separado por comas, como
--//my/setting=foo,bar
.
Parámetros
Parámetro | Descripción |
---|---|
flag
|
El valor predeterminado es False Indica si se puede llamar a este parámetro de configuración de compilación en la línea de comandos. |
repeatable
|
el valor predeterminado es False Si está configurada, en lugar de esperar un valor separado por comas, esta marca se puede configurar varias veces en la línea de comandos, con cada valor individual tratado como una sola cadena para agregar al valor de la lista. El pedido de inserción y los valores repetidos se mantienen. Esta lista se puede procesar posteriormente en la función de implementación de la configuración de compilación si se desea un comportamiento diferente. |