grpc-experiments/csharp
Stanley Cheung f8401a757c PHP hello world example first draft 2015-06-03 15:19:33 -07:00
..
.nuget PHP hello world example first draft 2015-06-03 15:19:33 -07:00
Greeter PHP hello world example first draft 2015-06-03 15:19:33 -07:00
GreeterClient PHP hello world example first draft 2015-06-03 15:19:33 -07:00
GreeterServer PHP hello world example first draft 2015-06-03 15:19:33 -07:00
route_guide PHP hello world example first draft 2015-06-03 15:19:33 -07:00
.gitignore C# Greeter example 2015-05-15 16:04:15 -07:00
Greeter.sln PHP hello world example first draft 2015-06-03 15:19:33 -07:00
README.md update C# readme 2015-05-21 17:56:08 -07:00

README.md

gRPC in 3 minutes (C#)

BACKGROUND

For this sample, we've already generated the server and client stubs from helloworld.proto. Example projects depend on NuGet packages Grpc and Google.ProtocolBuffers which have been already added to the project for you.

PREREQUISITES

Windows

  • .NET 4.5+
  • VS 2013 (with NuGet plugin installed)

Linux (Mono)

  • Mono
  • Monodevelop 5.9 with NuGet Add-in installed (older versions might work)

MacOS (Mono)

  • Xamarin Studio (with NuGet plugin installed)

BUILD

Windows

  • Clone this repository.

  • Open solution Greeter.sln with Visual Studio

  • Build the solution (this will automatically download NuGet dependencies)

Linux (Mono)

  • Clone this repository.

  • Install gRPC C Core using instructions in https://github.com/grpc/homebrew-grpc

  • gRPC C# depends on native shared library libgrpc_csharp_ext.so. To make it visible to Mono runtime, follow instructions in Using gRPC C# on Linux

  • Open solution Greeter.sln in MonoDevelop (you need to manually restore dependencies by using mono nuget.exe restore if you don't have NuGet add-in)

  • Build the solution.

MacOS (Mono)

Try it!

  • Run the server

    > cd GreeterServer/bin/Debug
    > GreeterServer.exe
    
  • Run the client

    > cd GreeterClient/bin/Debug
    > GreeterClient.exe
    

You can also run the server and client directly from Visual Studio.

On Linux or Mac, use mono GreeterServer.exe and mono GreeterClient.exe to run the server and client.

Tutorial

You can find a more detailed tutorial in gRPC Basics: C#