mirror of https://github.com/grpc/grpc.git
The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)
https://grpc.io/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
49 lines
1.7 KiB
49 lines
1.7 KiB
# Bazel Support |
|
|
|
## Basic Usage |
|
|
|
The `grpc/grpc` repository's primary build system is Bazel. Rules are provided |
|
for C++, Python, and Objective-C. While C++ supports other build systems such as |
|
CMake, these rules are actually generated from the Bazel definitions. |
|
|
|
Projects built with Bazel may use the `grpc/grpc` repo not only to add a |
|
dependency on the library itself, but also to generate protobuf, stub, and |
|
servicer code. To do so, one must invoke the `grpc_deps` and `grpc_extra_deps` |
|
repository rules in their `WORKSPACE` file: |
|
|
|
```starlark |
|
workspace(name = "example_workspace") |
|
|
|
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive") |
|
|
|
http_archive( |
|
name = "com_github_grpc_grpc", |
|
strip_prefix = "grpc-1.45.0", |
|
sha256 = "ec19657a677d49af59aa806ec299c070c882986c9fcc022b1c22c2a3caf01bcd", |
|
urls = ["https://github.com/grpc/grpc/archive/refs/tags/v1.45.0.tar.gz"], |
|
) |
|
|
|
load("@com_github_grpc_grpc//bazel:grpc_deps.bzl", "grpc_deps") |
|
|
|
grpc_deps() |
|
|
|
load("@com_github_grpc_grpc//bazel:grpc_extra_deps.bzl", "grpc_extra_deps") |
|
|
|
grpc_extra_deps() |
|
``` |
|
|
|
## Supported Versions |
|
|
|
gRPC supports building with the latest stable release of Bazel, |
|
as well as the previous major version release for at least 6 months |
|
after it transitions into maintenance mode. |
|
This is consistent with the supported build systems of |
|
[the Google Foundational C++ Support Policy](https://opensource.google/documentation/policies/cplusplus-support). |
|
However individual releases may have a broader |
|
compatibility range. The currently supported versions are captured by the |
|
following list: |
|
|
|
- [`6.5.0`](https://github.com/bazelbuild/bazel/releases/tag/6.5.0) |
|
- [`7.1.0`](https://github.com/bazelbuild/bazel/releases/tag/7.1.0) |
|
|
|
NOTE: gRPC doesn't support bzlmod yet. |