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:

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. However individual releases may have a broader compatibility range. The currently supported versions are captured by the following list:

NOTE: gRPC doesn't support bzlmod yet.