安装工具
在 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 安装。
检查 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 全局安装后非常难以全面卸载。
更多信息:
- 你可以在 gRPC C++ 源代码构建页面获得更完整的操作指令。
- 添加 gRPC 作为 C++ 项目的通用操作指令可查看开始使用 gRPC C++。
Loading...
> 此处输出代码运行结果