mirror of https://github.com/bazelbuild/rules_cc
64 lines
2.2 KiB
Markdown
64 lines
2.2 KiB
Markdown
# C++ rules for Bazel
|
|
|
|
[](https://buildkite.com/bazel/rules-cc)
|
|
|
|
This repository contains Starlark implementation of C++ rules in Bazel.
|
|
|
|
The rules are being incrementally converted from their native implementations in the [Bazel source tree](https://source.bazel.build/bazel/+/master:src/main/java/com/google/devtools/build/lib/rules/cpp/).
|
|
|
|
For the list of C++ rules, see the Bazel
|
|
[documentation](https://docs.bazel.build/versions/master/be/overview.html).
|
|
|
|
# Getting Started
|
|
|
|
There is no need to use rules from this repository just yet. If you want to use
|
|
rules\_cc anyway, add the following to your WORKSPACE file:
|
|
|
|
```
|
|
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
|
|
http_archive(
|
|
name = "rules_cc",
|
|
urls = ["https://github.com/bazelbuild/rules_cc/archive/TODO"],
|
|
sha256 = "TODO",
|
|
)
|
|
```
|
|
|
|
Then, in your BUILD files, import and use the rules:
|
|
|
|
```
|
|
load("@rules_cc//cc:rules.bzl", "cc_library")
|
|
cc_library(
|
|
...
|
|
)
|
|
```
|
|
|
|
# Migration Tools
|
|
|
|
This repository also contains migration tools that can be used to migrate your
|
|
project for Bazel incompatible changes.
|
|
|
|
## Legacy fields migrator
|
|
|
|
Script that migrates legacy crosstool fields into features
|
|
([incompatible flag](https://github.com/bazelbuild/bazel/issues/6861),
|
|
[tracking issue](https://github.com/bazelbuild/bazel/issues/5883)).
|
|
|
|
TLDR:
|
|
|
|
bazel run @rules_cc//tools/migration:legacy_fields_migrator -- \
|
|
--input=my_toolchain/CROSSTOOL \
|
|
--inline
|
|
|
|
# Contributing
|
|
|
|
Bazel and rules_cc are the work of many contributors. We appreciate your help!
|
|
|
|
To contribute, please read the contribution guidelines: [CONTRIBUTING.md](https://github.com/bazelbuild/rules_cc/blob/master/CONTRIBUTING.md).
|
|
|
|
Note that the rules_cc use the GitHub issue tracker for bug reports and feature requests only.
|
|
For asking questions see:
|
|
|
|
* [Stack Overflow](https://stackoverflow.com/questions/tagged/bazel)
|
|
* [rules_cc mailing list](https://groups.google.com/forum/#!forum/cc-bazel-discuss)
|
|
* Slack channel `#cc` on [bazelbuild.slack.com](https://bazelbuild.slack.com) (use [bazel-slackin](https://bazel-slackin.herokuapp.com) to join).
|