» gRPC快速入门:C++ » 2. 准备工作 » 2.1 安装工具

安装工具

在 C++ 生态里,没有统一接受的项目依赖管理标准。你需要在构建执行你的应用之前先构建、安装 gRPC。

构建并本地安装 gRPC 和 Protocol Buffers

下面步骤介绍如何使用 cmake 进行构建和本地安装 gRPC 和 Protocol Buffers。如果你倾向于使用 bazel,查看官方仓库的源码构建方案

设置

选择一个目录来承载本地安装的包。本篇假定环境变量 LR_INSTALL_DIR 被赋予了目录路径。比如:

export LR_INSTALL_DIR=$HOME/.local

确保目录存在:

mkdir -p $LR_INSTALL_DIR

添加 bin 子目录到你的 PATH 环境变量,比如:

export PATH="$LR_INSTALL_DIR/bin:$PATH"

安装 cmake

你需要 3.13 版本或更高的 cmake。使用以下命令安装:

  • Linux
sudo apt install -y cmake
  • macOS
brew install cmake

检查 cmake 版本:

cmake --version

Linux 下系统自动的 cmake 版本一般比较旧。你可以使用如下命令安装一个比较新的版本到你的本地安装目录中:

wget -q -O cmake-linux.sh https://github.com/Kitware/CMake/releases/download/v3.19.6/cmake-3.19.6-Linux-x86_64.sh
sh cmake-linux.sh -- --skip-license --prefix=$LR_INSTALL_DIR
rm cmake-linux.sh

安装其他必需工具

安装构建 gRPC 所需的基础攻击:

  • Linux
sudo apt install -y build-essential autoconf libtool pkg-config
  • macOS
brew install autoconf automake libtool pkg-config

克隆 grpc 仓库

克隆 grpc 仓库及其子模块:

git clone --recurse-submodules -b v1.62.0 --depth 1 --shallow-submodules https://github.com/grpc/grpc

构建安装 gRPC 和 Protocol Buffers

虽然并非强制,但 gRPC 应用一般使用 Protocol Buffers 进行服务定义和数据序列化。本篇样例代码使用 proto3

以下命令可以构建并本地安装 gRPC 和 Protocol Buffers:

cd grpc
mkdir -p cmake/build
pushd cmake/build
cmake -DgRPC_INSTALL=ON \
      -DgRPC_BUILD_TESTS=OFF \
      -DCMAKE_INSTALL_PREFIX=$LR_INSTALL_DIR \
      ../..
make -j 4
make install
popd

⚠️警告
强烈建议本地安装 gRPC(通过设置合适的 CMAKE_INSTALL_PREFIX),因为 gRPC 全局安装后非常难以全面卸载。

更多信息: