Support the new(ish) `@//tools/cpp:cc_runtimes_toolchain_type` toolchain for adding runtimes-on-demand.
* Add `get_cc_runtimes` and `get_cc_runtimes_copts` implementations to `cc_helper[_internal]`.
* TODO update usage in `rules_python` and others to call `cc_helper` and deprecate `semantics.get_cc_runtimes*`
Basic Usage:
Define a provider like:
```
CcRuntimesInfo = provider(
doc = "Information about runtime libraries to link into c++ targets.",
fields = ["runtimes", "copts"],
)
```
Define a toolchain that returns that provider:
```
def _cc_runtimes_toolchain_impl(ctx):
return [platform_common.ToolchainInfo(
cc_runtimes_info = CcRuntimesInfo(
runtimes = ctx.attr.runtimes,
copts = ctx.attr.copts,
),
)]
```
* `runtimes` is a collection of CcInfo providing targets
* `copts` provides compilation flags that must be used alongside this toolchain, e.g. to influence include ordering.
This may be used, e.g. in rules_android_ndk: https://github.com/bazelbuild/rules_android_ndk/issues/93
PiperOrigin-RevId: 941244580
Change-Id: I31bade595714dbe44aa0d70afaa97ddd788e5635
This repository contains C, C++, and Objective-C language support for the Bazel build system.
For this module's main reference, see the Bazel documentation.
Follow the official instructions to Install Bazel.
Add the latest release to your MODULE.bazel project file.
In a BUILD.bazel file, import and use the rules:
load("@rules_cc//cc:cc_binary.bzl", "cc_binary") cc_binary( name = "hello_world", srcs = ["hello_world.cc"], )
Build and run your C/C++ binary with one command:
$ bazel run hello_world
To build the project without running the binary, use Bazel's build subcommand:
$ bazel build hello_world
rules_cc includes an auto-configured toolchain that uses the local compiler installed on the host machine.
You can disable the autoconfigured C/C++ toolchain by adding the following Bazel flag to your project's .bazelrc file:
--repo_env=BAZEL_DO_NOT_DETECT_CPP_TOOLCHAIN=1
Configuring a hermetic toolchain makes your build more deterministic. rules_cc itself does not yet offer a hermetic toolchain distribution. Other community owned and maintained projects offer hermetic C/C++ toolchains:
Bazel and rules_cc are the work of many contributors. We appreciate your help!
To contribute, please read the contribution guidelines: CONTRIBUTING.md.
Note that the rules_cc use the GitHub issue tracker for bug reports and feature requests only. For asking questions see:
rules_cc mailing list#cc on slack.bazel.build