cc_común

Contiene todas las especificaciones de marcas de una función.

Argumentos:

name: El nombre del elemento. Es posible incorporar una función sin cambiar a Bazel agregando una “función” a la cadena de herramientas y agrega la cadena correspondiente como función en el archivo BUILD.

enabled: Si se establece en "True", esta función se habilitará, a menos que un tipo de regla la marque explícitamente como no compatible.

flag_sets: Una lista FlagSet: Si se habilita la función en cuestión, los conjuntos de marcas se aplicarán a las acciones para las que se especifiquen.

Env_sets: Una lista de EnvSet. Si el componente en cuestión está habilitado, los conjuntos de entornos se aplicarán a las acciones para las que se especifiquen.

requiere: Una lista de conjuntos de atributos que definen cuándo la función es compatible con la cadena de herramientas. La función es compatible si se aplica por completo alguno de los conjuntos de atributos, es decir, cuando todas las funciones de un conjunto de atributos están habilitadas. Si es obligatorio se omite, la función se admite independientemente de qué otras funciones estén habilitadas. Úsalo como ejemplo para filtrar marcas según el modo de compilación habilitado (opt / fastbuild / dbg).

implica: Una lista de cadenas de funciones o parámetros de configuración de acciones que se habilitan automáticamente cuando esta función está habilitada. Si no se puede habilitar alguna de las funciones o configuraciones de acciones implícitas, esta función tampoco se habilitará (en silencio).

proporciona: Una lista de los nombres con los que esta función entra en conflicto.

Una configuración de acciones corresponde a una acción de Bazel y permite la selección de una herramienta según las funciones activadas. La activación de la configuración de acciones ocurre con la misma semántica que los atributos: una función puede ser “requerida”. o "implícita" para configurar una acción del mismo modo que con otro atributo.

Argumentos:

action_name: Es el nombre de la acción de Bazel a la que se aplica esta configuración, p.ej., "c-compile" o "c-module-compile".

enabled: Si se establece en "True", esta acción se habilita, a menos que un tipo de regla la marque explícitamente como no compatible.

tools: La herramienta que se aplique a la acción será la primera que tenga un conjunto de atributos que coincida con la configuración de funciones. Se mostrará un error si ninguna herramienta coincide con una configuración de atributos proporcionada. Por ese motivo, es una buena idea proporcionar una herramienta predeterminada con un conjunto de atributos vacío.

flag_sets: Si se habilita la configuración de la acción determinada, los conjuntos de marcas se aplicarán a la acción correspondiente.

implica: Una lista de funciones o parámetros de configuración de acciones que se habilitan automáticamente cuando se habilita esta configuración de acciones. Si no se puede habilitar alguna de las funciones o configuraciones de acciones implícitas, esta configuración de acciones tampoco se habilitará (en silencio).

Es el nombre de un artefacto de una categoría determinada de artefactos de entrada o salida para una acción.

Argumentos:

category_name: La categoría de artefactos a los que se aplica esta selección. Este campo se compara con una lista de categorías definidas en Bazel. Las categorías de ejemplo incluyen "linked_output" o el artefacto de esta selección. Junto con la extensión, se usa para crear un nombre de artefacto basado en el nombre de destino.

extensión: Es la extensión para crear el artefacto para esta selección. Junto con el prefijo, se usa para crear un nombre de artefacto basado en el nombre de destino.

Directorios de inclusión integrados para la compilación de C++. Estas deben ser las rutas de acceso exactas que usa el compilador y, en general, son relativas a la raíz de ejecución.

Las rutas de acceso usadas por el compilador pueden determinarse con "gcc -E -xc++ - -v".

Actualmente, usamos las rutas de acceso de C++ también para la compilación en C, lo cual es seguro siempre y cuando no haya conflictos de nombres entre los archivos de encabezado C++ y C.

Las rutas de acceso relativas se resuelven según el directorio del archivo de configuración.

Si el compilador es compatible con --sysroot, estas rutas de acceso deben usar %sysroot% en lugar de incluir la ruta de acceso de inclusión y especificar el atributo sysroot a fin de proporcionar a blaze la información necesaria para realizar los reemplazos correctos.

El identificador único de la cadena de herramientas dentro del lanzamiento de la herramienta cruzada. Debe ser posible usarlo como nombre de directorio en una ruta de acceso.

Debe coincidir con la siguiente regex: [a-zA-Z_][\.\- \w]*

Ubicaciones de las herramientas

Argumentos:

name: Nombre de la herramienta.

path: Es la ubicación de la herramienta. Puede ser una ruta de acceso absoluta (en el caso de una cadena de herramientas no hermética) o una ruta de acceso relativa al paquete cc_toolchain.