VS2015编译grpc

一、grpc概述

 GRPC是google开源的一个高性能、跨语言的RPC框架&＃xff0c;基于HTTP2协议&＃xff0c;基于protobuf 3.x&＃xff0c;基于Netty 4.x &＃43;。GRPC与thrift、avro-rpc等其实在总体原理上并没有太大的区别&＃xff0c;简而言之GRPC并没有太多突破性的创新。

对于开发者而言&＃xff1a;

    1&＃xff09;需要使用protobuf定义接口&＃xff0c;即.proto文件

    2&＃xff09;然后使用compile工具生成特定语言的执行代码&＃xff0c;比如JAVA、C/C&＃43;&＃43;、Python等。类似于thrift&＃xff0c;为了解决跨语言问题。

    3&＃xff09;启动一个Server端&＃xff0c;server端通过侦听指定的port&＃xff0c;来等待Client链接请求&＃xff0c;通常使用Netty来构建&＃xff0c;GRPC内置了Netty的支持。

    4&＃xff09;启动一个或者多个Client端&＃xff0c;Client也是基于Netty&＃xff0c;Client通过与Server建立TCP长链接&＃xff0c;并发送请求&＃xff1b;Request与Response均被封装成HTTP2的stream Frame&＃xff0c;通过Netty Channel进行交互。

二、编译

      1、所需工具&＃xff1a;操作系统&＃xff1a;Win7 64位 、Visual Studio 2015 、CMake

      2、编译步骤&＃xff1a;

1、下载

1.1 在 https://github.com/grpc/grpc/tree/v1.0.1 上下载 grpc-1.0.1.zip 文件(下载路径&＃xff1a;https://github.com/grpc/grpc/archive/v1.0.1.zip)文件&＃xff0c;将文件解压到 grpc-1.0.1。 
1.2 切换到 third_party 目录&＃xff0c;分别下载依赖的其它项目&＃xff0c;下达完成之后将依赖项分别解压到 third_party 下的对应目录下。 
如 在2017.01.17日&＃xff0c;tag v1.0.1 对应的依赖项链接如下&＃xff1a; 
https://codeload.github.com/grpc/grpc/zip/v1.0.1 
https://codeload.github.com/google/boringssl/zip/c880e42ba1c8032d4cdde2aba0541d8a9d9fa2e9 
https://codeload.github.com/gflags/gflags/zip/05b155ff59114735ec8cd089f669c4c3d8f59029 
https://codeload.github.com/google/googletest/zip/c99458533a9b4c743ed51537e25989ea55944908 
https://codeload.github.com/google/protobuf/zip/1a586735085e817b1f52e53feec92ce418049f69 
https://codeload.github.com/madler/zlib/zip/50893291621658f355bc5b4d450a8d06a563053d

2、编译protobuf

参考readme用CMAKE生成工程文件&＃xff0c;编译即可。

