Integración con reglas de C++

Informar un problemaopen_in_new Ver código fuenteopen_in_new Nocturno · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

En esta página, se describe cómo realizar la integración con reglas de C++ en varios niveles.

Cómo acceder a la cadena de herramientas de C++

Debes usar las funciones auxiliares disponibles en @rules_cc//cc:find_cc_toolchain.bzl para depender de una cadena de herramientas de C/C++ desde una regla de Starlark.

Para depender de una cadena de herramientas de C++ en tu regla, configura el parámetro toolchains como use_cc_toolchain(). Luego, en la implementación de la regla, usa find_cpp_toolchain(ctx) para obtener el CcToolchainInfo. Puedes encontrar un ejemplo completo que funciona en los ejemplos de rules_cc.

Cómo generar líneas de comandos y variables de entorno con la cadena de herramientas de C++

Por lo general, te integrarías con la cadena de herramientas de C++ para tener las mismas marcas de línea de comandos que las reglas de C++, pero sin usar acciones de C++ directamente. Esto se debe a que, cuando escribimos nuestras propias acciones, deben comportarse de manera coherente con la cadena de herramientas de C++; por ejemplo, pasar marcas de línea de comandos de C++ a una herramienta que invoca el compilador de C++ en segundo plano.

Las reglas de C++ usan una forma especial de construir líneas de comandos basadas en la configuración de funciones. Para construir una línea de comandos, necesitas lo siguiente:

• features y action_configs: Provienen de CcToolchainConfigInfo y se encapsulan en CcToolchainInfo.
• FeatureConfiguration: Es el valor que devuelve cc_common.configure_features.
• Variables de configuración de la cadena de herramientas de cc, que devuelve cc_common.create_compile_variables o cc_common.create_link_variables.

Aún existen métodos get específicos de la herramienta, como compiler_executable. Prefiere get_tool_for_action en lugar de estos, ya que los métodos get específicos de la herramienta se quitarán con el tiempo.

Puedes encontrar un ejemplo completo y funcional en los ejemplos de rules_cc.

Implementar reglas de Starlark que dependen de reglas de C++ o de las que pueden depender las reglas de C++

La mayoría de las reglas de C++ proporcionan CcInfo, un proveedor que contiene CompilationContext y LinkingContext. A través de ellos, es posible acceder a información como todos los encabezados transitivos o las bibliotecas para vincular. Desde CcInfo y desde las reglas personalizadas de Starlark, se debería poder obtener toda la información necesaria.CcToolchainInfo

Si una regla personalizada de Starlark proporciona CcInfo, es un indicador para las reglas de C++ de que también pueden depender de ella. Sin embargo, ten cuidado: si solo necesitas propagar CcInfo a través del gráfico hasta la regla binaria que luego lo usa, envuelve CcInfo en un proveedor diferente. Por ejemplo, si la regla java_library quisiera propagar dependencias nativas hasta java_binary, no debería proporcionar CcInfo directamente (cc_binary que depende de java_library no tiene sentido), sino que debería incluirlo, por ejemplo, en JavaCcInfo.

Puedes encontrar un ejemplo completo y funcional en los ejemplos de rules_cc.

Cómo reutilizar la lógica y las acciones de las reglas de C++

Aún no es estable. Esta sección se actualizará cuando la API sea estable. Sigue el problema#4570 para obtener información actualizada.