Yang Gao
b10d00e188
|
10 years ago | |
---|---|---|
.. | ||
helloworld | Fix makefile | 10 years ago |
route_guide | Fix Makefile for route_guide | 10 years ago |
README.md | Updating documentation. | 10 years ago |
cpptutorial.md | Updating documentation. | 10 years ago |
README.md
#gRPC in 3 minutes (C++)
Installation
To install gRPC on your system, follow the instructions here: https://github.com/grpc/grpc/blob/master/INSTALL.
Hello C++ gRPC!
Here's how to build and run the C++ implementation of the Hello World example used in Getting started.
The example code for this and our other examples lives in the grpc-common
GitHub repository. Clone this repository to your local machine by running the
following command:
$ git clone https://github.com/grpc/grpc-common.git
Change your current directory to grpc-common/cpp/helloworld
$ cd grpc-common/cpp/helloworld/
Generating gRPC code
To generate the client and server side interfaces:
$ make helloworld.grpc.pb.cc helloworld.pb.cc
Which internally invokes the proto-compiler as:
$ protoc -I ../../protos/ --grpc_out=. --plugin=protoc-gen-grpc=grpc_cpp_plugin ../../protos/helloworld.proto
$ protoc -I ../../protos/ --cpp_out=. ../../protos/helloworld.proto
Client and server implementations
The client implementation is at greeter_client.cc.
The server implementation is at greeter_server.cc.
Try it!
Build client and server:
$ make
Run the server, which will listen on port 50051:
$ ./greeter_server
Run the client (in a different terminal):
$ ./greeter_client
If things go smoothly, you will see the "Greeter received: Hello world" in the client side output.
Tutorial
You can find a more detailed tutorial in gRPC Basics: C++