cc_común

Argumentos:

name: Es el nombre del componente. 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 configura como "True", se habilita esta función, a menos que un tipo de regla la marque explícitamente como no compatible.

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

env_sets: Es una lista de EnvSet. Si se habilita la función en cuestión, los conjuntos de entornos se aplicarán a las acciones para las que se especifiquen.

requires: Es una lista de conjuntos de atributos que definen cuándo la cadena de herramientas admite esta función. 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 se omite requires, la función se admite independientemente de cuáles otras funciones estén habilitadas. Úsalo como ejemplo para filtrar marcas según el modo de compilación habilitado (opt / fastbuild / dbg).

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

provides: Es una lista de nombres con los que esta función entra en conflicto.

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 configura como "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 atributos. 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.

implies: Es 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).

Argumentos:

category_name: Es la categoría de artefactos a la 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.

extension: 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]*

Argumentos:

name: Es el nombre de la herramienta.

path: 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.