cc_común

Contiene todas las especificaciones de marcas para un componente.

Argumentos:

name: Muestra el nombre del elemento. Es posible introducir una función sin un cambio en Bazel agregando una sección 'feature' a la cadena de herramientas y agregando la cadena correspondiente como atributo en el archivo BUILD.

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

flag_sets: una lista de FlagSet: si la función determinada está habilitada, los conjuntos de marcas se aplicarán para las acciones que se especifiquen.

env_sets: Una lista EnvSet: Si se habilita la función determinada, se aplicarán los conjuntos de entorno a las acciones para las que se hayan especificado.

requiere: Una lista de conjuntos de atributos que definen 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 la opción "require", la función se admite independientemente de las demás funciones que estén habilitadas. Usa esto, por 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 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).

proporciona: Una lista de nombres con los que este elemento entra en conflicto.

Una configuración de acción corresponde a una acción de Bazel y permite seleccionar una herramienta según las funciones activadas. La activación de la configuración de acciones ocurre según la misma semántica que las funciones: una función puede "requerir" o "implicar" una configuración de acción de la misma manera que lo haría con otra función.

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".

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

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

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 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).

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

Argumentos:

category_name: Indica 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.

Extensión: 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]*

Ubicaciones de las herramientas.

Argumentos:

name: Nombre de la herramienta.

path: Indica 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 relativa al paquete de cc_toolchain.