在Ubuntu20.04环境下安装GRPC

由于工作项目中涉及GRPC&＃xff0c;因此需要安装GRPC和PROTOC以及编译proto文件。特此记录自己安装与编译的整个过程和注意点。

这一部分对安装GRPC没有特别的影响&＃xff0c;如果自己的虚拟机存在这些使用不便的问题并且想解决&＃xff0c;可以看看&＃xff0c;如果不需要的话跳过这一部分就好了。

1、实现全屏显示及与windows之间的文件拖放

命令如下&＃xff1a;

更新package&＃xff1a;
sudo apt update
安装open-vm-tools-desktop&＃xff0c;主要实现主机与虚拟机之间的复制粘贴包括文件拖放&＃xff1a;
sudo apt-get install open-vm-tools-desktop
重启&＃xff1a;
sudo reboot
安装成功后即可全屏显示与拖放文件


2、解决使用vi/vim编辑文件时方向键、退格键使用异常的问题

命令如下&＃xff1a;

ubuntu预装的是vim tiny版本&＃xff0c;而需要的是vim full版本。执行下面的语句安装vim full版本&＃xff1a;
删除组件包vim-common&＃xff1a;
sudo apt-get remove vim-common
安装文本编辑器&＃xff1a;
sudo apt-get install vim


GRPC可以完成跨语言之间的通信&＃xff0c;它是一种协议。我们可以通过在proto文件中定义数据结构和接口函数来实现数据传输。

1、使用cmake --version先查看camke版本

在我第一次安装GRPC时&＃xff0c;根据官方教程安装了推荐版本的cmake&＃xff0c;但后续不知道什么原因导致没有成功安装GRPC。通过实践&＃xff0c;我发现也许需要3.22.3及更高版本的cmake&＃xff0c;所以为了保险起见&＃xff0c;还是安装3.22.3版本的cmake。

可进入https://github.com/Kitware/CMake/releases自行下载&＃xff0c;我选择的是 cmake-3.22.3-linux-x86_64.sh
放入虚拟机后更名为cmake-linux.sh(右键更改文件名)
运行cmake-linux.sh文件&＃xff0c;通过脚本在本地目录安装更新的cmake版本&＃xff0c;--skip-license安装时不会要求用户进行许可协议确认&＃xff0c;--prefix&＃61;$MY_INSTALL_DIR 配置安装的路径&＃xff1a;
sudo sh cmake-linux.sh -- --skip-license --prefix&＃61;$MY_INSTALL_DIR
查看cmake是否安装成功&＃xff1a;cmake --version


2、安装构建grpc所需的基本工具

安装build-essential、autoconf 、libtool 、pkg-config&＃xff1a;
##build-essential作用是提供编译程序必须软件包的列表信息&＃xff0c;这样编译程序才知道头文件和库函数在哪&＃xff0c;才会下载依赖的软件包
##autoconf是一种生成shell脚本的工具&＃xff0c;可以自动配置软件源代码包
##libtool是自动生成并调用动态库的工具&＃xff0c;包装了gcc或者其他编译器
##pkg-config提供功能&＃xff1a;检查库的版本号&＃xff1b;获得编译预处理参数&＃xff0c;如宏定义、头文件的位置&＃xff1b; 获得链接参数&＃xff0c;如库及依赖的其他库的位置&＃xff0c;文件名及其他一些链接参数&＃xff1b;自动加入所依赖的其他库的设置。

命令如下&＃xff1a;

更新package&＃xff1a;
sudo apt update
安装所需库&＃xff1a;
sudo apt-get install build-essential autoconf libtool pkg-config


3、克隆grpc存储库

命令如下&＃xff1a;

安装git&＃xff1a;
sudo apt install git
克隆存储库&＃xff1a;
git clone -b v1.28.x https://gitee.com/slrom/grpc


4、下载grpc子模块的代码

这里需要注意的是&＃xff0c;由于github访问不稳定&＃xff0c;所以我们可以修改 grpc目录下的.gitmodules文件中各子模块的地址&＃xff0c;便于更好下载子模块的代码。

.gitmodules文件这样修改&＃xff1a;

