commit | fe6a8aede4546794e552a9157bcf7c7f109138e0 | [log] [tgz] |
---|---|---|
author | Mugur Marculescu <mugurm@gmail.com> | Fri Feb 06 13:52:37 2015 -0800 |
committer | Mugur Marculescu <mugurm@gmail.com> | Fri Feb 06 13:52:37 2015 -0800 |
tree | 5c0987a6f390be9fe4eb3239e24e3a3620c57533 | |
parent | 80b209a8bead8642dd52da19a4105b8107427a11 [diff] | |
parent | bb9e6f4e7ce17d5a06e10a487e65ed6a1473155a [diff] |
Merge pull request #9 from tbetbetbe/add_common_protos Adds the common protos along with a README.md
A great way to get introduced to gRPC is to work through this tutorial, which walks you through the construction of a simple client and server and introduces various features of gRPC.
When you finish the tutorial, you will be able to
The rest of this page explains how you can set up your local machine for development. If you just want to read the tutorial, you can go straight to the next step: Step - 0
You can follow along with this tutorial and hack on the code in the comfort of your own computer. This way you can get hands-on practice of really writing gRPC code.
The tutorial relies on the use of the Git versioning system for source code management. You don't need to know anything about Git to follow the tutorial other than how to install and run a few git commands.
You can download and install Git from http://git-scm.com/download. Once installed you should have access to the git command line tool. The main commands that you will need to use are:
Clone the grpc-helloword repository located at GitHub by running the following command:
git clone https://github.com/google/grpc-helloworld.git
Change your current directory to grpc-helloworld
cd grpc-helloworld
Java gRPC is designed to work with both Java 7 and Java 8. For simplicity, the example assumes that Java 8 is installed. See Install Java 8 for instructions.
To simplify building and the managing of gRPC's dependencies, the Java client are server are structured as a standard Maven project. See Install Maven for instructions.
Go gRPC requires Go 1.4, the latest version of Go. See Install Go for instructions.
gRPC uses the latest version of the protocol buffer compiler, protoc.
For following this tutorial, the protoc is not strictly necessary, as all the generated code is checked into the Git repository. If you want to experiment with generating the code yourself, download and install protoc from its Git repo