cc_común

Argumentos:

name: Es el nombre del componente. Es posible introducir una función sin un cambio en Bazel si agregas una sección "feature" a la cadena de herramientas y la cadena correspondiente como atributo en el archivo BUILD.

enabled: Si se establece como "True", se habilitará 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 la función en cuestión está habilitada, los conjuntos de marcas se aplicarán a las acciones para las que se hayan especificado.

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

requires: Es una lista de conjuntos de atributos que define cuándo la cadena de herramientas admite esta función. La función es compatible si alguno de los conjuntos de atributos se aplica por completo, 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 las demás funciones que se habiliten. Usa esto, por ejemplo, para filtrar marcas según el modo de compilación habilitado (opt / fastbuild / dbg).

implies: Es una lista de strings de funciones o parámetros de configuración de acciones que se habilitan automáticamente cuando se habilita esta función. Si alguna de las funciones implícitas o los parámetros de configuración de acciones no se pueden habilitar, esta función tampoco se habilitará (de forma silenciosa).

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 establece como "True", se habilita esta acción, 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 con un conjunto de atributos que coincida con su configuración. Se mostrará un error si ninguna herramienta coincide con una configuración de función proporcionada; por ese motivo, se recomienda proporcionar una herramienta predeterminada con un conjunto de atributos vacío.

flag_sets: Si se habilita la configuración de 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 acción. Si alguna de las funciones implícitas o la configuración de acciones no se pueden habilitar, esta configuración de acción tampoco se habilitará (de forma silenciosa).

Argumentos:

category_name: Es 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 del destino.

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

Los directorios incluidos para la compilación de C++ están integrados. Estas deben ser las rutas de acceso exactas que usa el compilador y, por lo general, están relacionadas con la raíz de ejecución.

Las rutas que usa el compilador pueden determinarse con "gcc -E -xc++ - -v".

Actualmente, usamos las rutas de acceso de C++ también para la compilación de C, que es segura siempre que no haya conflictos de nombres entre los archivos de encabezados de C++ y C.

Las rutas de acceso relativas se resuelven en relación con el directorio del archivo de configuración.

Si el compilador es compatible con --sysroot, estas rutas de acceso deben usar %sysroot% en lugar de 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.

Es el identificador único de la cadena de herramientas dentro del lanzamiento de la herramienta cruzada. Debe ser posible usarla 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 de cc_toolchain.