[submodule "third_party/zlib"]
path &＃61; third_party/zlib
url &＃61; https://gitee.com/slrom/zlib.git
# When using CMake to build, the zlib submodule ends up with a
# generated file that makes Git consider the submodule dirty. This
# state can be ignored for day-to-day development on gRPC.
ignore &＃61; dirty
[submodule "third_party/protobuf"]
path &＃61; third_party/protobuf
url &＃61; https://gitee.com/slrom/protobuf.git
branch &＃61; 3.0.x
[submodule "third_party/gflags"]
path &＃61; third_party/gflags
url &＃61; https://gitee.com/slrom/gflags.git
[submodule "third_party/googletest"]
path &＃61; third_party/googletest
url &＃61; https://gitee.com/slrom/googletest.git
[submodule "third_party/benchmark"]
path &＃61; third_party/benchmark
url &＃61; https://gitee.com/slrom/benchmark.git
[submodule "third_party/boringssl-with-bazel"]
path &＃61; third_party/boringssl-with-bazel
url &＃61; https://gitee.com/slrom/boringssl.git
[submodule "third_party/boringssl"]
path &＃61; third_party/boringssl
url &＃61; https://gitee.com/slrom/boringssl.git
[submodule "third_party/cares/cares"]
path &＃61; third_party/cares/cares
url &＃61; https://gitee.com/slrom/c-ares.git
branch &＃61; cares-1_12_0
[submodule "third_party/bloaty"]
path &＃61; third_party/bloaty
url &＃61; https://gitee.com/slrom/bloaty.git
[submodule "third_party/abseil-cpp"]
path &＃61; third_party/abseil-cpp
url &＃61; https://gitee.com/slrom/abseil-cpp.git
branch &＃61; lts_2020_02_25
[submodule "third_party/envoy-api"]
path &＃61; third_party/envoy-api
url &＃61; https://gitee.com/slrom/data-plane-api.git
[submodule "third_party/googleapis"]
path &＃61; third_party/googleapis
url &＃61; https://gitee.com/slrom/googleapis.git
[submodule "third_party/protoc-gen-validate"]
path &＃61; third_party/protoc-gen-validate
url &＃61; https://gitee.com/slrom/protoc-gen-validate.git
[submodule "third_party/udpa"]
path &＃61; third_party/udpa
url &＃61; https://gitee.com/slrom/udpa.git
[submodule "third_party/libuv"]
path &＃61; third_party/libuv
url &＃61; https://gitee.com/slrom/libuv.git
[submodule "third_party/libcxx"]
path &＃61; third_party/libcxx
url &＃61; https://gitee.com/slrom/libcxx.git
[submodule "third_party/libcxxabi"]
path &＃61; third_party/libcxxabi
url &＃61; https://gitee.com/slrom/libcxxabi.git


完成文件修改后&＃xff0c;命令如下&＃xff1a;

下载子模块的代码
到达grpc目录下&＃xff1a;
cd grpc
根据.gitmodules文件中的路径访问相应子模块并下载&＃xff1a;
git submodule update --init


5、构建和安装grpc和protocol buffers

命令如下&＃xff1a;

到达grpc目录下&＃xff1a;
cd grpc
若该文件夹不存在则创建文件夹&＃xff1a;
mkdir -p cmake/build
到达cmake/build目录下&＃xff1a;
cd cmake/build
编译构建依赖库&＃xff0c;通过cmake安装grpc&＃xff0c;设置-DgRPC_INSTALL&＃61;ON&＃xff0c;-DgRPC_BUILD_TESTS&＃61;OFF&＃xff1b;构建安装路径&＃xff0c;通过CMAKE_INSTALL_PREFIX变量指定&＃xff1b;想要编译动态库.so文件&＃xff0c;设置-DBUILD_SHARED_LIBS&＃61;ON&＃xff1a;
cmake -DgRPC_INSTALL&＃61;ON \
-DgRPC_BUILD_TESTS&＃61;OFF \
-DCMAKE_INSTALL_PREFIX&＃61;/usr/ \
-DBUILD_SHARED_LIBS&＃61;ON \
../..
编译&＃xff1a;
make -j16
安装&＃xff1a;
sudo make install

三、测试

按照以上步骤&＃xff0c;安装就基本完成了&＃xff0c;但还是添加一步简单的测试验证下是否安装成功&＃xff0c;如需要使用不是GRPC中自带的例子完成测试的话&＃xff0c;可以去看看GRPC的官方教程。
命令如下&＃xff1a;

cd grpc/examples/cpp/helloworld
mkdir -p cmake/build
cd cmake/build
cmake ../..
make -j16


