Mark D. Roth
70c0b32c0f
Change C++ API to expose wait_for_ready instead of fail_fast. |
8 years ago | |
---|---|---|
.. | ||
client | Merge remote-tracking branch 'upstream/master' into fail_fast | 8 years ago |
codegen | Should not explicitly initialize these pointers to nullptr in gcc-4.4 case | 9 years ago |
common | Fix header. | 8 years ago |
ext | PHP Proto3: upgrade protobuf to v3.1.0 and regenerate reflection.proto | 8 years ago |
server | Merge pull request #7833 from sreecha/fix_channel_from_fd_api | 8 years ago |
util | Merge branch 'v1.0.x' of https://github.com/grpc/grpc into manual-upmerge | 8 years ago |
README.md | Updated git clone URL | 9 years ago |
README.md
#Overview
This directory contains source code for C++ implementation of gRPC.
#Status
Beta
#Pre-requisites
##Linux
$ [sudo] apt-get install build-essential autoconf libtool
##Mac OSX
For a Mac system, git is not available by default. You will first need to install Xcode from the Mac AppStore and then run the following command from a terminal:
$ [sudo] xcode-select --install
##Protoc
By default gRPC uses protocol buffers,
you will need the protoc
compiler to generate stub server and client code.
If you compile gRPC from source, as described below, this also installs the
protoc
compiler.
If it hasn't been installed, you can run the following commands to install it.
$ cd grpc/third_party/protobuf
$ sudo make install # 'make' should have been run by core grpc
Alternatively, you can download protoc
binaries from
the protocol buffers Github repository.
#Installation
Currently to install gRPC for C++, you need to build from source as described below.
#Build from Source
$ git clone -b $(curl -L http://grpc.io/release) https://github.com/grpc/grpc
$ cd grpc
$ git submodule update --init
$ make
$ [sudo] make install
#Documentation
You can find out how to build and run our simplest gRPC C++ example in our C++ quick start.
For more detailed documentation on using gRPC in C++ , see our main documentation site at grpc.io, specifically:
- Overview: An introduction to gRPC with a simple Hello World example in all our supported languages, including C++.
- gRPC Basics - C++: A tutorial that steps you through creating a simple gRPC C++ example application.
- Asynchronous Basics - C++: A tutorial that shows you how to use gRPC C++'s asynchronous/non-blocking APIs.
Examples
Code examples for gRPC C++ live in this repository's examples/cpp directory.