2.1、下载protobuf依赖项gmock和gtest 
下载gmock(https://github.com/google/googlemock/archive/release-1.7.0.zip)和gtest(https://github.com/google/googletest/archive/release-1.7.0.zip)&＃xff0c;分别解压到grpc-1.0.1\third_party\protobuf\gmock 和 grpc-1.0.1\third_party\protobuf\gmock\gtest\ 目录下。 
2.2、使用CMake编译protobuf 
首先打开vs2015开发人员命令提示符窗口(使用 "VS2015 x86 本机工具命令提示符" 工具)&＃xff0c;切换到对应的protobuf目录。

1. cd grpc-1.0.1\third_party\protobuf\cmake
2. mkdir build & cd build & mkdir install
3. mkdir debug & cd debug
4. cmake -G "NMake Makefiles" -DCMAKE_BUILD_TYPE&＃61;Debug -DCMAKE_INSTALL_PREFIX&＃61;../install ../..
5. nmake && nmake install

生成完成&＃xff0c;在grpc-1.0.1\third_party\protobuf\cmake\build\install\lib 目录下面有对应的Lib文件。在cmake目录下面mkdir debug&＃xff0c;然后把install/lib目录下的所有库文件拷贝的debug路径&＃xff0c;并把后缀d去掉。例如protobuf生成的库名称为libprotocd.lib&＃xff0c;应该改名成libprotoc.lib。其他的依次类推。后面编译grpc会用到这些库。

3、编译grpc&＃xff0c;grpc_protoc_plugin

在vsprojects里有建好的工程文件&＃xff0c;下载nuget.exe&＃xff0c;用于依赖包的网络下载。主要是依赖于openssl和zlib库。在编译grpc时&＃xff0c;出现编译boringssl&＃xff0c;出现很多错误&＃xff0c;可以把工程移除可以直接在 grpc.sln 文件中删除 boringssl 工程。

3.1、下载nuget 
下载nuget.exe (路径&＃xff1a;https://nuget.org/nuget.exe )&＃xff0c;并将期复制到 grpc-1.0.1\vsprojects\ 目录下。 
3.2、使用nuget下载依赖包

1. cd grpc-1.0.1\vsprojects
2. nuget restore grpc.sln

3.3、编译grpc 
打开 grpc-1.0.1\vsprojects\grpc.sln 文件&＃xff0c;删除boringssl工程&＃xff0c;否则后面编译grpc时会报错。若不使用ssl&＃xff0c;boringssl可以不编译。

1. msbuild grpc.sln /p:Configuration&＃61;Debug

grpc-1.0.1\vsprojects\Debug\ 目录下会生成grpc相关文件。

3.3、编译grpc_cpp_plugin

1. msbuild grpc_protoc_plugins.sln /p:Configuration&＃61;Debug

grpc-1.0.1\vsprojects\Debug\ 目录下会生成grpc_cpp_plugin相关文件。

4、编译zlib

参考readme&＃xff0c;使用cmake编译。

1. cd grpc-1.0.1\third_party\zlib\
2. cmake CMakeLists.txt

再用 vs2015 打开 zlib.sln编译即可&＃xff0c;文件生成在 Debug 目录。

三、编写测试例子   

1、根据helloworld.proto生成.h和.cc文件

将proto.exe、helloworld.proto、grpc_cpp_plugin.exe拷贝到一个文件夹中&＃xff0c;grpc_cpp_plugin.exe是gRPC的protoc插件&＃xff0c;生成方法参考我的《编译gRPC》一文。

创建一个bat文件&＃xff0c;包含以下命令&＃xff1a;

protoc.exe -I&＃61;. --grpc_out&＃61;. --plugin&＃61;protoc-gen-grpc&＃61;.\grpc_cpp_plugin.exe helloworld.proto
protoc.exe -I&＃61;. --cpp_out&＃61;. helloworld.proto

生成了两套文件

hellowworld.pb.h
hellowworld.pb.cc
hellowworld.grpc.pb.h
hellowworld.grpc.pb.cc

其中前两个是protoc生成的&＃xff0c;后两个是插件生成的。

2、创建grpc_helloworld工程

在vsprojects目录创建空的WIN32 C&＃43;&＃43;工程grpc_helloworld.sln&＃xff0c;在目录grpc_helloworld下面有两个文件夹。目录结构如下图&＃xff1a;

grpc-1.0.1\vsprojects\grpc_helloworld.sln 
grpc-1.0.1\vsprojects\grpc_helloworld\grpc_helloworld.vcxproj 
grpc-1.0.1\vsprojects\grpc_helloworld\grpc_helloworld.vcxproj.filters 
grpc-1.0.1\vsprojects\grpc_helloworld\protobuf\helloworld.pb.h 
grpc-1.0.1\vsprojects\grpc_helloworld\protobuf\helloworld.pb.cc 
grpc-1.0.1\vsprojects\grpc_helloworld\protobuf\helloworld.grpc.pb.h 
grpc-1.0.1\vsprojects\grpc_helloworld\protobuf\helloworld.grpc.pb.cc 
grpc-1.0.1\vsprojects\grpc_helloworld\client\greeter_client.cc3

3、设置头文件

D:\XXXX\grpc\include;
D:\XXXX\grpc\third_party\protobuf\src;
$(ProjectDir)..\proto

三个头文件目录&＃xff0c;一个是gRPC的头文件&＃xff0c;一个是protobuf的头文件&＃xff0c;一个是刚生成的的访问类路径。

路径

D:\XXXX\grpc\third_party\protobuf\cmake\Release;
D:\XXXX\grpc\vsprojects\Release;
D:\XXXX\grpc\third_party\zlib\solution\Release;
D:\XXXX\grpc\vsprojects\packages\grpc.dependencies.openssl.1.0.204.1\build\native\lib\v120\Win32\Release\static

四个库文件路径&＃xff1a;protobuf库路径、grpc库路径、zlib库路径、openssl库路径。
没有使用boringssl&＃xff0c;openssl的库是从NuGet下载的package中找到的。

库文件

libprotobuf.lib;
grpc.lib;
gpr.lib;
grpc&＃43;&＃43;.lib;
Ws2_32.lib;
libeay32.lib;
ssleay32.lib;
zlibstatic.lib;
%(AdditionalDependencies) 5、编译

      如果出错&＃xff0c;则在工程里做如下设置&＃xff1a;

预处理器设定&＃xff1a; 
_DEBUG;_WIN32_WINNT&＃61;0x600;_SCL_SECURE_NO_WARNINGS;_CRT_SECURE_NO_WARNINGS;%(PreprocessorDefinitions)

代码生成–>运行库 设置为 "多线程调试 (/MTd)"。顺利的话就可以生成对应的exe了。