ls
./greeter_server


新开终端
cd grpc/examples/cpp/helloworld/cmake/build
ls
./greeter_client


如果到这一步没有出现问题的话&＃xff0c;就说明安装成功了。

protobuf有自己的编译器 protoc&＃xff0c;可以将 .proto 编译成.cc文件&＃xff0c;使之成为一个可以在 C&＃43;&＃43; 工程中直接使用的类。

1、linux环境

使用protoc命令&＃xff0c;由proto文件生成.pb.{h,cc}和.grpc.pb.{h,cc}。
.pb.h&＃xff1a;声明生成的消息类的头文件
.pb.cc&＃xff1a;包含消息类的实现
.grpc.pb.h&＃xff1a;声明生成的服务类的头文件
.grpc.pb.cc&＃xff1a;包含服务类的实现

在grpc/examples/cpp目录下新建文件夹&＃xff0c;例如service_error&＃xff0c;将service_Error.proto放入该新建文件夹中&＃xff0c;在该文件夹目录下输入命令&＃xff1a;

protoc --proto_path&＃61;. --cpp_out&＃61;. ./service_Error.proto


protoc&＃xff1a;解析proto文件并根据给定的选项生成输出&＃xff0c;其命令格式是protoc [OPTION] PROTO_FILES&＃xff0c;最后一项是待编译的proto文件的位置
–proto_path&＃xff1a;指定要在其中搜索导入(import)的目录&＃xff0c;可指定多次&＃xff0c;目录将按顺序搜索&＃xff0c;若没有指定&＃xff0c;则使用当前工作目录。如果proto文件里面import相应文件&＃xff0c;会去指定目录搜索相应的文件。&＃xff08;本次该选项可以不指定&＃xff09;
–cpp_out&＃xff1a;指定.pb.cc和.pb.h文件的输出目录

查看grpc_cpp_plugin的所在路径&＃xff0c;grpc_cpp_plugin是grpc的protoc插件。whereis命令用于查找文件。

whereis grpc_cpp_plugin


输入命令&＃xff1a;
protoc --proto_path&＃61;./ --grpc_out&＃61;./ --plugin&＃61;protoc-gen-grpc&＃61;/usr/bin/grpc_cpp_plugin service_Error.proto
#--grpc_out&＃xff1a;指定.grpc.pb.cc和.grpc.pb.h文件的输出目录
#--plugin&＃xff1a;指定要使用的插件可执行文件。可执行文件的形式是名称&＃61;路径&＃xff0c;在这种情况下给定的插件名称映射到给定的可执行文件。


2、windows环境

新建文件夹放入proto文件&＃xff0c;例如service_Error.proto文件。在该文件夹下新建文档&＃xff0c;修改后缀为bat。在该文件夹中新建文件夹&＃xff0c;名称为gen-cpp&＃xff0c;用于存放grpc输出文件。
可以通过以下方式显示后缀便于修改&＃xff1a;

查找protoc.exe文件的路径
查找grpc_cpp_plugin.exe文件路径


选中bat文件&＃xff0c;右键“编辑”&＃xff0c;输入命令&＃xff0c;例如proto.exe路径为&＃xff1a;
E:\workspace\ui\thirdparty\bin\protoc.exe
则输入命令&＃xff08;注意修改为自己相应文件所在路径&＃xff09;&＃xff1a;
E:\workspace\ui\thirdparty\bin\protoc.exe -I&＃61;./ --cpp_out&＃61;./gen-cpp ./service_Error.proto
E:\workspace\ui\thirdparty\bin\protoc.exe -I&＃61;./ --grpc_out&＃61;./gen-cpp --plugin&＃61;protoc-gen-grpc&＃61;"E:\workspace\ui\thirdparty\bin\grpc_cpp_plugin.exe" ./service_Error.proto
pause


第一条命令中-I和-cpp_out选项与linux中protoc命令的选项–proto_path和-cpp_out作用相同。
第二条命令中–grpc_out和–plugin选项与linux中–grpc_out和–plugin选项作用相同。
pause 暂停CMD窗口操作

保存后&＃xff0c;选中bat文件&＃xff0c;右键“以管理员身份运行”&＃xff0c;打开gen-cpp文件夹&＃xff0c;已生成.pb.{h,cc}和.grpc.pb.{h,cc}文件

以上就是安装GRPC和PROTOC以及编译proto文件的整个过程。